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

package/resource/knowledge/push/integration/unreal-engine.md

@@ -0,0 +1,353 @@
+## 操作步骤
+
+### 步骤1: 集成 TIMPush
+
+完成 [厂商配置](https://cloud.tencent.com/document/product/269/123436) 后集成推送插件，下载 [TIMPush](https://github.com/TencentCloud/TIMSDK/tree/master/UE5/Push/pushdemo/Plugins/TIMPush) 并拷贝到项目的 `Plugins` 目录下，在项目主模块的 Build.cs 文件中，引入 TIMPush。
+| 拷贝目录 | 引入插件 |
+| --- | --- |
+|  |  |
+
+### 步骤2: 推送参数配置
+
+【iOS】
+
+请将您在厂商配置步骤中，获取到的 iOS APNs 推送证书， 上传至 IM 控制台。
+
+IM 控制台会为您分配一个证书 ID，见下图：
+
+设置 businessID：
+
+请在 UE4 Editor 中打开“项目设置”，搜索查找 `Additional Plist Data` 并将下面文本修改后复制进入文本框中，其中 `YourBusinessID` 是必填项，而 `YourGroupID` 是当您需要统计推送的抵达和点击数据时需要修改的值
+``` plaintext
+<key>businessID</key><string>YourBusinessID</string><key>TIMPushAppGroupID</key><string>YourGroupID</string>
+```
+
+开启远程推送能力：
+
+完成证书 ID 配置之后，您需要开启应用的 Push Notifications 能力：
+- 如果您的 UE 引擎是从源代码自行编译构建的，您可以通过 “项目设置 > iOS 中勾选 Enable Remote Notifications Support” 来开启对应能力；
+
+- 如果您的 UE 引擎是从 Epic Game 下载的，您可以通过打开 “`<proj_dir>/Config/DefaultEngine.ini`” ，在脚本的 `IOSRuntimeSettings` 中添加：
+
+``` plaintext
+// Some code
+[/Script/IOSRuntimeSettings.IOSRuntimeSettings]
+bEnableRemoteNotificationsSupport=True
+```
+- 或者，您也可以选择在项目根目录中使用 Xcode 打开 UE 生成的 YourProject.xcworkspace，在 Project > Target 中，点击 Signing & Capabilities 选项，点击左上角 Capability，搜索添加 Push Notifications 能力到您的项目中
+
+【Android】
+
+完成控制台厂商推送信息填写后，下载并添加配置文件到工程。将下载的 `timpush-configs.json` 文件添加到 TIMPush 的 `Source/ThirdParty/TIMPushLibrary/Android/TIMPush/Assets` 目录下。
+| 下载配置文件 | 拷贝路径 |
+| --- | --- |
+|  |  |
+
+### 步骤3: 客户端厂商配置
+
+【iOS】
+
+iOS 端无需进行此步骤。
+
+【Android】
+
+APL 相关配置 TIMPush 已配置好，只需要替换成应用自己的配置信息即可。TIMPush_APL.xml 路径在：`/Plugins/TIMPush/Source/TIMPush/`
+
+#### 1. 推送包集成配置
+``` xml
+ <buildGradleAdditions>
+    <insert>
+      dependencies {
+        // 版本号 “VERSION” 请前往  中获取配置。
+        // 推送主包必须要集成
+        implementation 'com.tencent.timpush:tpush:VERSION'
+
+        // 按照需要集成对应厂商
+        implementation 'com.tencent.timpush:huawei:VERSION'
+        implementation 'com.tencent.timpush:xiaomi:VERSION'
+        implementation 'com.tencent.timpush:oppo:VERSION'
+        implementation 'com.tencent.timpush:vivo:VERSION'
+        implementation 'com.tencent.timpush:honor:VERSION'
+        implementation 'com.tencent.timpush:meizu:VERSION'
+        implementation 'com.tencent.timpush:fcm:VERSION'
+      }
+    </insert>
+  </buildGradleAdditions>
+```
+
+#### **2. vivo 和荣耀适配 **(不接入该厂商不需要关注)
+
+根据 vivo 和荣耀厂商接入指引，需要将 APPID 和 APPKEY 添加到配置文件中，否则会出现编译问题。
+``` xml
+<buildGradleAdditions>
+    <insert>
+      android {
+        defaultConfig {
+          manifestPlaceholders = [
+              "VIVO_APPKEY" : "xxxxxx",    // VIVO AppKey
+              "VIVO_APPID" : "xxxxxx",     // VIVO AppId
+              "HONOR_APPID" : "xxxxxx"     // Honor AppId
+          ]
+        }
+      }
+    </insert>
+  </buildGradleAdditions>
+```
+
+#### **3. 华为、荣耀和 Google FCM 适配**
+
+按照厂商方法，集成对应的 plugin 和 json 配置文件。
+
+> **注意：**
+>
+
+> 以下荣耀的适配仅 7.7.5283 及以上版本需要配置。
+>
+
+3.1 下载 json 配置文件，添加到插件 TIMPush 目录 `Source/ThirdParty/TIMPushLibrary/Android/TIMPush/` 目录下。
+
+【华为】
+
+【荣耀】
+
+【Google FCM】
+
+【目标路径】
+
+3.2 plugin 相关配置已配置好，可根据需求增减和适配版本。
+``` xml
+<baseBuildGradleAdditions>
+    <insert>
+      allprojects {
+        repositories {
+            mavenCentral()
+            maven { url "https://mirrors.tencent.com/nexus/repository/maven-public/" }
+            maven { url "https://mirrors.tencent.com/repository/maven/liteavsdk/" }
+            maven { url 'https://developer.huawei.com/repo/' }
+            maven { url 'https://mirrors.tencent.com/repository/maven/SensitiveScan' }
+            maven { url 'https://developer.hihonor.com/repo' }
+        }
+      }
+  </insert>
+  </baseBuildGradleAdditions>
+
+  <buildscriptGradleAdditions>
+    <insert>
+      repositories {
+          mavenCentral()
+          maven { url "https://mirrors.tencent.com/nexus/repository/maven-public/" }
+          maven { url "https://mirrors.tencent.com/repository/maven/liteavsdk/" }
+          maven { url 'https://developer.huawei.com/repo/' }
+          maven { url 'https://mirrors.tencent.com/repository/maven/SensitiveScan' }
+          maven { url 'https://developer.hihonor.com/repo' }
+      }
+      dependencies {
+        classpath 'com.google.gms:google-services:4.4.3' // FCM Plugin
+        classpath 'com.huawei.agconnect:agcp:1.9.1.300'  // Huawei Plugin
+        classpath 'com.hihonor.mcs:asplugin:2.0.1.300'   // Honor Plugin
+
+      }
+    </insert>
+  </buildscriptGradleAdditions>
+
+  <buildGradleAdditions>
+    <insert>
+      apply plugin: 'com.google.gms.google-services'  // FCM Plugin
+      apply plugin: 'com.huawei.agconnect'            // Huawei Plugin
+      apply plugin: 'com.hihonor.mcs.asplugin'        // Honor Plugin
+    </insert>
+  </buildGradleAdditions>
+```
+
+### 步骤4：处理消息点击回调，并解析参数
+
+如果您需要自定义解析收到的远程推送，您可按照如下方法实现：
+
+> **注意：**
+>
+> 1. 注册回调时机必须放在程序入口函数中。
+> 2. 控制台配置点击后续动作按如下配置，选择:**打开应用内指定界面，**请勿修改使用默认值。
+
+``` cpp
+class DemoPushListener: public PushListener {
+public:
+    using OnRecvPushMessageCallback = std::function<void(const PushMessage &)>;
+    using OnRevokePushMessageCallback = std::function<void(const FString &)>;
+    using OnNotificationClickedCallback = std::function<void(const FString &)>;
+
+    void SetCallback(OnRecvPushMessageCallback recv_cb, OnRevokePushMessageCallback revoke_cb, OnNotificationClickedCallback clicked_cb) {
+        on_recv_message_callback_ = std::move(recv_cb);
+        on_revoke_message_callback_ = std::move(revoke_cb);
+        on_notification_clicked_callback_ = std::move(clicked_cb);
+    }
+
+    void OnRecvPushMessage(const PushMessage& message) override {
+        if (on_recv_message_callback_) {
+            on_recv_message_callback_(message);
+        }
+    }
+
+    void OnRevokePushMessage(const FString& messageID) override {
+        if (on_revoke_message_callback_) {
+            on_revoke_message_callback_(messageID);
+        }
+    }
+    void OnNotificationClicked(const FString& ext) override {
+        if (on_notification_clicked_callback_) {
+            on_notification_clicked_callback_(ext);
+        }
+    }
+
+private:
+    OnRecvPushMessageCallback on_recv_message_callback_;
+    OnRevokePushMessageCallback on_revoke_message_callback_;
+    OnNotificationClickedCallback on_notification_clicked_callback_;
+};
+
+auto listener = new DemoPushListener();
+listener.SetCallback(
+    [](const PushMessage& message) {
+        UE_LOG(LogTemp, Warning, TEXT("Push Called in OnRecvPushMessage. Message title: %s, desc: %s, ext: %s, id: %s"), *message.GetTitle(), *message.GetDesc(), *message.GetExt(), *message.GetMessageID());
+    },
+    [](const FString& messageID) {
+        UE_LOG(LogTemp, Warning, TEXT("Push Called in OnRevokePushMessage. Message id: %s"), *messageID);
+    },
+    [](const FString& ext) {
+        UE_LOG(LogTemp, Warning, TEXT("Push Called in OnNotificationClicked. Message ext: %s"), *ext);
+    }
+);
+PushManager::GetInstance()->AddPushListener(&listener);
+```
+
+### 步骤5：注册推送插件
+
+调用接口推送注册成功后，就可以收到离线推送通知了。
+``` cpp
+template <class T>
+class DemoPushValueCallback : public PushValueCallback<T> {
+public:
+    using SuccessCallback = std::function<void(const T &)>;
+    using ErrorCallback = std::function<void(int, const FString &)>;
+
+    DemoPushValueCallback<T>() = default;
+    ~DemoPushValueCallback() override = default;
+
+    void SetCallback(SuccessCallback success_cb, ErrorCallback error_cb) {
+        success_callback_ = std::move(success_cb);
+        error_callback_ = std::move(error_cb);
+    }
+
+    void OnSuccess(const T &value) override {
+        if (success_callback_) {
+            success_callback_(value);
+        }
+    }
+    void OnError(int error_code, const FString &error_message) override {
+        if (error_callback_) {
+            error_callback_(error_code, error_message);
+        }
+    }
+
+private:
+    SuccessCallback success_callback_;
+    ErrorCallback error_callback_;
+};
+
+auto callback = new DemoPushValueCallback<FString>();
+callback->SetCallback(
+    [=](const FString &value) {
+      UE_LOG(LogTemp, Warning, TEXT("Push succeed, device token is %s"), *value);
+      delete callback;
+    },
+    [=](int error_code, const FString &error_message) {
+      UE_LOG(LogTemp, Warning, TEXT("Push failed erro code: %d, desc: %s"), error_code, *error_message);
+      delete callback;
+    }
+);
+PushManager::GetInstance()->RegisterPush(您的 sdkAppId, "您的 appKey", callback);
+```
+
+### 步骤6：消息推送触达统计
+
+如果您需要统计触达数据，请按照如下完成配置：
+
+【华为】
+
+回执地址：`https://api.im.qcloud.com/v3/offline_push_report/huawei`
+
+> **注意：**
+>
+
+> 华为推送证书 ID <= 11344时，使用华为推送 v2 版本接口，不支持触达和点击回执，请重新生成更新证书 ID。
+>
+
+【荣耀】
+
+回执地址：`https://api.im.qcloud.com/v3/offline_push_report/honor`
+
+【vivo】
+
+|回调地址配置|回执 ID 配置到 IM 控制台|
+|---------|---------|
+|<br>回执地址：`https://api.im.qcloud.com/v3/offline_push_report/vivo`||
+
+【魅族】
+
+|打开回执开关|配置回执地址|
+|---------|---------|
+|||
+
+回执地址：`https://api.im.qcloud.com/v3/offline_push_report/meizu`
+
+> **注意：**
+>
+
+> 打开回执开关后，请务必确保回执地址正确配置。不配置或者配置地址错误，都会影响推送功能。
+>
+
+【iOS】
+1. 如果您需要统计推送的抵达和点击数据，您需要在上文的 “项目设置” 中将“YourGroupID”修改为您自己的 App Group ID （生成方式可参见 厂商配置-生成 App GroupID）。
+
+2. 在完成 App Group ID 的配置后，您需要使用 Xcode 打开 UE 在项目目录生成的 xcworkspace 文件，并参考 厂商配置-生成 App GroupID-步骤四 中的方法配置您的 App Group ID。之后，请在 Xcode 项目中的 `Editor - Add Target` 中开启 Notification Service Extension Target。
+
+3. 您还需要将项目根目录的 `Plugins-TIMPush-Source-ThirdParty-TIMPushLibrary-iOS` 路径中的两个 framework 压缩包解压缩，并在 Xcode 项目中将内部的 .framework 文件夹添加到您的 pushservice target 之中。
+
+4. 您现在可以在 [Notification Service Extension](https://github.com/TencentCloud/TIMSDK/blob/master/iOS/Demo/pushservice/NotificationService.m) 的 `-didReceiveNotificationRequest:withContentHandler:` 方法中调用推送抵达率统计函数:
+
+``` objectivec
+@implementation NotificationService
+
+- (void)didReceiveNotificationRequest:(UNNotificationRequest *)request withContentHandler:(void (^)(UNNotificationContent * _Nonnull))contentHandler {
+    //appGroup 标识当前主 APP 和 Extension 之间共享的 APP Group，需要在主 APP 的 Capability 中配置 App Groups 能力。
+    //格式为group + [主bundleID]+ key
+    //如group.com.tencent.im.pushkey
+    NSString * appGroupID = kTIMPushAppGroupKey;
+    __weak typeof(self) weakSelf = self;
+    [TIMPushManager handleNotificationServiceRequest:request appGroupID:appGroupID callback:^(UNNotificationContent *content) {
+        weakSelf.bestAttemptContent = [content mutableCopy];
+        // Modify the notification content here...
+        // self.bestAttemptContent.title = [NSString stringWithFormat:@"%@ [modified]", self.bestAttemptContent.title];
+        weakSelf.contentHandler(weakSelf.bestAttemptContent);
+    }];
+}
+
+@end
+```
+
+> **注意：**
+>
+> 5. 上报推送触达数据，需要开启 mutable-content 开关来支持 iOS 10 的 Extension 功能。
+
+> 6. 数据详情可在推送数据页面查看，推送数据页面仅限 [购买推送插件](https://console.cloud.tencent.com/im/plugin/TIMPush)  后使用。
+
+其余支持厂商不需要配置，FCM 暂不支持推送统计功能。
+
+恭喜您已经完成了推送插件的接入，需要提醒您：推送插件**试用或购买到期后，将自动停止提供推送服务（包括普通消息离线推送、全员/标签推送等服务）**。为避免影响您业务正常使用，请提前 [购买](https://buy.cloud.tencent.com/avc)/[续费](https://console.cloud.tencent.com/account/renewal)。
+
+> **说明：**
+>
+> 1. 厂商离线通道都有 [消息分类机制](https://cloud.tencent.com/document/product/269/100649)，不同类型也会有不同的推送策略。
+> - 如果推送需求属于 IM 类型推送，想要推送及时触达，需要按照厂商规则设置自己应用为对应的推送类型，会归类为高优先级的系统消息类型或者重要消息类型。
+> - 反之，离线推送会有数量和频次的限制，可能不会及时推送到设备。
+> 2. 接入完成收不到推送，请先自助使用 [排查工具](https://cloud.tencent.com/document/product/269/100629) 查看下具体原因。推送指标数据查看，请使用 [数据统计](https://cloud.tencent.com/document/product/269/100628) 查询。
+> 3. 全员/标签推送功能请参见：[REST API 接口 - 发起全员/标签推送](https://cloud.tencent.com/document/product/269/100634)。

package/resource/knowledge/push/overview/prepare.md

@@ -0,0 +1,30 @@
+在接入推送服务之前，请务必开通 Push 服务，否则后续接入流程会失败。
+
+## 开通 Push 服务
+1. 登录 [腾讯云即时通信 IM 管理后台](https://console.cloud.tencent.com/im)，在**应用管理**页点击**创建新应用**。
+
+2. 选择**免费开通**消息推送 Push。
+
+3. 填写**应用名称**，选择合适的**数据中心**。
+
+4. 创建 Push 应用成功后，Push 的概览页能看到刚才创建的 SDKAppID。继续点击**免费领取**或**立即购买**，开通 Push 服务：
+
+5. 开通推送服务 Push 后，能在当前页看到推送数据统计信息：
+
+6. 与此同时，消息服务 Chat 里会自动创建一个相同 SDKAppID 的应用。
+
+   > **注意：**
+   >
+>   - **如果您需要使用 Chat 服务发送消息，请记录下该 Chat 应用的信息，否则可以忽略。**
+>   - 自动创建的消息服务 Chat 应用和手动创建的推送服务 Push 应用的 SDKAppID 相同，但密钥不同，注意区分。
+
+## 接入流程说明
+
+开通服务后，可进入接入流程。接入流程主要分为 3 步：
+1. 厂商配置：完成各平台厂商配置。该步骤是离线推送链路的基础，决定哪些设备能从厂商通道收到推送。
+
+2. SDK 接入：完成各平台 TIMPush 接入。完成后即可收到基础离线推送通知。
+
+3. 高级功能设置（可选）：包括消息分类、自定义角标、铃声、小图标、点击跳转、推送触达统计等，用于优化推送体验、满足厂商合规要求。请在基础链路验证通过后再按需启用，便于隔离问题、定位故障。
+
+   建议按上述顺序完成接入，每一步验证通过后再进入下一步，并参考对应平台或厂商文档进行配置。

package/resource/{doc/roomkit/android/features → knowledge/roomkit/core-sdk/android}/call-user-to-room.md

@@ -8,14 +8,14 @@
 ## 核心概念
 
 在开始集成之前，需要通过下表了解一下`RoomStore`中与会中呼叫相关的几个核心概念：
-| **核心概念** | **类型** | **核心职责与描述** |
+| <strong>核心概念</strong> | <strong>类型</strong> | <strong>核心职责与描述</strong> |
 | --- | --- | --- |
-| [RoomCallStatus](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-call-status/index.html) | `enum class` | 代表会中呼叫的状态，包含：<br>- `NONE`（默认态）。<br>- `CALLING`（呼叫中）。<br>- `TIMEOUT`（呼叫超时）。<br>- `REJECTED`（呼叫被拒绝）。 |
-| [RoomCallResult](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-call-result/index.html) | `enum class` | 代表会中呼叫的结果，包含：<br>- `SUCCESS`（呼叫成功）。<br>- `ALREADY_IN_CALLING`（已在呼叫中）。<br>- `ALREADY_IN_ROOM`（已在房间中）。 |
-| [CallRejectionReason](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-call-rejection-reason/index.html) | `enum class` | 代表呼叫被拒绝的原因，目前仅支持：<br>- `REJECTED`当有其他用户向被呼叫方发起入会邀请时触发（主动拒绝）。<br>- `IN_OTHER_ROOM`（在其他房间中）。 |
-| [RoomCall](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-call/index.html) | `data class` | 代表会中呼叫业务的核心数据结构。负责存储呼叫者信息、被呼叫者信息、以及当前呼叫状态。 |
-| [RoomListener](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-listener/index.html) | `abstract class` | 代表房间动态的实时事件。其中包含会中呼叫相关的事件。 |
-| [RoomStore](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-store/index.html) | `abstract class` | 这是与房间全生命周期相关的核心类。功能包含：发起会中呼叫，响应会中呼叫，获取房间的会中呼叫列表，并通过订阅其 `RoomListener` 来接收与会中呼叫相关的实时动态事件。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-call-status/index.html">RoomCallStatus</a> | <code>enum class</code> | 代表会中呼叫的状态，包含：<br>- <code>NONE</code>（默认态）。<br>- <code>CALLING</code>（呼叫中）。<br>- <code>TIMEOUT</code>（呼叫超时）。<br>- <code>REJECTED</code>（呼叫被拒绝）。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-call-result/index.html">RoomCallResult</a> | <code>enum class</code> | 代表会中呼叫的结果，包含：<br>- <code>SUCCESS</code>（呼叫成功）。<br>- <code>ALREADY_IN_CALLING</code>（已在呼叫中）。<br>- <code>ALREADY_IN_ROOM</code>（已在房间中）。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-call-rejection-reason/index.html">CallRejectionReason</a> | <code>enum class</code> | 代表呼叫被拒绝的原因，目前仅支持：<br>- <code>REJECTED</code>当有其他用户向被呼叫方发起入会邀请时触发（主动拒绝）。<br>- <code>IN_OTHER_ROOM</code>（在其他房间中）。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-call/index.html">RoomCall</a> | <code>data class</code> | 代表会中呼叫业务的核心数据结构。负责存储呼叫者信息、被呼叫者信息、以及当前呼叫状态。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-listener/index.html">RoomListener</a> | <code>abstract class</code> | 代表房间动态的实时事件。其中包含会中呼叫相关的事件。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-store/index.html">RoomStore</a> | <code>abstract class</code> | 这是与房间全生命周期相关的核心类。功能包含：发起会中呼叫，响应会中呼叫，获取房间的会中呼叫列表，并通过订阅其 <code>RoomListener</code> 来接收与会中呼叫相关的实时动态事件。 |
 
 ## 实现步骤
 
@@ -134,12 +134,13 @@ fun subscribeRoomCallEvents() {
 ```
 
 **呼叫事件函数详细说明**
-| 事件函数 | 触发时机与说明 |
-| --- | --- |
-| [onCallTimeout](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-listener/on-call-timeout.html) | 呼叫超时。当呼叫请求在预设的时间内（由调用 callUserToRoom 时指定）未得到被呼叫方的响应时触发。此时，呼叫自动结束，呼叫方通常需要提示“对方无人接听”。 |
-| [onCallAccepted](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-listener/on-call-accepted.html) | 呼叫被接受。被呼叫方主动点击了“接听”或“接受”按钮。收到此回调后，表示双方已达成呼叫意图，呼叫方通常应立即执行进入房间或开始推流的操作。 |
-| [onCallRejected](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-listener/on-call-rejected.html) | 呼叫被拒绝。被呼叫方主动拒绝了通话请求，或者因为被呼叫方当前正处于其他房间中而自动拒绝。回调中通常包含拒绝原因（例如主动拒绝或在其他房间中）。 |
-| [onCallHandledByOtherDevice](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-listener/on-call-handled-by-other-device.html) | 呼叫已在其他设备处理。当用户在多个设备（如手机和 iPad）同时登录时，如果呼叫已在其中一台设备上被处理（接受或拒绝），当前设备会收到此通知，用于同步 UI 状态并自动消除呼叫界面。 |
+
+|事件函数|触发时机与说明|
+|---------|---------|
+|[onCallTimeout](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-listener/on-call-timeout.html)|呼叫超时。当呼叫请求在预设的时间内（由调用 callUserToRoom 时指定）未得到被呼叫方的响应时触发。此时，呼叫自动结束，呼叫方通常需要提示“对方无人接听”。|
+|[onCallAccepted](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-listener/on-call-accepted.html)|呼叫被接受。被呼叫方主动点击了“接听”或“接受”按钮。收到此回调后，表示双方已达成呼叫意图，呼叫方通常应立即执行进入房间或开始推流的操作。|
+|[onCallRejected](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-listener/on-call-rejected.html)|呼叫被拒绝。被呼叫方主动拒绝了通话请求，或者因为被呼叫方当前正处于其他房间中而自动拒绝。回调中通常包含拒绝原因（例如主动拒绝或在其他房间中）。|
+|[onCallHandledByOtherDevice](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-listener/on-call-handled-by-other-device.html)|呼叫已在其他设备处理。当用户在多个设备（如手机和 iPad）同时登录时，如果呼叫已在其中一台设备上被处理（接受或拒绝），当前设备会收到此通知，用于同步 UI 状态并自动消除呼叫界面。|
 
 ### 步骤3：被呼叫方功能
 
@@ -173,11 +174,12 @@ fun subscribeRoomCallEvents() {
 ```
 
 **事件函数详细说明**
-| 事件函数 | 触发时机与说明 |
-| --- | --- |
-| [onCallReceived](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-listener/on-call-received.html) | 收到呼叫邀请。当有其他用户向您发起入会邀请时触发。收到此回调后，被呼叫方通常应立即弹出“呼叫提醒”界面，展示呼叫者信息、房间信息，并提供“接听”和“拒绝”按钮。 |
-| [onCallCancelled](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-listener/on-call-cancelled.html) | 呼叫被发起方取消。呼叫方在被呼叫方callUserToRoom未做出响应前，主动撤回了呼叫请求。收到此回调后，被呼叫方应立即关闭当前的来电界面，并提示“对方已取消呼叫”，以恢复应用正常操作流程。 |
-| [onCallRevokedByAdmin](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-listener/on-call-revoked-by-admin.html) | 呼叫被管理员撤销。房间管理员或后台系统因权限变更、房间解散等原因强行终止了该笔呼叫邀请。收到此通知后，被呼叫方需立即停止呼叫流程并隐藏相关 UI，处理逻辑通常类似于呼叫被取消。 |
+
+|事件函数|触发时机与说明|
+|---------|---------|
+|[onCallReceived](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-listener/on-call-received.html)|收到呼叫邀请。当有其他用户向您发起入会邀请时触发。收到此回调后，被呼叫方通常应立即弹出“呼叫提醒”界面，展示呼叫者信息、房间信息，并提供“接听”和“拒绝”按钮。|
+|[onCallCancelled](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-listener/on-call-cancelled.html)|呼叫被发起方取消。呼叫方在被呼叫方callUserToRoom未做出响应前，主动撤回了呼叫请求。收到此回调后，被呼叫方应立即关闭当前的来电界面，并提示“对方已取消呼叫”，以恢复应用正常操作流程。|
+|[onCallRevokedByAdmin](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-listener/on-call-revoked-by-admin.html)|呼叫被管理员撤销。房间管理员或后台系统因权限变更、房间解散等原因强行终止了该笔呼叫邀请。收到此通知后，被呼叫方需立即停止呼叫流程并隐藏相关 UI，处理逻辑通常类似于呼叫被取消。|
 
 #### **2. 接受呼叫、拒绝呼叫**
 
@@ -229,6 +231,6 @@ fun rejectCall(roomID: String, reason: CallRejectionReason = CallRejectionReason
 ```
 
 ## API 文档
-| **Store/Component** | **功能描述** | **API文档** |
+| <strong>Store/Component</strong> | <strong>功能描述</strong> | <strong>API文档</strong> |
 | --- | --- | --- |
-| **RoomStore** | 房间全生命周期管理：创建并加入 / 加入 / 离开 / 结束房间 / 更新、获取房间信息 / 房间预约 / 呼叫房间外成员 / 监听房间内被动事件（例如房间解散，房间信息更新等）。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-store/index.html) |
+| <strong>RoomStore</strong> | 房间全生命周期管理：创建并加入 / 加入 / 离开 / 结束房间 / 更新、获取房间信息 / 房间预约 / 呼叫房间外成员 / 监听房间内被动事件（例如房间解散，房间信息更新等）。 | <a href="https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-store/index.html">API 文档</a> |