@tencentcloud/sdk-mcp 1.4.7 → 1.6.0-beta.1

package/resource/{doc/livekit/core-sdk/live/ios/api-reference → knowledge/livekit/core-sdk/api-reference/ios}/AudioEffectStore.md

@@ -1,12 +1,11 @@
 ## 简介
 
-**AudioEffectStore** 提供了一套完整的音效管理 API，包括变声效果、混响效果和耳返功能。
-通过该类，主播可以在直播过程中实时调整自己的声音效果，提升直播体验。
+`AudioEffectStore` 提供了一套完整的音效管理 API，包括变声效果、混响效果和耳返功能。 通过该类，主播可以在直播过程中实时调整自己的声音效果，提升直播体验。
 
 > **重要：**
 >
 
-> 使用 **shared** 单例获取 **AudioEffectStore** 实例。设置的音效在退出房间后会自动失效，下次进房需要重新设置。
+> 使用 **shared** 单例获取 `AudioEffectStore` 实例。设置的音效在退出房间后会自动失效，下次进房需要重新设置。
 >
 
 > **说明：**
@@ -24,7 +23,7 @@
 ## 功能特性
 - **变声效果**：支持多种变声特效，如熊孩子、小女孩、大叔等。
 
-- **混响效果**：支持多种混响特效，如KTV、小房间、大会堂等。
+- **混响效果**：支持多种混响特效，如 KTV、小房间、大会堂等。
 
 - **耳返功能**：主播可在耳机中听到自己的声音，适用于唱歌场景。
 
@@ -33,22 +32,24 @@
 ## 可订阅数据
 
 **AudioEffectState** 的字段描述如下：
-| **属性名** | **类型** | **描述** |
-| --- | --- | --- |
-| audioChangerType | AudioChangerType | 变声状态。 |
-| audioReverbType | AudioReverbType | 混响状态。 |
-| isEarMonitorOpened | Bool | 耳返开启。 |
-| earMonitorVolume | Int | 耳返音量，取值范围 0 - 100。<br>如果将 volume 设置成 100 之后感觉音量还是太小，可以将 volume 最大设置成 150，但超过 100 的 volume 会有爆音的风险，请谨慎操作。 |
+
+|**属性名**|**类型**|**描述**|
+|---------|---------|---------|
+|audioChangerType|AudioChangerType|变声状态。|
+|audioReverbType|AudioReverbType|混响状态。|
+|isEarMonitorOpened|Bool|耳返开启。|
+|earMonitorVolume|Int|耳返音量，取值范围0到100。<br>如果将 volume 设置成100之后感觉音量还是太小，可以将 volume 最大设置成150，但超过100的 volume 会有爆音的风险，请谨慎操作。|
 
 ## API 列表
-| **函数名** | **描述** |
-| --- | --- |
-| shared | 获取单例实例。 |
-| setAudioChangerType | 设置变声效果。 |
-| setAudioReverbType | 设置混响效果。 |
-| setVoiceEarMonitorEnable | 开启/关闭耳返。 |
-| setVoiceEarMonitorVolume | 设置耳返音量。 |
-| reset | 重置为默认状态。 |
+
+|**函数名**|**描述**|
+|---------|---------|
+|shared|获取单例实例。|
+|setAudioChangerType|设置变声效果。|
+|setAudioReverbType|设置混响效果。|
+|setVoiceEarMonitorEnable|开启/关闭耳返。|
+|setVoiceEarMonitorVolume|设置耳返音量。|
+|reset|重置为默认状态。|
 
 ### 获取实例
 
@@ -60,7 +61,7 @@
 
 #### setAudioChangerType
 
