@tencentcloud/sdk-mcp 1.7.2 → 1.7.4

package/resource/knowledge/callkit/best-practice/flutter/background-incoming-call-no-notification.md

@@ -0,0 +1,99 @@
+---
+title: TUICallKit Flutter 后台/锁屏来电无系统通知、无接听挂断按钮、不拉起 App（Notification/VoIP/权限排查）
+product: call
+frameworks: [flutter, android, ios]
+scope: platform_specific
+tags: [TUICallKit, Flutter, Android, iOS, 后台来电, 锁屏来电, TIMPush, VoIP, CallKit, Notification, enableIncomingBanner, 悬浮窗权限]
+version_range: ">=2.0.0"
+---
+
+# TUICallKit Flutter 后台/锁屏来电无系统通知、无接听挂断按钮、不拉起 App（Notification/VoIP/权限排查）
+
+## 1. 核心结论
+
+- Android：后台/锁屏来电要同时具备**系统通知 + 接听挂断按钮 + 自动拉起 App**，需要 TIMPush（FCM 等厂商推送）+ `enableIncomingBanner` 开关 + **悬浮窗权限**与**后台拉起界面权限**三者齐备；缺任意一项都会退化为"有铃声无通知/无按钮/不拉起"。
+- iOS：**TIMPush 当前不支持 iOS 的 VoIP 推送**（官方文档明确说明，2026-08-12 更新）。Flutter iOS 端只能走 **APNs 普通推送**，无法使用系统级 CallKit 来电 UI，因此 App 被系统杀死或锁屏时，iOS **无法**做到像 Android 那样自动拉起接听/挂断按钮界面，只能收到普通通知，点击后唤醒 App。
+- 根因排查方向：先确认平台（Android 用权限排查，iOS 用推送类型能力边界排查），二者原因和修复路径完全不同，不能用同一套方案套用。
+- 若 App 处于**前台**收到来电但无按钮/不拉起：与推送无关，需检查是否遗漏 `enableIncomingBanner` 配置或悬浮窗权限（Android），或未正确监听 `onCallReceived` 事件展示通知（iOS/Android 通用）。
+
+## 2. 字段语义对照
+
+| 字段/能力 | 作用 | 说明 |
+|---|---|---|
+| `TIMPush`（`tencent_cloud_chat_push` 插件） | 离线推送通用方案 | Android 支持 VoIP 类型推送（走 FCM 等厂商通道）；iOS **当前只支持 APNs**，不支持 VoIP |
+| `TUIOfflinePushInfo.iOSPushType` | 指定 iOS 推送类型 | 仅可设置为 `TUICallIOSOfflinePushType.APNs`，设置为 VoIP 相关值在当前官方能力下不生效 |
+| `enableIncomingBanner` | 控制被叫端来电展示模式 | `false`（默认）：直接尝试拉起全屏通话界面；`true`：先展示横幅通知，需**悬浮窗权限**配合才能展示 |
+| 悬浮窗权限（显示在其他应用上层） | Android 系统权限 | 用于展示自定义来电横幅及通话悬浮窗，缺失则横幅/接听按钮无法展示 |
+| 后台拉起界面权限 | Android 系统权限（部分厂商如 vivo 严格要求） | 用于 App 在后台时拉起通话界面，缺失则无法自动拉起 App |
+| iOS CallKit / PushKit | iOS 原生系统级来电能力 | Flutter TUICallKit **未提供**该方案的官方接入文档，仅原生 iOS SDK 有相关文档 |
+
+## 3. 机制/时序
+
+用户症状：有铃声但没有系统通知、顶部没有接听挂断按钮、不拉起 App -> 先判断平台：
+
+**Android 排查路径**：确认是否已集成 TIMPush 并注册推送 -> 确认 IM 控制台已正确上传 FCM 证书且消息类型为"透传（数据）消息" -> 确认是否调用了 `enableIncomingBanner(true)` -> 确认设备已授予**悬浮窗权限**与**后台拉起界面权限**（不同厂商权限名不同，如 vivo/红米需单独手动开启）-> 若仍拉不起界面，检查主 Activity 启动栈判断代码（`isTaskRoot()` 逻辑）是否缺失，且确认该 Activity 启动模式**不是** `singleTask`。
+
+**iOS 排查路径**：确认预期是否合理——**iOS 当前官方不支持 VoIP 推送**，无法实现系统级来电 UI（接听/挂断按钮、锁屏/App 被杀死后自动拉起）-> 若只是 APNs 普通推送场景，检查证书是否正确上传、`iOSPushType` 是否设置为 `APNs`、是否正确调用 `TencentCloudChatPush().registerPush` -> 若业务强需要系统级来电体验，需评估自行通过原生桥接接入 CallKit + PushKit（超出官方标准方案范围，需自行实现并承担维护成本）。
+
+## 4. 标准用法
+
+1. 两端通用：安装并注册 `tencent_cloud_chat_push` 插件，登录成功后立即调用 `TencentCloudChatPush().registerPush(...)`。
+
+2. **Android**：
+   - 集成 FCM（或所需厂商）推送通道，IM 控制台消息类型选择"透传（数据）消息"。
+   - 调用 `TUICallKit.instance.enableIncomingBanner(true)` 开启来电横幅（如需横幅+按钮展示）。
+   - 请求悬浮窗权限与后台拉起权限：
+
+     ``` kotlin
+     PermissionRequester.newInstance(
+         PermissionRequester.FLOAT_PERMISSION,
+         PermissionRequester.BG_START_PERMISSION
+     ).request()
+     ```
+
+   - 在应用默认启动的主 Activity（如 SplashActivity，且**启动模式不能是 `singleTask`**）中添加：
+
+     ``` java
+     if (!isTaskRoot() && getIntent() != null
+         && getIntent().hasCategory(Intent.CATEGORY_LAUNCHER)
+         && Intent.ACTION_MAIN.equals(getIntent().getAction())) {
+         finish();
+         return;
+     }
+     ```
+
+3. **iOS**：
+   - 仅接入 APNs 普通推送：申请并上传 APNs 证书，设置 `offlinePushInfo.iOSPushType = TUICallIOSOfflinePushType.APNs`。
+   - 明确告知业务方：iOS 端**无法**通过官方标准方案实现"App 被杀死/锁屏后自动拉起系统级接听挂断按钮"的效果，只能收到通知，用户点击通知后唤醒 App 进入来电流程。
+   - 若必须要该体验，需自行原生开发 PushKit + CallKit 桥接方案（不在 TUICallKit 官方支持范围内）。
+
+4. 两端在**前台**收到来电时，均可通过监听 `onCallReceived` 事件，结合 `flutter_local_notifications` 等插件自定义展示通知样式（不依赖离线推送链路）。
+
+## 5. 结果判定
+
+- Android：App 处于后台/锁屏，收到来电后能展示横幅或全屏界面，可见接听/挂断按钮，点击后能正确拉起/唤醒 App。
+- iOS：App 处于后台，收到 APNs 通知，点击通知后 App 被唤醒并进入通话流程；**不应**期望在 App 被杀死或锁屏时出现系统级接听/挂断来电界面（当前官方能力不支持）。
+- 两端在前台收到来电，均能正常展示通话邀请 UI 或自定义通知。
+
+## 6. 常见误区
+
+- 误区 1：把 Android 和 iOS 的后台来电问题当作同一个问题排查——二者根因完全不同（Android 是权限配置问题，iOS 是官方能力边界问题），用同一套方案（如只排查权限）无法解决 iOS 问题。
+- 误区 2：认为给 iOS 设置 `iOSPushType = VoIP` 就能获得系统级来电 UI——TIMPush 当前**不支持** iOS VoIP，设置该值不会生效，只有 `APNs` 是当前受支持的合法值。
+- 误区 3：Android 只开启了推送证书配置，未开启悬浮窗权限和后台拉起权限，误以为是推送没收到，实际是收到了推送但系统权限不足导致界面拉不起来（应先看日志确认是否收到 `onCallReceived`，再排查权限）。
+
+## 7. 问题定义（检索辅助，极简）
+
+Flutter TUICallKit 应用在后台/锁屏收到来电时只有铃声、没有系统通知、没有接听挂断按钮、也不拉起 App，Android 和 iOS 分别需要哪些配置（Notification、CallKit、VoIP Push、TIMPush）。
+
+## 8. 同义问法覆盖（检索召回，极简）
+
+- Flutter TUICallKit 后台来电没有通知怎么办？
+- TUICallKit Flutter iOS 支持 VoIP 来电吗？
+- Flutter 来电横幅不显示接听挂断按钮？
+- Android 后台收到来电拉不起 App？
+
+## 9. 参考来源（可选）
+
+- Flutter 离线推送 Notification 配置：`https://cloud.tencent.com/document/product/647/106014`
+- Flutter VoIP 配置（iOS 当前不支持的官方说明）：`https://cloud.tencent.com/document/product/647/106015`
+- Android 被叫端来电显示策略与权限排查：`https://cloud.tencent.com/document/product/647/78767`

