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

package/resource/{doc → knowledge}/livekit/core-sdk/voice/uni-app/voice-audio-effect.md

@@ -1,4 +1,4 @@
-本篇文档旨在指导您如何使用 `AtomicXCore` 框架中的  `AudioEffectState` 和 `DeviceState` 模块，为您的直播应用快速集成音效控制功能，包括麦克风音量、耳返监听，并添加多种趣味变声效果和混响效果。
+本篇文档旨在指导您如何使用 `AtomicXCore` 框架中的 `AudioEffectState` 和 `DeviceState` 模块，为您的直播应用快速集成音效控制功能，包括麦克风音量、耳返监听，并添加多种趣味变声效果和混响效果。
 
 ## 核心功能
 
@@ -15,18 +15,15 @@
 
 ### 步骤1：组件集成
 
-请参考 快速接入 集成 **AtomicXCore。**
+请参考 开播与收听 集成 **AtomicXCore。**
 
 ### 步骤2：获取 State 实例
 
-`AudioEffectState` 和 `DeviceState`是单例对象，您可以在项目的任何位置获取实例。
+`AudioEffectState` 和 `DeviceState` 是单例对象，您可以在项目的任何位置获取实例。
 ``` typescript
 import { useAudioEffectState } from '@/uni_modules/tuikit-atomic-x/state/AudioEffectState'
 import { useDeviceState } from "@/uni_modules/tuikit-atomic-x/state/DeviceState";
 
-// liveID 是语聊房的唯一标识
-const liveID = 'your_live_id'; // 替换为实际的语聊房 liveID
-
 // 通过 liveID 获取对应实例
 useAudioEffectState(liveID)
 useDeviceState(liveID)
@@ -45,7 +42,7 @@ useDeviceState(liveID)
 #### 实现方式:
 1. **开关耳返**：您可以在 `UI` 上自行实现开关耳返功能。
 
-2. **设置耳返音量值**：您可以自行实现左右拖动滑块来调节音量的功能，并将您 `UI` 上的值映射成音量值，调用 `setVoiceEarMonitorVolume(volume:)。`请注意，该接口接收的参数范围是 `[0, 150]`，所以您需要将 UI 控件的值映射到 `0 - 150` 的范围。
+2. **设置耳返音量值**：您可以自行实现左右拖动滑块来调节音量的功能，并将您 `UI` 上的值映射成音量值，调用 `setOutputVolume(volume:)`。请注意，该接口接收的参数范围是 `[0, 150]`所以您需要将 UI 控件的值映射到 `0 - 150` 的范围。
 
 3. **监听状态更新 UI**：您可以订阅实时的耳返状态值更新 UI。
 
@@ -54,21 +51,18 @@ useDeviceState(liveID)
 import { watch } from 'vue'
 import { useAudioEffectState } from '@/uni_modules/tuikit-atomic-x/state/AudioEffectState'
 
-// liveID 是语聊房的唯一标识
-const liveID = 'your_live_id'; // 替换为实际的语聊房 liveID
-
 // 通过 liveID 获取对应实例
-const { setVoiceEarMonitorEnable, setVoiceEarMonitorVolume, earMonitorVolume } = useAudioEffectState(liveID)
+const { setVoiceEarMonitorEnable, setVoiceEarMonitorVolume, setVoiceEarMonitorEnable, earMonitorVolume } = useAudioEffectState(liveID)
 
 // 1. 开启/关闭耳返
-const toggleEarMonitor = () => {
+const setVoiceEarMonitorEnable = () => {
     setVoiceEarMonitorEnable({
       enable: true // true 为开启， false 为关闭
      })
 }
 
 // 2. 调节耳返音量
-const adjustEarMonitorVolume = () => {
+const setVoiceEarMonitorVolume = () => {
     setVoiceEarMonitorVolume({
       volume: 80
      })
@@ -81,21 +75,21 @@ watch(earMonitorVolume, (newVolume) => {
 ```
 
 #### setVoiceEarMonitorEnable 接口参数
-| **参数名** | **类型** | **描述** |
+| <strong>参数名</strong> | <strong>类型</strong> | <strong>描述</strong> |
 | --- | --- | --- |
-| `enable` | `boolean` | 是否开启耳返。<br>- true：开启<br>- false：关闭 |
+| <code>enable</code> | <code>Bool</code> | 是否开启耳返。<br>- true：开启<br>- false：关闭 |
 
 #### setVoiceEarMonitorVolume 接口参数
