@tencentcloud/sdk-mcp 1.6.3 → 1.6.5

package/resource/knowledge/callkit/best-practice/web/callengine-invitation.md

@@ -0,0 +1,80 @@
+---
+product: 'Call'
+tech_stack: 'callengine'
+framework: 'web'
+doc_kind: 'best_practice'
+title: 'TUICallengine 通话处理'
+keywords: ['ON_CALL_RECEIVED', '通话邀请', '@trtc/call-engine-lite-js', 'calls', 'businessID', 'userData', 'callMediaType', 'calls', 'accept', 'onReceiveNewInvitation', 'onRecvNewMessage 自定义消息']
+---
+
+# TUICallEngine Web 通话邀请接收与信令说明
+
+适用包：**@trtc/call-engine-lite-js**（TUICallEngine Web SDK）。
+
+## 一、如何接收通话邀请？
+
+**应用层应监听 `TUICallEvent.ON_CALL_RECEIVED`，而不是 TRTC Signaling 或 IM 自定义消息。**
+
+```javascript
+import { TUICallEngine, TUICallEvent } from '@trtc/call-engine-lite-js';
+
+const tuiCallEngine = TUICallEngine.createInstance({ SDKAppID: xxx, tim: timInstance });
+await tuiCallEngine.login({ userID, userSig });
+
+tuiCallEngine.on(TUICallEvent.ON_CALL_RECEIVED, (event) => {
+  console.log('来电', event);
+  // 展示接听 UI，随后 accept() 或 reject()
+});
+```
+
+### ON_CALL_RECEIVED 事件字段
+
+|参数|类型|含义|
+|---------|---------|---------|
+|callerId|String|邀请者。|
+|calleeIdList|Array<String>|同时还被邀请的人。|
+|isFromGroup|Boolean|是否是群组通话。|
+|inviteData|Object|呼叫数据。|
+|inviteID|String|邀请 ID，标识一次邀请。|
+|userData|String|扩展字段：用于在邀请信令中增加扩展信息。|
+|callId|String|本次通话的唯一 ID。|
+|roomID|Number|此次通话的音视频房间 ID。|
+|callMediaType|Number|通话的媒体类型，视频通话、语音通话。|
+|callRole|String|角色，枚举类型：主叫、被叫。|
+
+## 二、calls API 发送邀请时的参数有哪些？
+
+主叫通过 **`TUICallEngine.calls()`** 发起邀请：
+
+```javascript
+await tuiCallEngine.calls({
+  userIDList: ['user_bob'],
+  type: 2,                    // 1=语音 2=视频（CallMediaType）
+  userData: '{"ext":"info"}', // 可选，字符串
+  timeout: 30,                // 秒，默认 30
+  roomID: 123456,             // 数字房间号, 范围 [1, 2147483647]
+  strRoomID: '',              // 字符串房间号
+  chatGroupID: '',            // 在 Chat 群聊中多人通话时填写
+  offlinePushInfo: { /* … */ },
+});
+```
+
+## 三、在 Chat 中集成音视频通话时，如果需要处理通话消息上屏，自定义消息中的字段含义？
+
+|**问题**|**说明**|
+|---------|---------|
+|如何判断 “发起通话”|actionType = 1 且 cmd = 'videoCall' 或 'audioCall'|
+|如何判断 “已接听”|actionType = 3 |
+|如何判断 “通话已结束”，“通话时长是多少”|actionType = 1 且 cmd = 'hangup'，通话时长取 call_end 字段，单位：秒|
+|如何判断 “取消通话”|actionType = 2|
+|如何判断 “拒绝通话”|actionType = 4|
+|如何判断对端忙线产生的 “拒绝通话”|actionType = 4 且 cmd = "line_busy"|
+|如何被叫判断 “超时未接听”|actionType = 5|
+
+## 四、最佳实践摘要
+
+1. **只监听** `TUICallEvent.ON_CALL_RECEIVED`，用 `accept()` / `reject()` 响应。
+2. **不要**监听 `TIM.EVENT.MESSAGE_RECEIVED` 自行解析通话邀请。
+3. 扩展信息用 **`userData` 字符串**，主叫传入、被叫从事件读取。
+4. **`businessID` / 底层 payload 格式**属 SDK 内部实现；无官方公开文档前不要编造。
+5. **`@trtc/call-engine-lite-js` 4.x 起发起通话时需要传递自定义内容可以通过 `userData` 传递给被叫，不存在 `customData` 字段。

package/resource/knowledge/callkit/best-practice/web/callengine-log-control.md