-设置变声效果
+设置变声效果。
 ``` swift
 public func setAudioChangerType(type: AudioChangerType) {
     fatalError("\(#function) must be overridden by subclass")
@@ -73,7 +74,7 @@ public func setAudioChangerType(type: AudioChangerType) {
 
 **版本信息**
 
-从 3.5 版本开始支持。
+从3.5版本开始支持。
 
 **调用时机**
 
@@ -88,15 +89,16 @@ public func setAudioChangerType(type: AudioChangerType) {
 >
 
 **参数说明**
-| **参数名** | **类型** | **是否必填** | **描述** |
-| --- | --- | --- | --- |
-| type | AudioChangerType | 必填 | 变声效果类型。 |
+
+|**参数名**|**类型**|**描述**|
+|---------|---------|---------|
+|type|AudioChangerType|变声效果类型。|
 
 ### 混响设置
 
 #### setAudioReverbType
 
-设置混响效果
+设置混响效果。
 ``` swift
 public func setAudioReverbType(type: AudioReverbType) {
     fatalError("\(#function) must be overridden by subclass")
@@ -109,7 +111,7 @@ public func setAudioReverbType(type: AudioReverbType) {
 
 **版本信息**
 
-从 3.5 版本开始支持。
+从3.5版本开始支持。
 
 **调用时机**
 
@@ -124,15 +126,16 @@ public func setAudioReverbType(type: AudioReverbType) {
 >
 
 **参数说明**
-| **参数名** | **类型** | **是否必填** | **描述** |
-| --- | --- | --- | --- |
-| type | AudioReverbType | 必填 | 混响效果类型。 |
+
+|**参数名**|**类型**|**描述**|
+|---------|---------|---------|
+|type|AudioReverbType|混响效果类型。|
 
 ### 耳返设置
 
 #### setVoiceEarMonitorEnable
 
-开启/关闭耳返
+开启/关闭耳返。
 ``` swift
 public func setVoiceEarMonitorEnable(enable: Bool) {
     fatalError("\(#function) must be overridden by subclass")
@@ -143,7 +146,7 @@ public func setVoiceEarMonitorEnable(enable: Bool) {
 
 **版本信息**
 
-从 3.5 版本开始支持。
+从3.5版本开始支持。
 
 **适用场景**
 
@@ -162,13 +165,14 @@ public func setVoiceEarMonitorEnable(enable: Bool) {
 >
 
 **参数说明**
-| **参数名** | **类型** | **是否必填** | **描述** |
-| --- | --- | --- | --- |
-| enable | Bool | 必填 | 是否开启耳返。 |
+
+|**参数名**|**类型**|**描述**|
+|---------|---------|---------|
+|enable|Bool|是否开启耳返。|
 
 #### setVoiceEarMonitorVolume
 
-设置耳返音量
+设置耳返音量。
 ``` swift
 public func setVoiceEarMonitorVolume(volume: Int) {
     fatalError("\(#function) must be overridden by subclass")
@@ -179,7 +183,7 @@ public func setVoiceEarMonitorVolume(volume: Int) {
 
 **版本信息**
 
-从 3.5 版本开始支持。
+从3.5版本开始支持。
 
 **调用时机**
 
@@ -190,19 +194,20 @@ public func setVoiceEarMonitorVolume(volume: Int) {
 > **说明：**
 >
 
-> 如果将 volume 设置成 100 之后感觉音量还是太小，可以将 volume 最大设置成 150，但超过 100 的 volume 会有爆音的风险，请谨慎操作。
+> 如果将 volume 设置成100之后感觉音量还是太小，可以将 volume 最大设置成150，但超过100的 volume 会有爆音的风险，请谨慎操作。
 >
 
 **参数说明**
-| **参数名** | **类型** | **是否必填** | **描述** |
-| --- | --- | --- | --- |
-| volume | Int | 必填 | 耳返音量。（取值范围：0 - 100（超过 100 可能导致爆音））（默认值：100）。 |
+
+|**参数名**|**类型**|**描述**|
+|---------|---------|---------|
+|volume|Int|耳返音量。（取值范围：取值范围0到100，超过100可能导致爆音）（默认值：100）。|
 
 ### 重置
 
 #### reset
 
-重置为默认状态
+重置为默认状态。
 ``` swift
 public func reset() {
     fatalError("\(#function) must be overridden by subclass")
@@ -213,7 +218,7 @@ public func reset() {
 
 **版本信息**
 
-从 3.5 版本开始支持。
+从3.5版本开始支持。
 
 **调用时机**
 
@@ -224,63 +229,62 @@ public func reset() {
 ### AudioChangerType
 
 变声效果类型。
-| **枚举值** | **值** | **说明** |
-| --- | --- | --- |
-| none | 0 | 关闭特效。 |
-| child | 1 | 熊孩子。 |
-| littleGirl | 2 | 小女孩。 |
-| man | 3 | 大叔。 |
-| heavyMetal | 4 | 重金属。 |
-| cold | 5 | 感冒。 |
-| foreigner | 6 | 外语腔。 |
-| trappedBeast | 7 | 困兽。 |
-| fatso | 8 | 肥宅。 |
-| strongCurrent | 9 | 强电流。 |
-| heavyMachinery | 10 | 重机械。 |
-| ethereal | 11 | 空灵。 |
+
+|**枚举值**|**值**|**说明**|
+|---------|---------|---------|
+|none|0|关闭特效。|
+|child|1|熊孩子。|
+|littleGirl|2|小女孩。|
+|man|3|大叔。|
+|heavyMetal|4|重金属。|
+|cold|5|感冒。|
+|foreigner|6|外语腔。|
+|trappedBeast|7|困兽。|
+|fatso|8|肥宅。|
+|strongCurrent|9|强电流。|
+|heavyMachinery|10|重机械。|
+|ethereal|11|空灵。|
 
 ### AudioReverbType
 
 混响效果类型。
-| **枚举值** | **值** | **说明** |
-| --- | --- | --- |
-| none | 0 | 关闭特效。 |
-| ktv | 1 | KTV。 |
-| smallRoom | 2 | 小房间。 |
-| auditorium | 3 | 大会堂。 |
-| deep | 4 | 低沉。 |
-| loud | 5 | 洪亮。 |
-| metallic | 6 | 金属声。 |
-| magnetic | 7 | 磁性。 |
+
+|**枚举值**|**值**|**说明**|
+|---------|---------|---------|
+|none|0|关闭特效。|
+|ktv|1|KTV。|
+|smallRoom|2|小房间。|
+|auditorium|3|大会堂。|
+|deep|4|低沉。|
+|loud|5|洪亮。|
+|metallic|6|金属声。|
+|magnetic|7|磁性。|
 
 ### AudioEffectState
 
 AudioEffectStore 对外提供的音效相关状态数据。
-| **属性** | **类型** | **说明** |
-| --- | --- | --- |
-| audioChangerType | AudioChangerType | 变声状态。 |
-| audioReverbType | AudioReverbType | 混响状态。 |
-| isEarMonitorOpened | Bool | 耳返开启。 |
-| earMonitorVolume | Int | 耳返音量，取值范围 0 - 100。<br>如果将 volume 设置成 100 之后感觉音量还是太小，可以将 volume 最大设置成 150，但超过 100 的 volume 会有爆音的风险，请谨慎操作。 |
+
+|**属性**|**类型**|**说明**|
+|---------|---------|---------|
+|audioChangerType|AudioChangerType|变声状态。|
+|audioReverbType|AudioReverbType|混响状态。|
+|isEarMonitorOpened|Bool|耳返开启。|
+|earMonitorVolume|Int|耳返音量，取值范围0到100。<br>如果将 volume 设置成100之后感觉音量还是太小，可以将 volume 最大设置成150，但超过100的 volume 会有爆音的风险，请谨慎操作。|
 
 ## 使用示例
 ``` swift
 // 获取单例实例
 let store = AudioEffectStore.shared
-
 // 订阅状态变化
 store.state.subscribe { state in
     print("当前变声效果: \(state.audioChangerType)")
     print("当前混响效果: \(state.audioReverbType)")
     print("耳返开启: \(state.isEarMonitorOpened)")
 }
-
 // 设置变声效果
 store.setAudioChangerType(type: .littleGirl)
-
 // 设置混响效果
 store.setAudioReverbType(type: .ktv)
-
 // 开启耳返
 store.setVoiceEarMonitorEnable(enable: true)
 store.setVoiceEarMonitorVolume(volume: 80)

package/resource/knowledge/livekit/core-sdk/api-reference/ios/BarrageStore.md

@@ -0,0 +1,192 @@
+## 简介
+
+`BarrageStore` 提供了一套完整的弹幕管理 API，包括发送文本弹幕、发送自定义消息和添加本地提示消息。 通过该类，可以在直播间内实现弹幕互动功能。
+
+> **重要：**
+>
+
+> 使用 **create(liveID:)** 工厂方法创建 `BarrageStore` 实例，需要传入有效的直播间 ID。
+>
+
+> **说明：**
+>
+
+> 弹幕状态更新通过 **state** 发布者传递。订阅它以接收房间内弹幕数据的实时更新。
+>
+
+## 功能特性
+- **文本弹幕**：支持发送纯文本弹幕消息。
+
+- **自定义消息**：支持发送自定义格式的弹幕消息（可用于房间公告，服务侧弹幕消息通知等）。
+
+- **本地提示**：支持添加仅本地可见的提示消息。
+
+## 可订阅数据
+
+**BarrageState** 的字段描述如下：
+
+|**属性名**|**类型**|**描述**|
+|---------|---------|---------|
+|messageList|[Barrage]|当前房间的弹幕消息列表，支持实时更新并可被订阅监听。|
+
+## API 列表
+
+|**函数名**|**描述**|
+|---------|---------|
+|create|创建弹幕管理实例。|
+|CustomMessageEventPublisher|自定义消息事件发布者。|
+|sendTextMessage|发送文本弹幕。|
+|sendCustomMessage|发送自定义消息。|
+|appendLocalTip|添加本地提示消息。|
+
+### 创建实例
+
+#### create
+
+弹幕管理核心类，用于处理直播间/语音聊天房内的弹幕相关业务逻辑。
+``` swift
+public static func create(liveID: String) -> BarrageStore {
+    let store: BarrageStoreImpl = StoreFactory.shared.getStore(roomID: liveID)
+    return store
+}
+```
+
+**版本信息**
+
+从3.5版本开始支持。
+
+**参数说明**
+
+|**参数名**|**类型**|**描述**|
+|---------|---------|---------|
+|liveID|String|直播间 ID。|
+
+### 观察事件
+
+#### CustomMessageEventPublisher
+
+自定义消息事件发布者。
+
+自定义消息事件发布者。订阅以接收一次性自定义消息事件。
+
+**数据结构：**CustomMessageEvent
+
+### 发送弹幕
+
+#### sendTextMessage
+
+发送文本类型弹幕，当发送成功之后，接收端可通过提前订阅 BarrageState 中的 messageList 来获取弹幕消息。
+``` swift
+public func sendTextMessage(text: String,
+                            extensionInfo: [String: String]?,
+                            completion: CompletionClosure?) {
+    fatalError("\(#function) must be overridden by subclass")
+}
+```
+
+**版本信息**
+
+从3.5版本开始支持。
+
+**参数说明**
+
+|**参数名**|**类型**|**描述**|
+|---------|---------|---------|
+|text|String|文本弹幕内容。|
+|extensionInfo|[String:String]?|扩展信息，可包含自定义字段（如指定弹幕颜色、字体大小等）。|
+|completion|CompletionClosure?|完成回调（成功/失败状态）。|
+
+#### sendCustomMessage
+
+发送自定义类型弹幕消息，当发送成功之后，接收端可通过订阅 BarrageStore 提供的 CustomMessageEventPublisher 来订阅自定义消息。
+``` swift
+public func sendCustomMessage(businessID: String,
+                              data: String,
+                              completion: CompletionClosure?) {
+    fatalError("\(#function) must be overridden by subclass")
+}
+```
+
+**版本信息**
+
+从3.5版本开始支持。
+
+**参数说明**
+
+|**参数名**|**类型**|**描述**|
+|---------|---------|---------|
+|businessID|String|业务标识 ID，用于区分不同业务场景的自定义消息。|
+|data|String|自定义数据内容，通常为 JSON 格式字符串，用于传递业务自定义的数据。|
+|completion|CompletionClosure?|完成回调（成功/失败状态）。|
+
+### 本地消息
+
+#### appendLocalTip
+
+添加本地提示消息（在本地添加提示或操作反馈消息，仅当前客户端可见）。
+``` swift
+public func appendLocalTip(message: Barrage) {
+    fatalError("\(#function) must be overridden by subclass")
+}
+```
+
+**版本信息**
+
+从3.5版本开始支持。
+
+**注意事项**
+
+> **说明：**
+>
+
+> 该消息仅在本地显示，不会通过网络发送给其他用户。
+>
+
+**参数说明**
+
+|**参数名**|**类型**|**描述**|
+|---------|---------|---------|
+|message|Barrage|本地弹幕消息（如系统提示、操作反馈等，仅当前用户可见）。|
+
+## 数据结构
+
+### BarrageType
+
+弹幕类型枚举，用于区分不同的弹幕消息种类。
+
+|**枚举值**|**值**|**说明**|
+|---------|---------|---------|
+|text|0|文本类型弹幕，包含纯文字内容。|
+|custom|1|自定义类型弹幕，支持业务自定义数据格式（如带特效的弹幕、互动消息等）。|
+
+### Barrage
+
+弹幕数据模型，包含单条弹幕的完整属性信息。
+
+|**属性**|**类型**|**说明**|
+|---------|---------|---------|
+|liveID|String|弹幕所属直播间/语音聊天房的唯一标识 ID。|
+|sender|LiveUserInfo|弹幕发送者的用户信息（如用户 ID、昵称、头像等）。|
+|sequence|Int|弹幕消息的唯一序列 ID，用于消息排序和去重。|
+|timestampInSecond|TimeInterval|弹幕发送时间戳（单位：秒），用于展示发送时间顺序。|
+|messageType|BarrageType|弹幕消息类型（文本或自定义）。|
+|textContent|String|文本类型弹幕的消息内容，即弹幕的文本内容。|
+|extensionInfo|[String:String]?|弹幕扩展信息，可自定义字段（如显示样式、优先级等）。当 messageType 为 TEXT 时有效。|
+|businessID|String|自定义类型弹幕的业务标识 ID，用于区分不同业务场景的自定义消息。|
+|data|String|自定义类型弹幕的具体数据内容（通常为 JSON 格式字符串），当 messageType 为 CUSTOM 时有效。|
+
+### BarrageState
+
+弹幕状态，管理当前房间的弹幕数据状态。
+
+|**属性**|**类型**|**说明**|
+|---------|---------|---------|
+|messageList|[Barrage]|当前房间的弹幕消息列表，支持实时更新并可被订阅监听。|
+
+### CustomMessageEvent
+
+自定义消息事件，表示弹幕系统中自定义消息相关的一次性事件。
+
+|**枚举值**|**参数**|**参数类型**|**说明**|
+|---------|---------|---------|---------|
+|customMessageReceived|barrage|Barrage|房间内收到自定义弹幕消息时触发的事件。|

package/resource/knowledge/livekit/core-sdk/api-reference/ios/BaseBeautyStore.md

@@ -0,0 +1,146 @@
+## 简介
+
+基础美颜功能通过简单易用的 API 实现实时美颜效果调节。`BaseBeautyStore` 提供了一套完整的接口来管理美颜效果的设置和状态订阅。
+
+> **说明：**
+>
+
+> 美颜状态更新通过 **state** 发布者传递。订阅它以接收有关美颜效果级别的实时更新。
+>
+
+## 功能特性
+- **磨皮效果**：支持0 - 9级别的磨皮效果调节。
+
+- **美白效果**：支持0 - 9级别的美白效果调节。
+
+- **红润效果**：支持0 - 9级别的红润效果调节。
+
+- **状态订阅**：实时订阅美颜状态变化，同步 UI 显示与实际效果。
+
+## 可订阅数据
+
+**BaseBeautyState** 的字段描述如下：
+
+|**属性名**|**类型**|**描述**|
+|---------|---------|---------|
+|smoothLevel|Float|磨皮级别，取值范围0到9；0表示关闭，9表示效果最明显。|
+|whitenessLevel|Float|美白级别，取值范围0到9；0表示关闭，9表示效果最明显。|
+|ruddyLevel|Float|红润级别，取值范围0到9；0表示关闭，9表示效果最明显。|
+
+## API 列表
+
+|**函数名**|**描述**|
+|---------|---------|
+|shared|获取单例实例。|
+|setSmoothLevel|设置磨皮级别。|
+|setWhitenessLevel|设置美白级别。|
+|setRuddyLevel|设置红润级别。|
+|reset|重置为默认状态。|
+
+### 获取实例
+
+#### shared
+
+获取单例实例。
+
+### 美颜调节
+
+#### setSmoothLevel
+
+设置磨皮级别。
+``` swift
+public func setSmoothLevel(smoothLevel: Float) {
+    fatalError("\(#function) must be overridden by subclass")
+}
+```
+
+**版本信息**
+
+从3.5版本开始支持。
+
+**参数说明**
+
+|**参数名**|**类型**|**描述**|
+|---------|---------|---------|
+|smoothLevel|Float|磨皮级别，取值范围0到9；0表示关闭，9表示效果最明显。|
+
+#### setWhitenessLevel
+
+设置美白级别。
+``` swift
+public func setWhitenessLevel(whitenessLevel: Float) {
+    fatalError("\(#function) must be overridden by subclass")
+}
+```
+
+**版本信息**
+
+从3.5版本开始支持。
+
+**参数说明**
+
+|**参数名**|**类型**|**描述**|
+|---------|---------|---------|
+|whitenessLevel|Float|美白级别，取值范围0到9；0表示关闭，9表示效果最明显。|
+
+#### setRuddyLevel
+
+设置红润级别。
+``` swift
+public func setRuddyLevel(ruddyLevel: Float) {
+    fatalError("\(#function) must be overridden by subclass")
+}
+```
+
+**版本信息**
+
+从3.5版本开始支持。
+
+**参数说明**
+
+|**参数名**|**类型**|**描述**|
+|---------|---------|---------|
+|ruddyLevel|Float|红润级别，取值范围0到9；0表示关闭，9表示效果最明显。|
+
+#### reset
+
+将所有美颜参数（磨皮、美白、红润）重置为默认关闭状态（值为0）。
+``` swift
+public func reset() {
+    fatalError("\(#function) must be overridden by subclass")
+}
+```
+
+**版本信息**
+
+从3.5版本开始支持。
+
+## 数据结构
+
+### BaseBeautyState
+
+基础美颜状态，管理磨皮、美白、红润等美颜效果的级别数据。支持订阅以同步 UI 显示与实际效果。
+
+|**属性**|**类型**|**说明**|
+|---------|---------|---------|
+|smoothLevel|Float|磨皮级别，取值范围0到9；0表示关闭，9表示效果最明显。|
+|whitenessLevel|Float|美白级别，取值范围0到9；0表示关闭，9表示效果最明显。|
+|ruddyLevel|Float|红润级别，取值范围0到9；0表示关闭，9表示效果最明显。|
+
+## 使用示例
+``` swift
+// 获取单例实例
+let store = BaseBeautyStore.shared
+// 订阅状态变化
+store.state.subscribe { state in
+    print("磨皮级别: \(state.smoothLevel)")
+    print("美白级别: \(state.whitenessLevel)")
+    print("红润级别: \(state.ruddyLevel)")
+}
+// 设置美颜效果
+store.setSmoothLevel(smoothLevel: 5)
+store.setWhitenessLevel(whitenessLevel: 3)
+store.setRuddyLevel(ruddyLevel: 2)
+// 重置所有美颜效果
+store.reset()
+```