-| **参数名** | **类型** | **描述** |
+| <strong>参数名</strong> | <strong>类型</strong> | <strong>描述</strong> |
 | --- | --- | --- |
-| `volume` | `number` | 耳返音量大小。<br>- 取值范围： [0, 150]<br>- 默认值：100 |
+| <code>volume</code> | <code>number</code> | 耳返音量大小。<br>- 取值范围： [0, 150]<br>- 默认值：100 |
 
 ### 步骤4：实现人声音量调节
 
-当主播希望调节自己的上行采集音量大小时，调用`DeviceState`的`setCaptureVolume(volume: )`方法传入音量值即可。
+当主播希望调节自己的上行采集音量大小时，调用 `DeviceState` 的 `setCaptureVolume(volume: )` 方法传入音量值即可。
 
 #### 实现方式:
-1. **设置采集音量值**：您可自行实现调节音量的功能，并将 `UI `上的值映射成音量值后调用`setCaptureVolume(volume: 80)。`请注意，该接口接收的参数范围是 `[0, 150]`，所以您需要将 UI 控件的值映射到 `0 - 150` 的范围。
+1. **设置采集音量值**：您可自行实现调节音量的功能，并将 `UI `上的值映射成音量值后调用 `setCaptureVolume(volume: 80)`。请注意，该接口接收的参数范围是 `[0, 150]，`所以您需要将 UI 控件的值映射到 `0 - 150` 的范围。
 
 2. **监听状态更新 UI**：您可以订阅实时的音量状态值更新 UI。
 