package/resource/knowledge/callkit/best-practice/flutter/ios-keep-call-alive-background.md

@@ -0,0 +1,93 @@
+---
+title: TUICallKit Flutter iOS 应用切后台/锁屏时通话音频中断（Background Modes + AVAudioSession 配置）
+product: call
+frameworks: [flutter, ios]
+scope: platform_specific
+tags: [TUICallKit, Flutter, iOS, VoIP, AVAudioSession, Background Modes, UIBackgroundModes, playAndRecord, 后台保活, CallKit, MethodChannel]
+version_range: ">=2.0.0"
+---
+
+# TUICallKit Flutter iOS 应用切后台/锁屏时通话音频中断（Background Modes + AVAudioSession 配置）
+
+## 1. 核心结论
+
+- 需要：iOS 系统会限制后台应用访问麦克风/扬声器，通话切后台或锁屏后若未正确配置，音频采集/播放会被系统中断。
+- 根因：Background Modes 未声明或 `AVAudioSession` 未手动配置为 `.playAndRecord` 类别；TUICallKit **不会自动配置** `AVAudioSession`，需要开发者在原生层自行设置。
+- 修复方向：Xcode 勾选 Background Modes 三项（与 iOS 系统版本**无关**，所有版本均需配置）+ 在通话开始前通过 Flutter `MethodChannel` 触发原生层设置 `AVAudioSession`。
+- 无需集成 CallKit：本方案不依赖 iOS `CallKit` 框架，仅通过 Background Modes + `AVAudioSession` 即可实现纯语音/视频通话的后台音频保活。
+- 澄清（避免误用）：Apple 的 `com.apple.developer.avfoundation.multitasking-camera-access` entitlement 是**画中画（PiP）场景下摄像头后台采集**的专属方案，与本问题（纯音频通话后台保活）无关，不要混用。
+
+## 2. 字段语义对照
+
+| 字段/能力 | 作用 | 说明 |
+|---|---|---|
+| `Audio, AirPlay, and Picture in Picture` | Background Modes 能力项 | 保持后台音频采集/播放能力，所有 iOS 版本均需勾选 |
+| `Voice over IP` | Background Modes 能力项 | 支持 VoIP 场景后台运行，**所有版本**均需勾选，非 iOS 18+ 专属 |
+| `Remote notifications`（可选） | Background Modes 能力项 | 用于接收离线推送，非音频保活必需 |
+| `AVAudioSession.Category.playAndRecord` | 音频会话类别 | 支持同时播放和录音，需在通话前**手动**设置，SDK 不会自动配置 |
+| `.allowBluetooth` / `.allowBluetoothA2DP` | 音频会话选项 | 支持蓝牙耳机接入及高质量蓝牙音频（A2DP） |
+| `MethodChannel` | Flutter 与原生通信桥 | `AVAudioSession` 配置必须在原生 Swift/ObjC 层完成，Flutter 侧通过其触发 |
+
+## 3. 机制/时序
+
+应用切后台/锁屏 -> iOS 系统限制后台麦克风/扬声器访问 -> 若未配置则通话音频被中断（对端听不到本端声音） -> 排查：确认 Background Modes 是否勾选 `Audio, AirPlay, and Picture in Picture` + `Voice over IP` -> 定位：确认是否在通话开始前配置了 `AVAudioSession.setCategory(.playAndRecord)` 并 `setActive(true)` -> 修复：Xcode 声明 Background Modes + 原生层配置 `AVAudioSession` + Flutter 侧 `MethodChannel` 触发 -> 复验：切后台/锁屏后通话音频持续正常，`Info.plist` 中 `UIBackgroundModes` 含 `audio`/`voip`。
+
+## 4. 标准用法
+
+1. 在 Xcode 中打开项目，选择 `Target` > `Signing & Capabilities` > `+ Capability`，搜索并添加 `Background Modes`，勾选 `Audio, AirPlay, and Picture in Picture` 与 `Voice over IP`（`Remote notifications` 可选，用于离线推送）。配置完成后 `Info.plist` 会自动写入：
+
+   ``` xml
+   <key>UIBackgroundModes</key>
+   <array>
+       <string>audio</string>
+       <string>voip</string>
+   </array>
+   ```
+
+2. 在 iOS 原生层（Swift）实现音频会话配置方法，在通话开始前（通话界面 `viewDidLoad`、发起通话 `calls` 之前、或接听 `accept` 之前）调用：
+
+   ``` swift
+   import AVFoundation
+
+   func setupAudioSessionForCall() {
+       let audioSession = AVAudioSession.sharedInstance()
+       do {
+           // .playAndRecord：同时支持播放和录音
+           // .allowBluetooth / .allowBluetoothA2DP：支持蓝牙耳机及高质量蓝牙音频
+           try audioSession.setCategory(.playAndRecord, options: [.allowBluetooth, .allowBluetoothA2DP])
+           try audioSession.setActive(true)
+       } catch {
+           // 音频会话配置失败
+       }
+   }
+   ```
+
+3. 在 Flutter 侧注册 `MethodChannel`，在通话开始（`calls`/`accept` 成功）时调用原生 `setupAudioSessionForCall()`，通话结束时可将 `AVAudioSession` 恢复或停用，避免影响其他音频场景。
+
+4. 不需要集成 iOS `CallKit` 框架即可实现上述后台音频保活；若后续需要接入系统来电 UI/锁屏接听等能力，才需要额外集成 `CallKit`（属于另一独立能力，不是后台保活的前提）。
+
+## 5. 结果判定
+
+- 应用切到后台或锁屏后，通话音频采集/播放不中断，对端持续能听到本端声音。
+- `Info.plist` 中 `UIBackgroundModes` 正确包含 `audio` 与 `voip`。
+- 未集成 `CallKit` 的情况下，纯语音/视频通话后台保活功能正常。
+
+## 6. 常见误区
+
+- 误区 1：认为 TUICallKit Flutter/iOS SDK 内置了 `AVAudioSession` 配置，无需自己设置（实际 SDK 不会自动配置，必须开发者在原生层主动调用 `setCategory`/`setActive`）。
+- 误区 2：把"通话音频后台保活"和"画中画（PiP）摄像头后台采集"混为一谈，为纯语音/视频通话去申请 `com.apple.developer.avfoundation.multitasking-camera-access` entitlement——该 entitlement 仅用于 PiP 场景下的**摄像头视频**后台采集，与音频通话保活无关，普通通话不需要申请。
+- 误区 3：误以为 `Voice over IP` 只是 iOS 18+ 才需要勾选，实际上 Background Modes 三项与 iOS 系统版本无关，所有版本（iOS 15+）均需配置一致。
+
+## 7. 问题定义（检索辅助，极简）
+
+Flutter TUICallKit 在 iOS 应用切后台/锁屏时通话音频中断，是否需要配置 Background Modes 与 AVAudioSession，是否需要集成 CallKit，与画中画方案的区别。
+
+## 8. 同义问法覆盖（检索召回，极简）
+
+- TUICallKit Flutter iOS 切后台没声音怎么办？
+- Flutter iOS 通话锁屏后音频停止？
+- 不用 CallKit 能后台保活语音通话吗？
+- AVAudioSession playAndRecord 怎么配置才能后台采集？
+
+## 9. 参考来源（可选）
+- 腾讯云 TRTC iOS 画中画文档（`multitasking-camera-access` entitlement 的真实适用场景）：`https://cloud.tencent.com/document/product/647/128652`