@@ -0,0 +1,20 @@
+---
+product: 'Call'
+tech_stack: 'callengine'
+framework: 'web'
+doc_kind: 'best_practice'
+title: 'TUICallengine 设置日志输出级别'
+keywords: ['控制台日志', '关闭 log', 'log level']
+---
+
+# TUICallEngine 设置日志输出级别
+
+Web TUICallEngine 提供浏览器控制台日志输出控制接口 setLogLevel。
+日志级别分为以下几种：
+0 普通级别，日志量较多，接入时建议使用
+1 主要级别，SDK 输出关键信息，默认日志等级
+2 告警级别，SDK 只输出告警和错误级别的日志
+3 错误级别，SDK 只输出错误级别的日志
+4 无日志级别，SDK 将不打印任何日志
+
+文档：[setLogLevel](https://web.sdk.qcloud.com/component/trtccalling/doc/TUICallEngine/web/zh-cn/TUICallEngine.html#setLogLevel)

package/resource/knowledge/callkit/best-practice/web/callkit-call-vs-calls.md

@@ -0,0 +1,116 @@
+---
+product: 'Call'
+tech_stack: 'callkit'
+framework: 'web'
+doc_kind: 'best_practice'
+title: 'TUICallKit Web 发起音视频通话：call 与 calls、参数格式与示例'
+keywords: ['TUICallKit 发起音视频通', 'call 和 calls 方法的区别', 'userIDList 参数应该怎么传', 'type 参数 1 和 2 分别代表什么', 'TUICallKit vue', 'TUICallKit React']
+---
+
+## 最佳实践（结论优先）
+1. Web TUICallKit **v4.x 必须使用 `calls`** 发起单聊/多人通话；`call`、`groupCall` 仅适用于 v4.0.0 以前版本， v4.0.0 起已不支持。
+2. 发起通话前必须先完成 `init`，否则会出现调用失败或状态异常。
+3. `type` 推荐使用 `CallMediaType` 枚举常量，不建议继续使用数字字面量（1/2）作为主写法。
+4. `userIDList` 必须传数组（单聊也传单元素数组）；需要和 Chat 群联动时再传 `chatGroupID`。
+
+### 初始化示例（v4.x，React）
+``` javascript
+import { TUICallKitAPI } from "@trtc/calls-uikit-react";
+
+TUICallKitAPI.init({ SDKAppID, userID, userSig });
+```
+
+### 旧版本初始化示例（v4.0.0 以前）
+``` javascript
+import { TUICallKitServer } from "@tencentcloud/call-uikit-react";
+
+TUICallKitServer.init({ SDKAppID, userID, userSig });
+```
+
+## 常见误区（反例）
+- 在 v4.x 里继续调用 `call` / `groupCall`。
+- 把单聊写成 `userID` 字段而不是 `userIDList`。
+- `roomID` 与 `strRoomID` 混用（两者互斥，且不互通）。
+- `type` 长期使用数字字面量而非 `CallMediaType` 枚举常量。
+
+## v4.x calls 接口的使用示例
+发起单人或多人通话。
+``` javascript
+try {
+  await TUICallKitAPI.calls({
+    userIDList: ['jack', 'tom'],
+    type: CallMediaType.VIDEO_CALL
+  });
+} catch (error: any) {
+  console.error(`[TUICallKit] Failed to call the groupCall API. Reason:${error}`);
+}
+```
+
+参数如下表所示：
+| 参数 | 类型 | 是否必填 | 含义 |
+| --- | --- | --- | --- |
+| userIDList | Array<String> | 是 | 被呼叫的用户列表。 |
+| type | CallMediaType| 是 | 通话的媒体类型。<br>兼容旧版本：语音通话(type = 1)、视频通话(type = 2)。 |
+| chatGroupID | String | 是 | 与 Chat 结合使用时， Chat 群组的群 ID。 |
+| roomID | Number | 否 | 数字房间号，范围 [1, 2147483647]。 |
+| strRoomID | String | 否 | 字符串房间号。<strong>v3.3.1+ 支持</strong><br>1. roomID 与 strRoomID 是互斥的，若您选用 strRoomID，则 roomID 需要填写为 0。若两者都填，SDK 将优先选用 roomID。<br>2. 不要混用 roomID 和 strRoomID，因为它们之间是不互通的，例如数字 123 和字符串 "123" 是两个完全不同的房间。 |
+| timeout | Number | 否 | 通话超时时间，默认：30s，单位：秒。设置范围：10s ~ 600s。如果传入0，默认30s。 |
+| userData | String | 否 | 发起通话时自定义扩展字段，被呼叫用户在 ON_CALL_RECEIVED 事件中有该参数。 |
+| <a href="https://cloud.tencent.com/document/product/647/81015#offlinePushInfo">offlinePushInfo</a> | Object | 否 | 自定义离线消息推送参数。 |
+
+### CallMediaType 通话类型
+|CallMediaType 类型|描述|
+|---------|---------|
+|CallMediaType.AUDIO|语音通话。|
+|CallMediaType.VIDEO|视频通话。|
+
+## 低版本（v2.x/v3.x）`call` 和 `groupCall` 接口使用示例
+
+### call 发起单人通话
+``` javascript
+import { TUICallKitServer, TUICallType } from '@tencentcloud/call-uikit-react';
+try {
+  await TUICallKitServer.call({
+    userID: 'mike', // username being called
+    type: TUICallType.VIDEO_CALL,
+  });
+} catch (error: any) {
+  console.error(`[TUICallKit] Call failed. Reason: ${error}`);
+}
+```
+
+参数如下表所示：
+| 参数 | 类型 | 是否必填 | 含义 |
+| --- | --- | --- | --- |
+| userID | String | 是 | 被呼叫的用户 ID。 |
+| type | TUICallType | 是 | 通话的媒体类型。<br>兼容旧版本：语音通话(type = 1)、视频通话(type = 2)。 |
+| roomID | Number | 否 | 数字房间号，范围 [1, 2147483647]。 |
+| strRoomID | String | 否 | 字符串房间号。<strong>v3.3.1+ 支持</strong><br>1. roomID 与 strRoomID 是互斥的，若您选用 strRoomID，则 roomID 需要填写为 0。若两者都填，SDK 将优先选用 roomID。<br>2. 不要混用 roomID 和 strRoomID，因为它们之间是不互通的，例如数字 123 和字符串 "123" 是两个完全不同的房间。 |
+| timeout | Number | 否 | 通话超时时间，默认：30s，单位：秒。设置范围：10s ~ 600s。如果传入0，默认30s。 |
+| userData | String | 否 | 发起通话时自定义扩展字段，被呼叫用户在 ON_CALL_RECEIVED 事件中有该参数。 |
+| offlinePushInfo | Object | 否 | 自定义离线消息推送参数。 |
+
+### groupCall 发起多人通话
+``` javascript
+try {
+  await TUICallKitServer.groupCall({
+    userIDList: ['jack', 'tom'],
+    groupID: "xxx",
+    type: TUICallType.VIDEO_CALL
+  });
+} catch (error: any) {
+  console.error(`[TUICallKit] Failed to call the groupCall API. Reason:${error}`);
+}
+```
+
+参数如下表所示：
+| 参数 | 类型 | 是否必填 | 含义 |
+| --- | --- | --- | --- |
+| userIDList| Array<String> | 是 | 被呼叫的用户 ID。 |
+| type | TUICallType | 是 | 通话的媒体类型。<br>兼容旧版本：语音通话(type = 1)、视频通话(type = 2)。 |
+| groupID | String | 是 | 通话群组 ID，groupID 的创建可参见。 |
+| roomID | Number | 否 | 数字房间号，范围 [1, 2147483647]。 |
+| strRoomID | String | 否 | 字符串房间号。<strong>v3.3.1+ 支持</strong><br>1. roomID 与 strRoomID 是互斥的，若您选用 strRoomID，则 roomID 需要填写为 0。若两者都填，SDK 将优先选用 roomID。<br>2. 不要混用 roomID 和 strRoomID，因为它们之间是不互通的，例如数字 123 和字符串 "123" 是两个完全不同的房间。 |
+| timeout | Number | 否 | 通话超时时间，默认：30s，单位：秒。设置范围：10s ~ 600s。如果传入0，默认30s。 |
+| userData | String | 否 | 发起通话时自定义扩展字段，被呼叫用户在 ON_CALL_RECEIVED 事件中有该参数。 |
+| offlinePushInfo | Object | 否 | 自定义离线消息推送参数。 |

package/resource/knowledge/callkit/core-sdk/android/answer-call.md

@@ -2,16 +2,14 @@
 
 > 推荐使用更高效的 AI 集成助手
 >
-
 > 我们为您提供了全新的 AI 集成方式，只需要描述您的需求，即可自动生成集成代码，大幅提升开发效率。
 >
-
-> 点击这里，立即体验 AI 集成
+> 点击这里，立即体验 AI 集成
 >
 
 ## **核心功能**
 
-**AtomicXCore **中用于搭建多人音视频通话场景所需要使用到的核心模块包含以下三个：
+**AtomicXCore** 中用于搭建多人音视频通话场景所需要使用到的核心模块包含以下三个：
 | <strong>模块</strong> | <strong>功能描述</strong> |
 | --- | --- |
 | <a href="https://liteav.sdk.cloudcachetci.com/doc/product/tuikit/atomic-x/android/zh/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.view/-call-core-view/index.html">CallCoreView</a> | 通话视图核心组件。自动监听 CallStore 数据并完成画面渲染，同时提供布局切换、头像与图标配置等 UI 定制化能力。 |
@@ -103,7 +101,7 @@ class MainActivity : ComponentActivity() {
 您需要创建一个通话页面，当收到来电时唤起通话页面，实现方式如下：
 1. **创建通话页面：**您可以新建一个 Activity 作为通话宿主页面，用于响应来电时的跳转逻辑。
 
-2. **通话页面绑定 **[**CallCoreView**](https://liteav.sdk.cloudcachetci.com/doc/product/tuikit/atomic-x/android/zh/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.view/-call-core-view/index.html) : 通话视图核心组件，自动监听 [CallStore](https://liteav.sdk.cloudcachetci.com/doc/product/tuikit/atomic-x/android/zh/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.call/-call-store/index.html) 数据并完成画面渲染，同时提供布局切换、头像与图标配置等 UI 定制化能力。
+2. **通话页面绑定** [**CallCoreView**](https://liteav.sdk.cloudcachetci.com/doc/product/tuikit/atomic-x/android/zh/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.view/-call-core-view/index.html) : 通话视图核心组件，自动监听 [CallStore](https://liteav.sdk.cloudcachetci.com/doc/product/tuikit/atomic-x/android/zh/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.call/-call-store/index.html) 数据并完成画面渲染，同时提供布局切换、头像与图标配置等 UI 定制化能力。
 
 【Android】
 ``` java
@@ -414,7 +412,7 @@ class CallActivity : AppCompatActivity() {
 | callId | String | 此次通话的唯一标识。 |
 | mediaType | <a href="https://liteav.sdk.cloudcachetci.com/doc/product/tuikit/atomic-x/android/zh/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.call/-call-media-type/index.html">CallMediaType</a> | 通话媒体类型，用于指定发起音频通话还是视频通话。<br>- <code>CallMediaType.Video</code> : 视频通话。<br>- <code>CallMediaType.Audio</code> : 语音通话。 |
 
-   **openLocalCamera****接口参数详细说明: **
+   **openLocalCamera** **接口参数详细说明:**
 
 | <strong>参数名</strong> | <strong>类型</strong> | <strong>必填</strong> | <strong>说明</strong> |
 | --- | --- | --- | --- |
@@ -457,18 +455,17 @@ private fun addListener() {
 
 > **说明：**
 >
-
 >
 
 ## 定制页面
 
-[CallCoreView](https://liteav.sdk.cloudcachetci.com/doc/product/tuikit/atomic-x/android/zh/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.view/-call-core-view/index.html) 提供了完善的 UI 定制能力，支持头像及音量提示等图标的自由替换。**为助力快速集成，您可以直接从 **[**GitHub**](https://github.com/Tencent-RTC/TUIKit_Android/tree/main/call/tuicallkit-kt/src/main/res)** 下载。这些图标由我们的设计师专为 TUICallKit 打造，无版权风险，可放心使用。**
+[CallCoreView](https://liteav.sdk.cloudcachetci.com/doc/product/tuikit/atomic-x/android/zh/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.view/-call-core-view/index.html) 提供了完善的 UI 定制能力，支持头像及音量提示等图标的自由替换。**为助力快速集成，您可以直接从** [**GitHub**](https://github.com/Tencent-RTC/TUIKit_Android/tree/main/call/tuicallkit-kt/src/main/res) **下载。这些图标由我们的设计师专为 TUICallKit 打造，无版权风险，可放心使用。**
 
 ### 自定义音量提示的图标
 
 您可以调用 [CallCoreView](https://liteav.sdk.cloudcachetci.com/doc/product/tuikit/atomic-x/android/zh/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.view/-call-core-view/index.html) 组件的 [setVolumeLevelIcons](https://liteav.sdk.cloudcachetci.com/doc/product/tuikit/atomic-x/android/zh/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.view/-call-core-view/set-volume-level-icons.html) 设置音量大小等级不同的提示图标。
 
-- **setVolumeLevelIcons****示例代码：**
+- **setVolumeLevelIcons** **示例代码：**
 
    ``` java
    private fun setIconResourcePath() {
@@ -503,7 +500,7 @@ private fun addListener() {
        callCoreView.setNetworkQualityIcons(volumeLevelIcons)
    }
    ```
-- **setNetworkQualityIcons****接口参数详细说明：**
+- **setNetworkQualityIcons** **接口参数详细说明：**
 
 | <strong>参数</strong> | <strong>类型</strong> | <strong>是否必填</strong> | <strong>说明</strong> |
 | --- | --- | --- | --- |
@@ -518,7 +515,7 @@ private fun addListener() {
 ### 自定义默认头像
 
 您可以调用 [CallCoreView](https://liteav.sdk.cloudcachetci.com/doc/product/tuikit/atomic-x/android/zh/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.view/-call-core-view/index.html) 的 [setParticipantAvatars](https://liteav.sdk.cloudcachetci.com/doc/product/tuikit/atomic-x/android/zh/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.view/-call-core-view/set-participant-avatars.html) 接口设置用户头像。建议您监听 CallStore 中的 [allParticipants](https://liteav.sdk.cloudcachetci.com/doc/product/tuikit/atomic-x/android/zh/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.call/-call-state/all-participants.html)（所有参与通话的成员）状态：当获取到用户头像时设置并展示；若用户未设置头像或加载失败，则显示默认头像（占位图）。
-- **setParticipantAvatars****示例代码：**
+- **setParticipantAvatars** **示例代码：**
 
    ``` java
    private fun setParticipantAvatars() {
@@ -530,7 +527,7 @@ private fun addListener() {
        callCoreView.setParticipantAvatars(avatars)
    }
    ```
-- **setParticipantAvatars****接口参数详细说明：**
+- **setParticipantAvatars** **接口参数详细说明：**
 
 | <strong>参数</strong> | <strong>类型</strong> | 是否必填 | <strong>说明</strong> |
 | --- | --- | --- | --- |
@@ -619,7 +616,6 @@ private fun addListener() {
 
    > **说明：**
    >
-
    > 若您想了解更多通话状态响应式数据，详细可参考: [CallState](https://liteav.sdk.cloudcachetci.com/doc/product/tuikit/atomic-x/android/zh/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.call/-call-state/index.html) 。
    >
 
@@ -649,7 +645,7 @@ private fun addListener() {
 
 | <strong>参数</strong> | <strong>类型</strong> | <strong>是否必填</strong> | <strong>说明</strong> |
 | --- | --- | --- | --- |
-| userProfile | <a href="https://liteav.sdk.cloudcachetci.com/doc/product/tuikit/atomic-x/android/zh/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.login/-user-profile/index.html">UserProfile</a> | 是 | 用户信息结构体。<br>- <code>userID</code> (String)：用户的 ID 。<br>- <code>avatarURL</code> (String) : 用户头像的 url 。<br>- <code>nickname </code>(String) ：用户的昵称。<br>更多字段详情可参考 <a href="https://liteav.sdk.cloudcachetci.com/doc/product/tuikit/atomic-x/android/zh/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.login/-user-profile/index.html">UserProfile</a> 。 |
+| userProfile | <a href="https://liteav.sdk.cloudcachetci.com/doc/product/tuikit/atomic-x/android/zh/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.login/-user-profile/index.html">UserProfile</a> | 是 | 用户信息结构体。<br>- <code>userID</code> (String)：用户的 ID 。<br>- <code>avatarURL</code> (String) : 用户头像的 url 。<br>- <code>nickname</code> (String) ：用户的昵称。<br>更多字段详情可参考 <a href="https://liteav.sdk.cloudcachetci.com/doc/product/tuikit/atomic-x/android/zh/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.login/-user-profile/index.html">UserProfile</a> 。 |
 | completion | CompletionHandler | 否 | 操作完成回调，用于返回接通电话的结果。 |
 
 ### 切换布局模式
@@ -660,7 +656,7 @@ private fun addListener() {
 |  |  |  |
 | - <strong>布局逻辑：</strong>呼叫等待时全屏显示己方画面；接通后全屏显示对方画面，己方画面以悬浮小窗展示。<br>- <strong>交互特性：</strong>支持小窗拖拽移动，点击小窗可实现大小画面互换。 | - <strong>布局逻辑：</strong>所有成员画面呈网格状平铺排列成宫格模式布局，适用 2 人以上通话，支持点击放大画面功能。<br>- <strong>交互特性：</strong>支持点击特定成员画面放大查看。 | - <strong>布局逻辑：</strong>1v1 场景固定显示对方画面，多人场景：采用当前发言者（Active Speaker） 策略，自动识别并全屏展示正在说话的用户。<br>- <strong>交互特性：</strong>等待时显示自己的画面，接通后还会显示通话计时。 |
 
-- **setLayoutTemplate****示例代码：**
+- **setLayoutTemplate** **示例代码：**
 
    ``` java
    private fun setLayoutTemplate() {

package/resource/knowledge/callkit/core-sdk/android/make-call.md

@@ -2,16 +2,14 @@
 
 > 推荐使用更高效的 AI 集成助手
 >
-
 > 我们为您提供了全新的 AI 集成方式，只需要描述您的需求，即可自动生成集成代码，大幅提升开发效率。
 >
-
-> 点击这里，立即体验 AI 集成
+> 点击这里，立即体验 AI 集成
 >
 
 ## 核心功能
 
-**AtomicXCore **中用于搭建多人音视频通话场景所需要使用到的核心模块包含以下三个：
+**AtomicXCore** 中用于搭建多人音视频通话场景所需要使用到的核心模块包含以下三个：
 
 |**模块**|**功能描述**|
 |---------|---------|
@@ -110,7 +108,7 @@
 您需要创建一个通话页面，当发起通话唤起通话页面，实现方式如下：
 1. **创建通话页面**：您可以新建一个 Activity 作为通话宿主页面，用于响应来电时的跳转逻辑。
 
-2. **通话页面绑定 **[**CallCoreView**](https://liteav.sdk.cloudcachetci.com/doc/product/tuikit/atomic-x/android/zh/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.view/-call-core-view/index.html) : 通话视图核心组件，自动监听 **CallStore** 数据并完成画面渲染，同时提供布局切换、头像与图标配置等 UI 定制化能力。
+2. **通话页面绑定** [**CallCoreView**](https://liteav.sdk.cloudcachetci.com/doc/product/tuikit/atomic-x/android/zh/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.view/-call-core-view/index.html) : 通话视图核心组件，自动监听 **CallStore** 数据并完成画面渲染，同时提供布局切换、头像与图标配置等 UI 定制化能力。
 
    ``` java
    class CallActivity : AppCompatActivity() {
@@ -508,13 +506,13 @@ class CallActivity : AppCompatActivity() {
 
 ## 定制页面
 
-**CallCoreView** 提供了完善的 UI 定制能力，支持头像及音量提示等图标的自由替换。**为助力快速集成，您可以直接从 **[**Github**](https://github.com/Tencent-RTC/TUIKit_Android/tree/main/call/tuicallkit-kt/src/main/res)** 下载。这些图标由我们的设计师专为 TUICallKit 打造，无版权风险，可放心使用。**
+**CallCoreView** 提供了完善的 UI 定制能力，支持头像及音量提示等图标的自由替换。**为助力快速集成，您可以直接从** [**Github**](https://github.com/Tencent-RTC/TUIKit_Android/tree/main/call/tuicallkit-kt/src/main/res) **下载。这些图标由我们的设计师专为 TUICallKit 打造，无版权风险，可放心使用。**
 
 ### 自定义音量提示的图标
 
 您可以调用 **CallCoreView** 组件的 [setVolumeLevelIcons](https://liteav.sdk.cloudcachetci.com/doc/product/tuikit/atomic-x/android/zh/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.view/-call-core-view/set-volume-level-icons.html) 设置音量大小等级不同的提示图标。
 
-- **setVolumeLevelIcons****示例代码：**
+- **setVolumeLevelIcons** **示例代码：**
 
    ``` java
    private fun setIconResourcePath() {
@@ -549,7 +547,7 @@ class CallActivity : AppCompatActivity() {
        callCoreView.setNetworkQualityIcons(volumeLevelIcons)
    }
    ```
-- **setNetworkQualityIcons****接口参数详细说明：**
+- **setNetworkQualityIcons** **接口参数详细说明：**
 
 | <strong>参数</strong> | <strong>类型</strong> | <strong>是否必填</strong> | <strong>说明</strong> |
 | --- | --- | --- | --- |
@@ -564,7 +562,7 @@ class CallActivity : AppCompatActivity() {
 ### 自定义默认头像
 
 您可以调用 **CallCoreView** 的 [setParticipantAvatars](https://liteav.sdk.cloudcachetci.com/doc/product/tuikit/atomic-x/android/zh/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.view/-call-core-view/set-participant-avatars.html) 接口设置用户头像。建议您监听响应式数据 [allParticipants](https://liteav.sdk.cloudcachetci.com/doc/product/tuikit/atomic-x/android/zh/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.call/-call-state/all-participants.html)（所有参与通话的成员）：当获取到用户头像时设置并展示；若用户未设置头像或加载失败，则显示默认头像（占位图）。
-- **setParticipantAvatars****示例代码：**
+- **setParticipantAvatars** **示例代码：**
 
    ``` java
    private fun setParticipantAvatars() {
@@ -576,7 +574,7 @@ class CallActivity : AppCompatActivity() {
        callCoreView.setParticipantAvatars(avatars)
    }
    ```
-- **setParticipantAvatars****接口参数详细说明：**
+- **setParticipantAvatars** **接口参数详细说明：**
 
 | <strong>参数</strong> | <strong>类型</strong> | 是否必填 | <strong>说明</strong> |
 | --- | --- | --- | --- |
@@ -664,7 +662,6 @@ class CallActivity : AppCompatActivity() {
 
    > **说明：**
    >
-
    > 若您想了解更多通话状态响应式数据，详细可参考：[CallState](https://liteav.sdk.cloudcachetci.com/doc/product/tuikit/atomic-x/android/zh/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.call/-call-state/index.html) 。
    >
 
@@ -694,7 +691,7 @@ class CallActivity : AppCompatActivity() {
 
 | <strong>参数</strong> | <strong>类型</strong> | <strong>是否必填</strong> | <strong>说明</strong> |
 | --- | --- | --- | --- |
-| userProfile | <a href="https://liteav.sdk.cloudcachetci.com/doc/product/tuikit/atomic-x/android/zh/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.login/-user-profile/index.html">UserProfile</a> | 是 | 用户信息结构体。<br>- <code>userID</code> (String)：用户的 ID 。<br>- <code>avatarURL</code> (String) : 用户头像的 URL。<br>- <code>nickname </code>(String) ：用户的昵称。<br>更多字段详情可参考 <a href="https://liteav.sdk.cloudcachetci.com/doc/product/tuikit/atomic-x/android/zh/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.login/-user-profile/index.html">UserProfile</a> 。 |
+| userProfile | <a href="https://liteav.sdk.cloudcachetci.com/doc/product/tuikit/atomic-x/android/zh/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.login/-user-profile/index.html">UserProfile</a> | 是 | 用户信息结构体。<br>- <code>userID</code> (String)：用户的 ID 。<br>- <code>avatarURL</code> (String) : 用户头像的 URL。<br>- <code>nickname</code> (String) ：用户的昵称。<br>更多字段详情可参考 <a href="https://liteav.sdk.cloudcachetci.com/doc/product/tuikit/atomic-x/android/zh/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.login/-user-profile/index.html">UserProfile</a> 。 |
 | completion | CompletionHandler | 否 | 操作完成回调，用于返回接通电话的结果。 |
 
 ### 切换布局模式
@@ -705,7 +702,7 @@ class CallActivity : AppCompatActivity() {
 |  |  |  |
 | - <strong>布局逻辑：</strong>呼叫等待时全屏显示己方画面；接通后全屏显示对方画面，己方画面以悬浮小窗展示。<br>- <strong>交互特性：</strong>支持小窗拖拽移动，点击小窗可实现大小画面互换。 | - <strong>布局逻辑：</strong>所有成员画面呈网格状平铺排列成宫格模式布局，适用 2 人以上通话，支持点击放大画面功能。<br>- <strong>交互特性：</strong>支持点击特定成员画面放大查看。 | - <strong>布局逻辑：</strong>1v1 场景固定显示对方画面，多人场景：采用当前发言者（Active Speaker） 策略，自动识别并全屏展示正在说话的用户。<br>- <strong>交互特性：</strong>等待时显示自己的画面，接通后还会显示通话计时。 |
 
-- **setLayoutTemplate****示例代码：**
+- **setLayoutTemplate** **示例代码：**
 
    ``` java
    private fun setLayoutTemplate() {

package/resource/knowledge/callkit/core-sdk/android/offline-push.md

@@ -6,7 +6,6 @@
 
 > **注意：**
 >
-
 > 购买及免费试用规则详见 计费说明。
 >
 
@@ -19,7 +18,7 @@
 
 - **仅限海外市场（不涉及中国大陆）：**无需集成国内厂商服务。请直接参考本文档集成 FCM Data Message 即可。
 
-- **仅限中国大陆境内：**无需集成 FCM。请参考集成 Notification，按需集成 **Notification **(小米、华为、OPPO、vivo 等国内厂商) 推送即可。
+- **仅限中国大陆境内：**无需集成 FCM。请参考集成 Notification，按需集成 **Notification** (小米、华为、OPPO、vivo 等国内厂商) 推送即可。
 
 ### **如何提高通话触达率？**
 
@@ -31,7 +30,7 @@
 ## **快速接入**
 
 ### **步骤1：厂商配置**
-1. 将您自己的应用注册到 [FCM 推送平台](https://console.firebase.google.com/u/0/)，得到 **AppID** 和 **AppKey** 等参数以及 `google-services.json`文件 ，来实现离线推送功能。
+1. 将您自己的应用注册到 [FCM 推送平台](https://console.firebase.google.com/u/0/)，得到 **AppID** 和 **AppKey** 等参数以及 `google-services.json` 文件 ，来实现离线推送功能。
 
 2. 登录 [即时通信 IM 控制台](https://console.cloud.tencent.com/im)，在**推送管理** > **接入设置**功能栏，选择 FCM，添加 FCM 的证书，其中，消息类型选择**透传（数据）消息**。
 
@@ -55,7 +54,6 @@
 
    > **说明：**
    >
-
    > TIMPush 需要集成 IM SDK 在**7.9.5666**版本及以上。TIMPush 的版本号及更新信息，可以在 [更新日志](https://cloud.tencent.com/document/product/269/102807) 中进行查询。
    >
 

package/resource/knowledge/callkit/core-sdk/flutter/answer-call.md

@@ -2,16 +2,14 @@
 
 > 推荐使用更高效的 AI 集成助手
 >
-
 > 我们为您提供了全新的 AI 集成方式，只需要描述您的需求，即可自动生成集成代码，大幅提升开发效率。
 >
-
-> 点击这里，立即体验 AI 集成
+> 点击这里，立即体验 AI 集成
 >
 
 ## **核心功能**
 
-**AtomicXCore **中用于搭建多人音视频通话场景所需要使用到的核心模块包含以下三个：
+**AtomicXCore** 中用于搭建多人音视频通话场景所需要使用到的核心模块包含以下三个：
 | <strong>模块</strong> | <strong>功能描述</strong> |
 | --- | --- |
 | <a href="https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/flutter/v1.0/zh/api_view_call_call_core_view/CallCoreView-class.html">CallCoreView</a> | 通话视图核心 Widget。自动监听 CallStore 数据并完成画面渲染，同时支持 1v1 和多人通话布局自动切换。 |
@@ -419,7 +417,7 @@ Future<void> _login() async {
 | callId | String | 此次通话的唯一标识。 |
 | mediaType | <a href="https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/flutter/v1.0/zh/api_call_call_store/CallMediaType.html">CallMediaType</a> | 通话媒体类型，用于指定发起音频通话还是视频通话。<br>- <code>CallMediaType.video</code> : 视频通话。<br>- <code>CallMediaType.audio</code> : 语音通话。 |
 
-   **openLocalCamera****接口参数详细说明: **
+   **openLocalCamera** **接口参数详细说明:**
 
 | <strong>参数名</strong> | <strong>类型</strong> | <strong>必填</strong> | <strong>说明</strong> |
 | --- | --- | --- | --- |
@@ -467,16 +465,15 @@ void addListener(BuildContext context) {
 
 > **说明：**
 >
-
 >
 
 ## 定制页面
 
-**CallCoreView** 提供了完善的 UI 定制能力，支持头像及音量提示等图标的自由替换。**为助力快速集成，您可以直接从 **[**Github**](https://github.com/Tencent-RTC/TUIKit_Flutter/tree/main/atomic-x/call_assets)** 下载。这些图标由我们的设计师专为 TUICallKit 打造，无版权风险，可放心使用。**
+**CallCoreView** 提供了完善的 UI 定制能力，支持头像及音量提示等图标的自由替换。**为助力快速集成，您可以直接从** [**Github**](https://github.com/Tencent-RTC/TUIKit_Flutter/tree/main/atomic-x/call_assets) **下载。这些图标由我们的设计师专为 TUICallKit 打造，无版权风险，可放心使用。**
 
 ### 自定义音量提示的图标
 
-您可以调用** CallCoreView** 组件的 [volumeIcons](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/flutter/v1.0/zh/api_view_call_call_core_view/CallCoreView/volumeIcons.html) 参数设置音量大小等级不同的提示图标。
+您可以调用 **CallCoreView** 组件的 [volumeIcons](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/flutter/v1.0/zh/api_view_call_call_core_view/CallCoreView/volumeIcons.html) 参数设置音量大小等级不同的提示图标。
 
 - **volumeIcons 示例代码：**
 
@@ -522,7 +519,7 @@ void addListener(BuildContext context) {
    }
 
    ```
-- **networkQualityIcons****参数详细说明：**
+- **networkQualityIcons** **参数详细说明：**
 
 | <strong>参数</strong> | <strong>类型</strong> | <strong>是否必填</strong> | <strong>说明</strong> |
 | --- | --- | --- | --- |
@@ -537,7 +534,7 @@ void addListener(BuildContext context) {
 ### 自定义默认头像
 
 您可以调用 **CallCoreView** 的 [defaultAvatar](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/flutter/v1.0/zh/api_view_call_call_core_view/CallCoreView/defaultAvatar.html) 参数设置用户默认头像。建议您监听响应式数据 [allParticipants](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/flutter/v1.0/zh/api_call_call_store/CallState/allParticipants.html)（所有参与通话的成员）：当获取到用户头像时设置并展示；若用户未设置头像或加载失败，则显示默认头像（占位图）。
-- **defaultAvatar****示例代码：**
+- **defaultAvatar** **示例代码：**
 
    ``` java
    Widget _buildCallCoreView()  {
@@ -549,7 +546,7 @@ void addListener(BuildContext context) {
    }
 
    ```
-- **defaultAvatar****接口参数详细说明：**
+- **defaultAvatar** **接口参数详细说明：**
 
    |**参数**|**类型**|是否必填|**说明**|
    |---------|---------|---------|---------|
@@ -655,7 +652,6 @@ void addListener(BuildContext context) {
 
    > **说明：**
    >
-
    > 若您想了解更多通话状态响应式数据，详细可参考：[CallState](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/flutter/v1.0/zh/api_call_call_store/CallState-class.html) 。
    >
 
@@ -683,7 +679,7 @@ void addListener(BuildContext context) {
 
 | <strong>参数</strong> | <strong>类型</strong> | <strong>是否必填</strong> | <strong>说明</strong> |
 | --- | --- | --- | --- |
-| userProfile | <a href="https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/flutter/v1.0/zh/api_login_login_store/UserProfile-class.html">UserProfile</a> | 是 | 用户信息结构体。<br>- <code>userID</code> (String)：用户的 ID 。<br>- <code>avatarURL</code> (String) : 用户头像的 URL。<br>- <code>nickname </code>(String) ：用户的昵称。<br>更多字段详情可参考 <a href="https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/flutter/v1.0/zh/api_login_login_store/UserProfile-class.html">UserProfile</a> 。 |
+| userProfile | <a href="https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/flutter/v1.0/zh/api_login_login_store/UserProfile-class.html">UserProfile</a> | 是 | 用户信息结构体。<br>- <code>userID</code> (String)：用户的 ID 。<br>- <code>avatarURL</code> (String) : 用户头像的 URL。<br>- <code>nickname</code> (String) ：用户的昵称。<br>更多字段详情可参考 <a href="https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/flutter/v1.0/zh/api_login_login_store/UserProfile-class.html">UserProfile</a> 。 |
 | completion | CompletionHandler | 否 | 操作完成回调，用于返回接通电话的结果。 |
 
 ### 切换布局模式
@@ -694,7 +690,7 @@ void addListener(BuildContext context) {
 |  |  |  |
 | - <strong>布局逻辑：</strong>呼叫等待时全屏显示己方画面；接通后全屏显示对方画面，己方画面以悬浮小窗展示。<br>- <strong>交互特性：</strong>支持小窗拖拽移动，点击小窗可实现大小画面互换。 | - <strong>布局逻辑：</strong>所有成员画面呈网格状平铺排列成宫格模式布局，适用 2 人以上通话，支持点击放大画面功能。<br>- <strong>交互特性：</strong>支持点击特定成员画面放大查看。 | - <strong>布局逻辑：</strong>1v1 场景固定显示对方画面，多人场景：采用当前发言者（Active Speaker） 策略，自动识别并全屏展示正在说话的用户。<br>- <strong>交互特性：</strong>等待时显示自己的画面，接通后还会显示通话计时。 |
 
-- **setLayoutTemplate****示例代码：**
+- **setLayoutTemplate** **示例代码：**
 
    ``` java
    CallCoreController controller = CallCoreController.create();
@@ -913,10 +909,8 @@ iOS 端支持通过底层 TRTC 引擎实现应用外画中画功能。当应用
 
 > **说明：**
 >
-
 > 需要在 Xcode 的 `Signing & Capabilities` 中添加 `Background Modes` 能力，并勾选 `Audio, AirPlay, and Picture in Picture。`
 >
-
 > 需要 iOS 15.0 及以上版本支持。
 >
 
@@ -1132,7 +1126,6 @@ iOS 端支持通过底层 TRTC 引擎实现应用外画中画功能。当应用
 
    > **注意：**
    >
-
    > 您需要在应用中合适的时机，使用 MethodChannel 调用 start() 方法以开启后台保活能力。
    >