@@ -104,14 +98,11 @@ watch(earMonitorVolume, (newVolume) => {
 import { watch } from 'vue'
 import { useDeviceState } from "@/uni_modules/tuikit-atomic-x/state/DeviceState";
 
-// liveID 是语聊房的唯一标识
-const liveID = 'your_live_id'; // 替换为实际的语聊房 liveID
-
-/ 通过 liveID 获取对应实例
+// 通过 liveID 获取对应实例
 const { setCaptureVolume, captureVolume } = useDeviceState(liveID)
 
 // 1. 调节音量
-const adjustCaptureVolume = () => {
+const setCaptureVolume = () => {
     setCaptureVolume({
       volume: 80
     })
@@ -124,9 +115,9 @@ watch(captureVolume, (newVolume) => {
 ```
 
 #### setCaptureVolume 接口参数
-| **参数名** | **类型** | **描述** |
+| <strong>参数名</strong> | <strong>类型</strong> | <strong>描述</strong> |
 | --- | --- | --- |
-| `volume` | `number` | 采集音量大小。<br>- 取值范围： [0, 150]<br>- 默认值：100 |
+| <code>volume</code> | <code>number</code> | 采集音量大小。<br>- 取值范围： [0, 150]<br>- 默认值：100 |
 
 ### 步骤5：实现变声效果
 
@@ -136,13 +127,11 @@ watch(captureVolume, (newVolume) => {
 ``` typescript
 import { useAudioEffectState } from '@/uni_modules/tuikit-atomic-x/state/AudioEffectState'
 
-// liveID 是语聊房的唯一标识
-const liveID = 'your_live_id'; // 替换为实际的语聊房 liveID
 // 通过 liveID 获取对应实例
 const { setAudioChangerType } = useAudioEffectState(liveID)
 
-// 示例：将变声效果设置为"小孩"
-const applyVoiceChanger = () => {
+// 示例：将变声效果设置为“小孩”
+const setAudioChangerType = () => {
     setAudioChangerType({
       changerType: 'CHILD'
     })
@@ -150,24 +139,22 @@ const applyVoiceChanger = () => {
 ```
 
 #### setAudioChangerType 接口参数
-| **参数名** | **类型** | **描述** |
-| --- | --- | --- |
-| `changerType` | `string` | [变声效果枚举](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/interface.html#AudioReverbTypeParam)。 |
+
+|**参数名**|**类型**|**描述**|
+|---------|---------|---------|
+|`changerType`|`string`|[变声效果枚举。](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/interface.html#AudioReverbTypeParam)|
 
 ### 步骤6：实现混响效果
 
-当主播希望给自己的声音添加混响效果时，您可以调用`setAudioReverbType({type:})` 方法，传入相应的枚举值即可切换效果。
+当主播希望给自己的声音添加混响效果时，您可以调用 `setAudioReverbType({type:})` 方法，传入相应的枚举值即可切换效果。
 ``` typescript
 import { useAudioEffectState } from '@/uni_modules/tuikit-atomic-x/state/AudioEffectState'
 
-// liveID 是语聊房的唯一标识
-const liveID = 'your_live_id'; // 替换为实际的语聊房 liveID
-
 // 通过 liveID 获取对应实例
 const { setAudioReverbType } = useAudioEffectState(liveID)
 
-// 示例：设置为"KTV"混响效果
-const applyReverbEffect = () => {
+// 示例：设置为“KTV”混响效果
+const setAudioReverbType = () => {
     setAudioReverbType({
       reverbType: 'KTV'
     })
@@ -175,23 +162,25 @@ const applyReverbEffect = () => {
 ```
 
 #### setAudioReverbType 接口参数
-| **参数名** | **类型** | **描述** |
-| --- | --- | --- |
-| `reverbType` | `string` | [混响效果枚举](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/interface.html#AudioReverbTypeParam)。 |
+
+|**参数名**|**类型**|**描述**|
+|---------|---------|---------|
+|`reverbType`|`string`|[混响效果枚举。](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/interface.html#AudioReverbTypeParam)|
 
 ## API 文档
 
 关于 [AudioEffectState](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-AudioEffectState) 和 [DeviceState](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-DeviceState) 及其相关类的所有公开接口、属性的详细信息，请参阅随 AtomicXCore 框架的官方 API 文档。
-| **State** | **功能描述** | **API 文档** |
-| --- | --- | --- |
-| AudioEffectState | 音效管理：进行音效设置，并获取实时音效状态。 | [API 文档](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-AudioEffectState) |
-| DeviceState | 设备管理：进行摄像头、麦克风操作，并获取实时设备状态。 | [API 文档](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-DeviceState) |
+
+|**State**|**功能描述**|**API 文档**|
+|---------|---------|---------|
+|AudioEffectState|音效管理：进行音效设置，并获取实时音效状态。|[API 文档](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-AudioEffectState)|
+|DeviceState|设备管理：进行摄像头、麦克风操作，并获取实时设备状态。|[API 文档](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-DeviceState)|
 
 ## 常见问题
 
 ### 音效和设备接口的调用时机有没有要求？
 
-没有限制。`AudioEffectState`和`DeviceState` 的设置是全局生效的，您可以在进入直播间之前或之后随时调用相关接口（例如设置变声、混响或耳返），设置会立即生效并被保留。
+没有限制。`AudioEffectState` 和 `DeviceState` 的设置是全局生效的 您可以在进入直播间之前或之后随时调用相关接口（例如设置变声、混响或耳返），设置会立即生效并被保留。
 
 ### **“人声音量” 和“耳返音量” 有什么区别？**
 
@@ -202,14 +191,14 @@ const applyReverbEffect = () => {
 
 ### **新创建的直播间为什么直接就有音效、或者出现音量很大、很小等问题？**
 
-`AudioEffectState`和`DeviceState`是单例，这意味着音效和设备设置是全局生效的，出现这种情况很可能是因为您之前设置过音效但是没有重置，需要在合适的地方将数据重置。
+`AudioEffectState` 和 `DeviceState` 是单例，这意味着音效和设备设置是全局生效的，出现这种情况很可能是因为您之前设置过音效但是没有重置，需要在合适的地方将数据重置。
 
 ### **为什么我开启了“耳返”，但是听不到自己的声音？**
 
 请您按照以下步骤检查：
 1. **是否插入耳机**：耳返功能绝大多数情况下依赖耳机才能生效，请确保已连接有线或蓝牙耳机。
 
-2. **音量是否为0**：检查“耳返音量”是否被设置为 0。
+2. **音量是否为0**：检查“耳返音量”是否被设置为了 0。
 
 3. **麦克风是否开启**：确认 `DeviceState` 中的麦克风是开启状态（即已调用 `openLocalMicrophone`）。
 

package/resource/{doc → knowledge}/livekit/core-sdk/voice/uni-app/voice-barrage.md

@@ -14,8 +14,9 @@
 ## 实现步骤
 
 ### 步骤1：组件集成
+- **视频直播**：请参考 开播与观看 集成 **AtomicXCore**，完成接入。
 
-请参考 开始直播 集成 **AtomicXCore**，完成接入。
+- **语聊房**：请参考 开播与收听 集成 **AtomicXCore**，完成接入。
 
 ### 步骤2：初始化并监听弹幕
 
@@ -24,9 +25,6 @@
 import { useBarrageState } from "@/uni_modules/tuikit-atomic-x/state/BarrageState";
 import { watch } from 'vue';
 
-// liveID 是语聊房的唯一标识
-const liveID = 'your_live_id'; // 替换为实际的语聊房 liveID
-
 //通过 liveID 获取 BarrageState 的实例
 const { messageList } = useBarrageState(liveID);
 
@@ -42,9 +40,6 @@ watch(messageList, (newVal, oldVal) => {
 ``` typescript
 import { useBarrageState } from "@/uni_modules/tuikit-atomic-x/state/BarrageState";
 
-// liveID 是语聊房的唯一标识
-const liveID = 'your_live_id'; // 替换为实际的语聊房 liveID
-
 //通过 liveID 获取 BarrageState 的实例
 const { sendTextMessage } = useBarrageState(liveID);
 
@@ -63,12 +58,13 @@ const sendMessage = () => {
 ```
 
 #### **接口参数**
-| **参数** | **类型** | **描述** |
-| --- | --- | --- |
-| `liveID` | `string` | 当前直播间的`liveID`。 |
-| `text` | `string` | 要发送的文本内容。 |
-| `success` | `Function` | 发送成功的回调。 |
-| `fail` | `Function` | 发送失败的回调。 |
+
+|**参数**|**类型**|**描述**|
+|---------|---------|---------|
+|`liveID`|`string`|当前直播间的 `liveID`。|
+|`text`|`string`|要发送的文本内容。|
+|`success`|`Function`|发送成功的回调。|
+|`fail`|`Function`|发送失败的回调。|
 
 ### 步骤4：发送自定义弹幕
 
@@ -76,18 +72,15 @@ const sendMessage = () => {
 ``` typescript
 import { useBarrageState } from "@/uni_modules/tuikit-atomic-x/state/BarrageState";
 
-// liveID 是语聊房的唯一标识
-const liveID = 'your_live_id'; // 替换为实际的语聊房 liveID
-
 //通过 liveID 获取 BarrageState 的实例
 const { sendCustomMessage } = useBarrageState(liveID);
 
 /// 发送一条自定义弹幕，例如用于发送礼物
 const sendGiftMessage = ( giftID: string, giftCount: number ) => {
     // 1. 定义一个能识别业务的ID
-    const businessID = "live_gift"
+    const businessID = "live_gift
     // 2. 将业务数据编码为 JSON 字符串
-    const giftData = { "gift_id": giftId, "gift_count": giftCount }
+    const giftData = ["gift_id": giftId, "gift_count": giftCount]
     // 3. 调用核心API发送自定义消息
     sendCustomMessage({
       liveID: 'xxx', // 当前直播间的 liveID
@@ -104,13 +97,14 @@ const sendGiftMessage = ( giftID: string, giftCount: number ) => {
 ```
 
 #### **接口参数**
-| **参数** | **类型** | **描述** |
-| --- | --- | --- |
-| `liveID` | `string` | 当前直播间的`liveID`。 |
-| `businessId` | `string` | 业务唯一标识符，例如 "live_gift"，用于接收端区分不同的自定义消息。 |
-| `data` | `string` | 业务数据，通常为 JSON 格式的字符串。 |
-| `success` | `Function` | 发送成功的回调。 |
-| `fail` | `Function` | 发送失败的回调。 |
+
+|**参数**|**类型**|**描述**|
+|---------|---------|---------|
+|`liveID`|`string`|当前直播间的 `liveID`。|
+|`businessID`|`string`|业务唯一标识符，例如 "live_gift"，用于接收端区分不同的自定义消息。|
+|`data`|`string`|业务数据，通常为 JSON 格式的字符串。|
+|`success`|`Function`|发送成功的回调。|
+|`fail`|`Function`|发送失败的回调。|
 
 ### 步骤5：在本地插入提示消息
 
@@ -118,29 +112,28 @@ const sendGiftMessage = ( giftID: string, giftCount: number ) => {
 ``` typescript
 import { useBarrageState } from "@/uni_modules/tuikit-atomic-x/state/BarrageState";
 
-// liveID 是语聊房的唯一标识
-const liveID = 'your_live_id'; // 替换为实际的语聊房 liveID
-
 //通过 liveID 获取 BarrageState 的实例
 const { appendLocalTip } = useBarrageState(liveID);
+
 const showWelcomeMessage = (user: LiveUserInfo) => {
     // 创建一条本地提示消息
     let welcomeTip = {}
-    welcomeTip.liveID = liveID;
-    welcomeTip.sender = { userID: 'xxx' };
-    welcomeTip.sequence = Date.now();
-    welcomeTip.timestampInSecond = Date.now();
-    welcomeTip.messageType = 'TEXT';
-    welcomeTip.textContent = "欢迎 ${user.userName} 进入直播间！";
+    welcomeTip.liveID = liveID,
+    welcomeTip.sender = { userID: 'xxx' },
+    welcomeTip.sequence = Date.now(),
+    welcomeTip.timestampInSecond = Date.now(),
+    welcomeTip.messageType = 'TEXT',
+    welcomeTip.textContent = "欢迎 ${user.userName} 进入直播间！"
     // 调用 BarrageStore 的接口将其插入弹幕列表
     appendLocalTip(welcomeTip)
 }
 ```
 
 #### **接口参数**
-| **参数** | **类型** | **描述** |
-| --- | --- | --- |
-| `message` | `string` | 要在本地插入的消息对象。SDK 会将此消息对象追加到 `BarrageState` 的 `messageList` 中。 |
+
+|**参数**|**类型**|**描述**|
+|---------|---------|---------|
+|`message`|`string`|要在本地插入的消息对象。SDK 会将此消息对象追加到 `BarrageState` 的 `messageList` 中。|
 
 ### 步骤6：管理用户发言（禁言与解禁）
 
@@ -152,9 +145,6 @@ const showWelcomeMessage = (user: LiveUserInfo) => {
 ``` typescript
 import { useLiveAudienceState } from '@/uni_modules/tuikit-atomic-x/state/LiveAudienceState';
 
-// liveID 是语聊房的唯一标识
-const liveID = 'your_live_id'; // 替换为实际的语聊房 liveID
-
 // 1. 通过 liveID 获取 LiveAudienceState 的实例
 const { disableSendMessage } = useLiveAudienceState(liveID)
 
@@ -163,13 +153,13 @@ const userIdToMute = "user_id_to_be_muted"
 const shouldDisable = true // true为禁言, false为解禁
 
 // 3. 调用接口执行操作
-const handleDisableSendMessage = () => {
+const disableSendMessage = () => {
     disableSendMessage({
       liveID: 'xxx', // 当前直播间 liveID
-      userID: userIdToMute,
+      userID: userIdToMute
       isDisable: shouldDisable,
       success: () => {
-        console.log(`${shouldDisable ? "禁言" : "解禁"}用户 ${userIdToMute}成功`)
+        console.log("${shouldDisable ? "禁言" : "解禁"}用户 ${userIdToMute}成功")
       },
       fail: (error) => {
         console.log("操作失败", error)
@@ -182,6 +172,8 @@ const handleDisableSendMessage = () => {
 
 要对直播间内所有用户（通常不包括主播自己）进行禁言，您需要通过 `LiveListState` 的 `updateLiveInfo` 更新直播间信息来实现。
 ``` typescript
+import { useLiveListState } from "@/uni_modules/tuikit-atomic-x/state/LiveListState";
+
 // 1. 获取 LiveListState 的实例
 const { updateLiveInfo, currentLive } = useLiveListState();
 
@@ -189,7 +181,7 @@ const { updateLiveInfo, currentLive } = useLiveListState();
 currentLive.value.isMessageDisable = true // true 为全体禁言, false 为关闭
 
 // 3. 调用更新接口，并指定修改的标志位
-const handleUpdateLiveInfo = () => {
+const updateLiveInfo = () => {
     updateLiveInfo({
       liveInfo: currentLive.value,
       modifyFlagList: ['IS_MESSAGE_DISABLE'],
@@ -201,7 +193,6 @@ const handleUpdateLiveInfo = () => {
       }
     })
 }
-
 ```
 
 ## 功能进阶：高并发场景下的性能优化
@@ -216,7 +207,7 @@ const handleUpdateLiveInfo = () => {
 
 #### 技术挑战
 
-SDK 会以极高频率返回完整的弹幕列表。如果每次都更新完整的消息列表，主线程会被密集的UI布局和渲染操作阻塞，导致界面卡顿。
+SDK 会以极高频率返回完整的弹幕列表。如果每次都更新完整的消息列表，主线程会被密集的 UI 布局和渲染操作阻塞，导致界面卡顿。
 
 #### 优化方案：批处理与流量削峰 (Batch Processing & Debouncing)
 
@@ -224,7 +215,8 @@ SDK 会以极高频率返回完整的弹幕列表。如果每次都更新完整
 
 #### 代码示例
 ``` typescript
-  import { watch } from 'vue';
+
+  import { watch } from 'vue'
   // UI 展示数据
   const mixMessageList = ref()
   // ===== 防抖配置 =====
@@ -289,7 +281,7 @@ SDK 会以极高频率返回完整的弹幕列表。如果每次都更新完整
 
 #### 技术挑战
 
-SDK 返回的全量 `messageList` 会在长时间直播中无限增长，即使 `UI` 层做了节流，数据层持有的这个巨大数组也会持续侵占内存，最终导致应用闪退。
+SDK 返回的全量 `messageList` 会在长时间直播中无限增长，即使 `UI` 层做了节流，数据层持有的这个巨大数组也会持续占用内存，最终导致应用闪退。
 
 #### 优化方案：固定容量的循环数组 (Circular Buffer)
 
@@ -341,7 +333,7 @@ SDK 返回的全量 `messageList` 会在长时间直播中无限增长，即使
    ```
 2. **发送端:** 在发送时，将这个 JSON 结构转换为字符串，并通过 `sendCustomMessage` 的 `data` 参数发送出去。`businessID` 可以设置为一个能代表您业务的唯一标识，例如 "`barrage_style_v1`"。
 
-3. **接收端**: 在接收到弹幕消息后，检查其 `messageType` 是否为 `'CUSTOM'` 以及 `businessID` 是否匹配。如果匹配，则解析 `data` 字符串（通常是解析JSON），根据解析出的数据（例如 `color、text`）来渲染您的自定义UI样式。
+3. **接收端**: 在接收到弹幕消息后，检查其 `messageType` 是否为 `'CUSTOM'` 以及 `businessID` 是否匹配。如果匹配，则解析 `data` 字符串（通常是解析 JSON），根据解析出的数据（例如 `color、text`）来渲染您的自定义 UI 样式。
 
 ### 为什么我调用了 sendTextMessage，但是在消息列表中看不到我发送的消息？
 
@@ -358,12 +350,20 @@ SDK 返回的全量 `messageList` 会在长时间直播中无限增长，即使
 
 `AtomicXCore` 支持拉取历史弹幕消息，但这需要您在**服务端控制台**进行一项简单的配置。配置完成后，SDK 会自动处理后续的一切，您无需编写额外的代码。
 
-**步骤1：在 IM 控制台进行配置**
-1. 登录您的 [即时通信 IM 控制台](https://cloud.tencent.com/login?s_url=https%3A%2F%2Fconsole.cloud.tencent.com%2Fim)。
+**步骤1：在控制台进行配置**
+
+根据您的应用创建方式，选择对应的控制台进行配置（实时音视频控制台或即时通信 IM 控制台）。
+
+在控制台的配置页面中，找到**查看直播间历史消息**选项，修改其配置（最大支持 **50** 条消息）。
+- 若您的应用在 [实时音视频控制台](https://console.cloud.tencent.com/trtc/app) 创建，配置步骤如下：
+
+   左侧导航栏选择**应用管理** > **功能配置 **>** LiveKit 功能**，在**应用管理**选择对应的应用后，单击**查看直播间历史消息 > 编辑**。
+
+- 若您的应用在 [即时通信 IM 控制台](https://console.cloud.tencent.com/im/rtc-config) 创建，配置步骤如下：
 
-2. 在左侧导航栏按照路径：**消息服务 Chat** >** 功能配置 **>** 群组配置 **> **群功能配置** >** 直播群新成员查看入群前消息量配置**进行导航。
+   左侧导航栏选择**音视频服务 RTC**，选择对应的应用后，单击**在线直播/语音聊天室(TUILiveKit) > 配置**。
 
-3. 修改“新成员可查看最近消息数”，最大支持 **50** 条。
+   进入 **LiveKit 功能配置**后，单击**查看直播间历史消息** > **编辑**。
 
    **步骤2：客户端无感获取 **