package/resource/knowledge/callkit/best-practice/flutter/ios-startup-crash-version-voip.md

@@ -0,0 +1,68 @@
+---
+title: TUICallKit Flutter iOS 启动闪退排查（最低系统版本、Release 符号裁剪、VoIP PushKit 适用性澄清）
+product: call
+frameworks: [flutter, ios]
+scope: platform_specific
+tags: [TUICallKit, Flutter, iOS, 闪退, crash, tencent_calls_uikit, PushKit, CallKit, VoIP, symbol not found, 最低系统版本]
+version_range: ">=2.0.0"
+---
+
+# TUICallKit Flutter iOS 启动闪退排查（最低系统版本、Release 符号裁剪、VoIP PushKit 适用性澄清）
+
+## 1. 核心结论
+
+- 最低系统版本：Flutter 插件 `tencent_calls_uikit` 官方要求 iOS **12.0** 及以上；iOS 16 在该范围内，天然兼容，无需额外适配。
+- Flutter TUICallKit **标准离线推送方案不集成 PushKit VoIP**，仅提供 APNs 普通推送（数据消息）方案；因此"收到 VoIP 推送未上报 CallKit 导致系统 Kill App"这条 iOS 13+ 规则**不适用于**未额外自定义扩展的标准集成。
+- 真实的 Flutter TUICallKit iOS 启动闪退最常见原因：**Release 构建时 Xcode 符号裁剪优化误移除 TRTC 的 C 符号**，导致 `symbol not found`，与 VoIP/PushKit/CallKit 无关。
+- 若开发者**自行额外**接入了 PushKit VoIP（超出 TUICallKit 官方标准方案范围），才需要遵守"收到 VoIP 推送后必须立即调用 `reportNewIncomingCall`/`reportNewIncomingConversation`，否则会被系统 Kill"的 Apple 强制规则，这属于自定义扩展的责任范围，不是 TUICallKit 内置行为。
+
+## 2. 字段语义对照
+
+| 字段/能力 | 作用 | 说明 |
+|---|---|---|
+| `tencent_calls_uikit` | Flutter TUICallKit 插件包名 | 官方要求 iOS 12.0+，与底层 `TXLiteAVSDK_Professional`（另一独立库，podspec 声明 iOS 8.0）是不同层级的版本要求，不可混用命名 |
+| APNs（远程推送） | Flutter TUICallKit 官方离线推送方案 | 通过 `tencent_cloud_chat_push` 插件实现，iOS 侧仅涉及 APNs 证书配置，不涉及 PushKit |
+| PushKit VoIP | iOS 原生系统级来电推送机制 | Flutter TUICallKit **官方文档未提供**该方案；仅原生 iOS（Swift/ObjC）集成文档中存在（基于 `LiveCommunicationKit`/`CallKit`） |
+| `reportNewIncomingCall`/`reportNewIncomingConversation` | 收到 VoIP 推送后的强制上报接口 | 仅在**已注册 PushKit VoIP** 的场景下才需要调用，5 秒内未上报会被系统 Kill；不适用于未集成 PushKit 的标准 Flutter 方案 |
+| Deployment Postprocessing / Strip Style | Xcode Build Settings 选项 | 用于避免 Release 构建时符号裁剪误删 TRTC FFI 相关 C 符号，是 Flutter TUICallKit 已知的真实闪退成因 |
+
+## 3. 机制/时序
+
+App 启动或收到通话相关事件 -> 闪退/无法拉起 -> 排查方向一：检查是否为 **Release 构建**且未配置符号裁剪选项 -> 若是，误删 TRTC C 符号导致 `symbol not found` -> 修复：配置 `Deployment Postprocessing = Yes` + `Strip Style = Non-Global Symbols` -> 复验：Release 包正常运行不再闪退。
+
+排查方向二（仅当项目**额外自行集成**了 PushKit VoIP 时才适用）：收到 VoIP 推送 -> 未在 5 秒内调用 `reportNewIncomingCall`/`reportNewIncomingConversation` -> 系统强制 Kill App -> 修复：在 `PKPushRegistryDelegate` 的 `didReceiveIncomingPushWith` 回调中立即上报。
+
+## 4. 标准用法
+
+1. 确认项目 `tencent_calls_uikit` 依赖版本与目标设备系统版本：iOS 12.0 及以上均受官方支持，iOS 16 无需特殊适配。
+2. 若在 iOS Release 包运行时出现 `symbol not found` 闪退，在 Xcode 的 `Build Settings` 中：
+   - 将 **Deployment Postprocessing** 设置为 **Yes**；
+   - 将 **Strip Style**（Release 配置）设置为 **Non-Global Symbols**。
+3. 若业务只需要标准的离线来电通知能力，直接按 Flutter 官方 `tencent_cloud_chat_push` 插件文档接入 **APNs** 方案即可，**不需要**也不应额外接入 PushKit VoIP（官方 Flutter 方案未提供此能力）。
+4. 若业务确有强需求要在 Flutter iOS 上实现系统级 VoIP 来电体验（如锁屏/进程杀死后仍能唤起系统来电 UI），需要开发者自行通过原生桥接（`MethodChannel` + 原生 Swift 层参考 iOS 原生 CallKit/PushKit 集成方案）自定义实现，并严格遵守"5 秒内上报"规则，避免闪退；这是自定义扩展方案，不是 TUICallKit Flutter 官方内置能力。
+
+## 5. 结果判定
+
+- iOS 16（及 12.0 以上其他版本）设备上，TUICallKit Flutter 正常启动、登录、拨打/接听通话，无系统兼容性问题。
+- Release 包运行时不出现 `symbol not found` 崩溃。
+- 未额外集成 PushKit 的标准项目，不会因为"VoIP 推送未上报"这条规则被系统 Kill（因为标准方案未注册 PushKit VoIP，不会触发该规则）。
+
+## 6. 常见误区
+
+- 误区 1：把底层库 `TXLiteAVSDK_Professional` 的版本要求与 Flutter 插件 `tencent_calls_uikit` 的版本要求混为一谈，二者是不同的依赖层级，应分别核对。
+- 误区 2：认为 Flutter TUICallKit iOS 启动闪退的最常见原因是"PushKit VoIP 未上报 CallKit"，但官方 Flutter 标准方案并未集成 PushKit VoIP，该规则对标准集成不适用；真实最常见原因是 Release 符号裁剪导致的 `symbol not found`。
+- 误区 3：误以为可以在 Flutter 侧直接调用原生 iOS 的 `CXProvider.reportNewIncomingCall` 或 `LiveCommunicationKit` API——这些是原生 Swift/ObjC API，Flutter 侧无法直接调用，必须通过原生桥接层自行实现（且 TUICallKit 官方未提供该桥接）。
+
+## 7. 问题定义（检索辅助，极简）
+
+Flutter TUICallKit iOS 启动闪退排查：最低系统版本要求、iOS 16 兼容性、以及 PushKit VoIP CallKit 上报规则是否适用于 Flutter 标准集成。
+
+## 8. 同义问法覆盖（检索召回，极简）
+
+- Flutter TUICallKit iOS 打不开/闪退怎么排查？
+- tencent_calls_uikit 支持 iOS 16 吗？
+- TUICallKit Flutter 需要接 PushKit VoIP 吗？
+- Flutter iOS Release 包 symbol not found 怎么解决？
+
+## 9. 参考来源（可选）
+- `tencent_calls_uikit` 官方最低版本要求（iOS 12.0+）：`https://pub.dev/packages/tencent_calls_uikit`

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

@@ -152,7 +152,7 @@ public class MyApplication extends TencentCloudChatPushApplication {
 
 5. 输入用户电子邮件地址（您的邮箱）、常用名称（您的名称或公司名），选择**存储到磁盘**，单击**继续**，系统将生成一个 `*.certSigningRequest` 文件。
 
-6. 返回上述 步骤3 中 Apple Developer 网站刚才的页面，单击 **Choose File** 上传生成的 `*.certSigningRequest` 文件。
+6. 返回上述 [步骤3](#step3) 中 Apple Developer 网站刚才的页面，单击 **Choose File** 上传生成的 `*.certSigningRequest` 文件。
 
 7. 单击 **Continue**，即可生成推送证书。
 

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

@@ -125,18 +125,20 @@ class ViewController: UIViewController {
    import AtomicXCore
 
    class CallViewController: UIViewController {
-       // 1.创建通话页面
+       private var callCoreView: CallCoreView?
+
        override func viewDidLoad() {
            super.viewDidLoad()
            view.backgroundColor = .black
-           //2.通话页面绑定 CallCoreView
-           callCoreView = CallCoreView(frame: view.bounds)
-           callCoreView?.autoresizingMask = [.flexibleWidth, .flexibleHeight]
-           if let callCoreView = callCoreView {
-               view.addSubview(callCoreView)
-           }
+
+           let coreView = CallCoreView(frame: view.bounds)
+           coreView.autoresizingMask = [.flexibleWidth, .flexibleHeight]
+           coreView.setLayoutTemplate(.float)
+           view.addSubview(coreView)
+           callCoreView = coreView
        }
    }
+
    ```
 
    **CallCoreView 视图组件功能说明：**

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

@@ -123,22 +123,25 @@ class ViewController: UIViewController {
 
 【iOS】
 ``` swift
+
 import UIKit
 import AtomicXCore
 
 class CallViewController: UIViewController {
-    // 1.创建通话页面
+    private var callCoreView: CallCoreView?
+
     override func viewDidLoad() {
         super.viewDidLoad()
         view.backgroundColor = .black
-        //2.通话页面绑定 CallCoreView
-        callCoreView = CallCoreView(frame: view.bounds)
-        callCoreView?.autoresizingMask = [.flexibleWidth, .flexibleHeight]
-        if let callCoreView = callCoreView {
-            view.addSubview(callCoreView)
-        }
+
+        let coreView = CallCoreView(frame: view.bounds)
+        coreView.autoresizingMask = [.flexibleWidth, .flexibleHeight]
+        coreView.setLayoutTemplate(.float)
+        view.addSubview(coreView)
+        callCoreView = coreView
     }
 }
+
 ```
 
    **CallCoreView 视图组件功能说明：**

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

@@ -1,4 +1,4 @@
-本文档将指导您如何基于 [TIMPush](https://cloud.tencent.com/document/product/269/133003) 服务实现 VoIP 推送功能，适用于使用 AtomicXCore 进行无 UI 集成的场景。
+本文档将指导您如何基于 TIMPush 服务实现 VoIP 推送功能，适用于使用 AtomicXCore 进行无 UI 集成的场景。
 
 > **注意：**
 > - 使用 **VoIP** 推送功能首先需要 开通 TIMPush 服务。

package/resource/knowledge/callkit/core-sdk/miniprogram/call-engine.md

@@ -12,40 +12,40 @@ TUICallEngine API 是音视频通话组件的**无 UI 接口**，如果 TUICallK
 
 |API|描述|
 |---------|---------|
-|createInstance|创建 TUICallEngine 实例（静态方法）|
-|destroyInstance|销毁 TUICallEngine 实例（静态方法）|
-|on|增加事件监听|
-|off|取消事件监听|
+|[createInstance](#createInstance)|创建 TUICallEngine 实例（静态方法）|
+|[destroyInstance](#destroyInstance)|销毁 TUICallEngine 实例（静态方法）|
+|[on](#on)|增加事件监听|
+|[off](#off)|取消事件监听|
 
 ### 通话操作相关接口函数
 
 |API|描述|
 |---------|---------|
-|calls|发起 1v1 通话|
-|inviteUser|在群组通话中，邀请其他人加入|
-|join|主动加入当前的群组通话中|
-|accept|接听通话|
-|reject|拒绝通话|
-|hangup|结束通话|
+|[calls](#calls)|发起 1v1 通话|
+|[inviteUser](#inviteUser)|在群组通话中，邀请其他人加入|
+|[join](#join)|主动加入当前的群组通话中|
+|[accept](#accept)|接听通话|
+|[reject](#reject)|拒绝通话|
+|[hangup](#hangup)|结束通话|
 
 ### 设备控制相关接口函数
 
 |API|描述|
 |---------|---------|
-|openCamera|开启摄像头|
-|closeCamera|关闭摄像头|
-|switchCamera|切换前后摄像头|
-|openMicrophone|打开麦克风|
-|closeMicrophone|关闭麦克风|
-|selectAudioPlaybackDevice|选择音频播放设备（听筒/扬声器）|
+|[openCamera](#openCamera)|开启摄像头|
+|[closeCamera](#closeCamera)|关闭摄像头|
+|[switchCamera](#switchCamera)|切换前后摄像头|
+|[openMicrophone](#openMicrophone)|打开麦克风|
+|[closeMicrophone](#closeMicrophone)|关闭麦克风|
+|[selectAudioPlaybackDevice](#selectAudioPlaybackDevice)|选择音频播放设备（听筒/扬声器）|
 
 ### 其他接口函数
 
 |API|描述|
 |---------|---------|
-|setSelfInfo|设置用户的头像、昵称|
-|setLogLevel|设置日志等级|
-|setBeautyLevel|设置美颜级别，支持关闭默认美颜|
+|[setSelfInfo](#setSelfInfo)|设置用户的头像、昵称|
+|[setLogLevel](#setLogLevel)|设置日志等级|
+|[setBeautyLevel](#setBeautyLevel)|设置美颜级别，支持关闭默认美颜|
 
 ## API 详情
 ``` javascript

package/resource/knowledge/callkit/core-sdk/miniprogram/call-event.md

@@ -8,22 +8,22 @@ TUICallEvent API 是音视频通话组件的事件接口。
 
 |事件名|说明|
 |---------|---------|
-|ON_CALL_RECEIVED|通话请求的事件。|
-|USER_ACCEPT|用户接听，**v4.x.x 已废弃。**|
-|USER_ENTER|用户进入通话。|
-|USER_LEAVE|用户离开通话。|
-|USER_UPDATE|用户更新。|
-|REJECT|用户拒绝通话。|
-|NO_RESP|用户无响应。|
-|LINE_BUSY|用户忙线。|
-|ON_CALL_NOT_CONNECTED|通话未建立时，通话的各端都会抛出该事件。|
-|ON_CALL_BEGIN|通话接通时抛出的事件。|
-|ON_CALL_END|通话结束。|
-|KICKED_OUT|被踢下线。|
-|ERROR|错误信息。|
-|ON_USER_NETWORK_QUALITY_CHANGED|所有用户网络质量的事件。|
-|USER_VIDEO_AVAILABLE|xxxx 用户是否有视频流的事件。|
-|USER_AUDIO_AVAILABLE|xxxx 用户是否有音频流的事件。|
+|[ON_CALL_RECEIVED](#ON_CALL_RECEIVED)|通话请求的事件。|
+|[USER_ACCEPT](#USER_ACCEPT)|用户接听，**v4.x.x 已废弃。**|
+|[USER_ENTER](#USER_ENTER)|用户进入通话。|
+|[USER_LEAVE](#USER_LEAVE)|用户离开通话。|
+|[USER_UPDATE](#USER_UPDATE)|用户更新。|
+|[REJECT](#REJECT)|用户拒绝通话。|
+|[NO_RESP](#NO_RESP)|用户无响应。|
+|[LINE_BUSY](#LINE_BUSY)|用户忙线。|
+|[ON_CALL_NOT_CONNECTED](#ON_CALL_CANCELED)|通话未建立时，通话的各端都会抛出该事件。|
+|[ON_CALL_BEGIN](#ON_CALL_BEGIN)|通话接通时抛出的事件。|
+|[ON_CALL_END](#CALL_END)|通话结束。|
+|[KICKED_OUT](#KICKED_OUT)|被踢下线。|
+|[ERROR](#ERROR)|错误信息。|
+|[ON_USER_NETWORK_QUALITY_CHANGED](#ON_USER_NETWORK_QUALITY_CHANGED)|所有用户网络质量的事件。|
+|[USER_VIDEO_AVAILABLE](#USER_VIDEO_AVAILABLE)|xxxx 用户是否有视频流的事件。|
+|[USER_AUDIO_AVAILABLE](#USER_AUDIO_AVAILABLE)|xxxx 用户是否有音频流的事件。|
 
 ## TUICallEvent 详情
 ``` javascript

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

@@ -122,27 +122,6 @@ const handleLogin = () => {
      };
    </script>
 
-   <style scoped>
-     .btn {
-       width: 60px;
-       margin: 10px 20px;
-     }
-
-     .btn-img {
-       width: 60px;
-       height: 60px;
-       border-radius: 140px;
-     }
-
-     .btn-text {
-       font-size: 12px;
-       color: #d5e0f2;
-       font-weight: 400;
-       text-align: center;
-       margin-top: 10px;
-     }
-   </style>
-
    ```
 2. **添加拒接按钮：**添加"拒接"按钮，将其点击事件分别绑定至 [reject](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#reject) 方法。
 
@@ -165,25 +144,6 @@ const handleLogin = () => {
      };
    </script>
 
-   <style scoped>
-     .btn {
-       margin: 10px 20px;
-     }
-
-     .btn-img {
-       width: 60px;
-       height: 60px;
-       border-radius: 140px;
-     }
-
-     .btn-text {
-       font-size: 12px;
-       color: #d5e0f2;
-       font-weight: 400;
-       text-align: center;
-       margin-top: 10px;
-     }
-   </style>
    ```
 3. **拨打方取消通话或您拒接时销毁界面：**无论拨打方取消呼叫，还是接收方拒接，均会触发 `onCallEnded`（通话结束）事件。建议监听此事件，以便在通话终止时及时关闭（销毁）通话界面。
 
@@ -442,12 +402,6 @@ const handleLogin = () => {
   });
 </script>
 
-<style>
-  .call-view-container {
-    background: rgba(15, 16, 20, 0.5);
-    overflow: hidden;
-  }
-</style>
 ```
 
 > **说明：**
@@ -526,12 +480,6 @@ const handleLogin = () => {
      });
    </script>
 
-   <style>
-     .call-view-container {
-       background: rgba(15, 16, 20, 0.5);
-       overflow: hidden;
-     }
-   </style>
    ```
 - `networkQualityIcons` **接口参数详细说明：**
 
@@ -665,12 +613,6 @@ const handleLogin = () => {
   });
 </script>
 
-<style>
-  .call-view-container {
-    background: rgba(15, 16, 20, 0.5);
-    overflow: hidden;
-  }
-</style>
 ```
 - `participantAvatars` **属性参数详细说明：**
 
@@ -729,12 +671,6 @@ const handleLogin = () => {
      });
    </script>
 
-   <style>
-     .call-view-container {
-       background: rgba(15, 16, 20, 0.5);
-       overflow: hidden;
-     }
-   </style>
    ```
 - `waitingAnimation` **接口参数详细说明：**
 
@@ -783,19 +719,6 @@ const handleLogin = () => {
   });
 </script>
 
-<style scoped>
-  .call-timer {
-    display: flex;
-    align-items: center;
-    justify-content: center;
-  }
-
-  .timer-text {
-    font-size: 28rpx;
-    color: #FFFFFF;
-    font-weight: 400;
-  }
-</style>
 ```
 
 ## 更多功能
@@ -884,13 +807,6 @@ const handleLogin = () => {
      });
    </script>
 
-   <style>
-     .call-view-container {
-       background: rgba(15, 16, 20, 0.5);
-       overflow: hidden;
-     }
-   </style>
-
    ```
 - `layoutTemplate` **属性参数详细说明：**