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

package/resource/knowledge/callkit/faq/android.md

@@ -0,0 +1,168 @@
+### TUICallKit 是否可以不引入 IM SDK，只使用 TRTC？
+
+**不可以**，TUIKit 全系组件都使用了腾讯云 IM SDK 作为通信的基础服务，例如通话拨打信令、通话忙线信令等核心逻辑，如果您已经购买有其他 IM 产品，也可以参照 TUICallKit 逻辑进行适配。
+
+### 错误提示“The package you purchased does not support this ability”？
+
+如遇以上错误提示，是由于您当前应用的音视频通话能力包过期或未开通，请参见 开通服务，领取或者开通音视频通话能力，进而继续使用 TUICallKit 组件。
+
+### 如何购买音视频通话套餐？
+
+请参考购买链接 [音视频通话 SDK 价格总览](https://cloud.tencent.com/document/product/1640/79968)，如有其他问题，请点击页面右侧，进行售前套餐咨询；或者加入 QQ 群：**605115878**，进行咨询和反馈。
+
+### TUICallKit 崩溃，崩溃日志："No implementation found for xxxx"？
+
+堆栈信息如下：
+``` java
+java.lang.UnsatisfiedLinkError: No implementation found for void com.tencent.liteav.base.Log.nativeWriteLogToNative(int, java.lang.String, java.lang.String) (tried Java_com_tencent_liteav_base_Log_nativeWriteLogToNative and Java_com_tencent_liteav_base_Log_nativeWriteLogToNative__ILjava_lang_String_2Ljava_lang_String_2)
+       at com.tencent.liteav.base.Log.nativeWriteLogToNative(Native Method)
+       at com.tencent.liteav.base.Log.i(SourceFile:177)
+       at com.tencent.liteav.basic.log.TXCLog.i(SourceFile:36)
+       at com.tencent.liteav.trtccalling.model.impl.base.TRTCLogger.i(TRTCLogger.java:15)
+       at com.tencent.liteav.trtccalling.model.impl.ServiceInitializer.init(ServiceInitializer.java:36)
+       at com.tencent.liteav.trtccalling.model.impl.ServiceInitializer.onCreate(ServiceInitializer.java:101)
+       at android.content.ContentProvider.attachInfo(ContentProvider.java:2097)
+       at android.content.ContentProvider.attachInfo(ContentProvider.java:2070)
+       at android.app.ActivityThread.installProvider(ActivityThread.java:8168)
+       at android.app.ActivityThread.installContentProviders(ActivityThread.java:7709)
+       at android.app.ActivityThread.handleBindApplication(ActivityThread.java:7573)
+       at android.app.ActivityThread.access$2600(ActivityThread.java:260)
+       at android.app.ActivityThread$H.handleMessage(ActivityThread.java:2435)
+       at android.os.Handler.dispatchMessage(Handler.java:110)
+       at android.os.Looper.loop(Looper.java:219)
+       at android.app.ActivityThread.main(ActivityThread.java:8668)
+       at java.lang.reflect.Method.invoke(Native Method)
+       at com.android.internal.os.RuntimeInit$MethodAndArgsCaller.run(RuntimeInit.java:513)
+       at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:1109)
+```
+
+> **注意：**
+>
+
+> 上述异常，是因为 TUICallKit 依赖的 TRTC 等 SDK 部分接口使用了 JNI 实现，Android Studio 在某些条件下进行编译 APK 的时候可能并不会把 Native 的 .so 库打包进去，导致出现这类报错，重新 Clean 一下工程，卸载重装即可。
+>
+
+### allowBackup 异常？
+- **报错信息**：`Manifest merger failed : Attribute application@allowBackup value=(true) from AndroidManifest.xml`
+
+- **问题原因**：TUICallKit 依赖的 IM SDK 中默认 allowBackup 的值为 false ，表示关闭应用的备份和恢复功能。
+
+- **解决方法**：您可以在您工程的 `AndroidManifest.xml` 文件中删除 allowBackup 属性或将该属性改为 false，表示关闭备份和恢复功能；也可以在 `AndroidManifest.xml` 文件的 application 节点中添加 `tools:replace="android:allowBackup";` 表示覆盖 IM SDK 的设置，使用您自己的设置。
+
+### TUICallKit 是否支持离线推送呢？
+
+**支持**，Android 离线推送采用腾讯云的**TIMPush推送插件**以及**自集成推送**，接入方式详见：离线唤醒。
+
+### 在通话邀请超时时间内，被邀请者如果离线再上线，能否弹出通话界面？
+
+单人通话时，如果在超时时间内上线，会触发来电邀请；群组通话，如果在超时时间内上线，会拉起未处理的20条群消息，如果存在通话邀请，则触发来电邀请。在不同的版本上来电的显示策略有所不同（详见下方：被叫端来电显示策略）。
+
+### 应用在后台时，不能自动将通话界面拉取到前台
+1. TUICallKit 2.3 及以上版本（[Android&iOS 发布日志](https://cloud.tencent.com/document/product/647/80931)）调整了被叫端的来电显示策略，见下方：被叫端来电显示策略。
+
+2. TUICallKit 2.3 版本之前，将应用从后台自动拉取到前台，需要检查 App 是否开启了“后台自启动”或“悬浮窗”权限。
+
+   不同厂商、甚至同一厂商不同 Android 版本，其对于应用开放的权限以及权限名称也会存在不一致。例如，小米6只需要开启后台弹出界面权限，而红米需要同时打开后台弹出界面和显示悬浮窗权限。如何开启权限，详见下方：相关权限开启。
+
+3. 如果遇到以下场景拉不起通话界面，原因是：应用的启动堆栈变化，导致 CallKitActivity 界面被遮挡或移除了。
+
+   场景一：接通后退到后台，点击桌面图标进入应用，原通话界面消失；
+
+   场景二：应用在后台时，开启banner的情况下，收到通知View，不点击View，点击桌面图标进入应用，拉不起通话界面且通知消失；
+
+   场景三：应用在后台时，收到离线推送，不点击推送通知，点击桌面图标进入应用，无法拉起通话界面或通话界面闪了一下；
+
+   以上几种情况，需要在您自己业务的默认启动的主 Activity 中添加以下代码，每个应用默认启动的 Activity 都不一样，详见 AndroidManifest.xml 配置，以目前大部分应用的启动页 SplashActivity 为例：
+
+【添加代码】
+``` java
+if (!isTaskRoot() && getIntent() != null && getIntent().hasCategory(Intent.CATEGORY_LAUNCHER)
+        && Intent.ACTION_MAIN.equals(getIntent().getAction())) {
+    finish();
+    return;
+}
+```
+
+【具体添加位置】
+
+   > **说明：**
+   >
+
+   > SplashActivity 的启动模式不能是 singleTask；singleTask 模式下 isTaskRoot 是 true，上述方法不生效。
+   >
+
+   >
+
+### 被叫端来电显示策略
+
+为使 TUICallKit 适应不同的业务需求，增加产品特色，提升用户的使用体验，TUICallKit **2.3 及以上版本**（[发布日志](https://cloud.tencent.com/document/product/647/80931)），优化收到来电后的通话页面显示和弹出策略，详情如下所示：
+
+|全屏显示通话等待界面|横幅显示来电请求|
+|---------|---------|
+|||
+
+【2.3.0.920版本及之后的版本】
+1. 如果您想要被叫端收到邀请时，尽量拉起全屏通话界面，那么您可以更新 [tuicallkit-kt](https://github.com/Tencent-RTC/TUICallKit/tree/main/Android/tuicallkit-kt) 代码到最新。该情况下，被叫端的来电显示策略如下：
+
+2. 如果您想在被叫端收到通话的时候，先展示一个横幅，然后根据需要拉起全屏通话界面，那么您可以调用以下接口开启该功能。
+
+``` java
+  TUICallKit.createInstance(context).enableIncomingBanner(true);
+```
+
+开启后，被叫端的来电策略如下所示，只要开启**悬浮窗权限，**就能尽可能地展示来电横幅。
+
+【2.3版本之前】
+
+> **说明：**
+>
+
+> 相关权限如何开启，详见下方：相关权限开启。
+>
+
+### **相关权限开启**
+
+为实现良好的通话体验，建议您在应用中开启“通知”权限、“显示在其他应用上层（悬浮窗）”以及“后台拉起界面”权限，具体方法如下：
+
+【代码指引】
+- **通知权限**：便于展示推送通知：请参见 [通知运行时权限](https://developer.android.com/develop/ui/views/notifications/notification-permission) 和 [请求运行时权限](https://developer.android.com/training/permissions/requesting#request-permission) 根据业务需求自行实现。
+
+- **悬浮窗权限**：用于展示自定义的来电横幅，以及通话悬浮窗。
+
+- **后台拉起界面权限**：用于当应用在后台时拉起界面（例如：vivo手机）。
+
+``` java
+fun requestPermission(context: Context?) {
+    //In TUICallKit,Please open both OverlayWindows and Background pop-ups permission.
+    PermissionRequester.newInstance(
+         PermissionRequester.FLOAT_PERMISSION, PermissionRequester.BG_START_PERMISSION)
+        .request()
+}
+```
+
+【手动开启】
+
+安装应用后，您可以长按应用图标，选择“应用信息”，然后开启“通知”权限、“显示在其他应用上层”以及“后台拉起界面”权限。或者您可以到`手机 > 系统设置 > 应用管理 > 应用`中手动开启上述权限。
+
+|Pixel 4a|小米|vivo|
+|---------|---------|---------|
+||||
+
+### Java 版本导致 Gradle 无法同步
+- **报错信息：**Your build is currently configured to use incompatible Java 21.0.5 and Gradle 8.0. Cannot sync the project.
+
+- **问题原因：**TUICallKit 工程需要的 Java 版本是 17，Android Studio 默认 Java 版本是 21，导致 Gradle 无法同步。
+
+- **解决方法：**将Android Studio 的 Java 版本改为 17。
+
+1. 打开 Android Studio 设置。
+
+  - Windows：**File** > **Settings**
+
+  - Mac：**Android Studio **> **Preferences**
+
+2. 修改 Java 编译器设置。
+
+  - 路径：**Build, Execution, Deployment** > **Build Tools** > **Gradle**
+
+  - 将 Gradle JVM 改为 17（如果已安装）或 Use project JDK

package/resource/knowledge/callkit/faq/common.md

@@ -0,0 +1,180 @@
+> **说明：**
+>
+
+> 如果并没有解决您的问题，也欢迎您加入我们的 TUICallKit 技术交流 QQ 群： **605115878 **来进行交流讨论。
+>
+
+### 音视频通话功能出现了未开通的错误提示？
+
+您可以选择体验版（7 天试用）或者购买正式版。
+
+##### **对于体验版**
+
+进入 [即时通信 IM 控制台](https://console.cloud.tencent.com/im) 的配置页面，并在页面的右下角找到开通腾讯实时音视频服务功能区，单击**免费体验**，选择**领取7天试用，**即可开通 TUICallKit 的 7 天免费试用服务，成为体验版。
+
+##### **对于正式版**
+
+如果您体验过 7 天体验期后，需要购买正式套餐。IM 音视频通话能力针对不同的业务需求提供了差异化的付费版本供您选择，您可以在 [IM 购买页](https://buy.cloud.tencent.com/avc) 了解包含功能并选购您适合的版本。
+
+### 在 TUIChat + TUICallKit 融合场景下，升级 TUICallKit 版本后出现新版本呼叫旧版本，旧版本无法收到通话问题？
+
+TUICallKit 3.1 版本起，在 TUIChat + TUICallKit 融合场景下，通过 TUIChat 中的通话按钮发起通话默认使用 calls 新接口，所以如果您的业务已经上线，您可以通过高级接口将通话接口切换为 call、groupCall，用来保持与线上版本的用户互通。
+
+您需要在登录成功后调用一次高级接口，各个平台的具体使用为：
+
+【iOS(Swift)】
+``` swift
+let jsonParams: [String: Any] = ["api": "forceUseV2API",
+                                 "params": ["enable": true,],]
+guard let data = try? JSONSerialization.data(withJSONObject: jsonParams, options: JSONSerialization.WritingOptions(rawValue: 0)) else { return }
+guard let paramsString = NSString(data: data, encoding: String.Encoding.utf8.rawValue) as? String else { return }
+
+TUICallKit.createInstance().callExperimentalAPI(jsonStr: paramsString)
+```
+
+【iOS(Objective-C)】
+``` cpp
+NSDictionary *jsonParams = @{@"api": @"forceUseV2API",
+                             @"params": @{@"enable": @YES}};
+NSError *error = nil;
+NSData *data = [NSJSONSerialization dataWithJSONObject:jsonParams options:0 error:&error];
+if (error || !data) { return; }
+NSString *paramsString = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
+if (!paramsString) { return;}
+[[TUICallKit createInstance] callExperimentalAPIWithJsonStr:paramsString];
+
+```
+
+【Android(java)】
+``` java
+ try {
+    JSONObject params = new JSONObject();
+    params.put("enable", true);
+    JSONObject jsonObject = new JSONObject();
+    jsonObject.put("api", "forceUseV2API");
+    jsonObject.put("params", params);
+    TUICallKit.createInstance(context).callExperimentalAPI(jsonObject.toString());
+} catch (Exception e) {
+    e.printStackTrace();
+}
+
+```
+
+【Android(kotlin)】
+``` java
+try {
+    val params = JSONObject()
+    params.put("enable", true)
+
+    val jsonObject = JSONObject()
+    jsonObject.put("api", "forceUseV2API")
+    jsonObject.put("params", params)
+    TUICallKit.createInstance(context).callExperimentalAPI(jsonObject.toString())
+} catch (e: Exception) {
+    e.printStackTrace()
+}
+
+```
+
+【Flutter(Dart)】
+``` java
+final jsonParams = {'api': 'forceUseV2API',
+                 'params': {'enable': true} };
+
+try {
+    final jsonString = json.encode(jsonParams);
+    TUICallKit.instance.callExperimentalAPI(jsonStr: jsonString);
+} catch (e) {
+    return;
+}
+```
+
+【Web&小程序】
+``` javascript
+const jsonObject = {
+    api: "forceUseV2API",
+    params: {
+      enable: true,
+    }
+};
+TUICallKitServer.getTUICallEngineInstance().callExperimentalAPI(JSON.stringfy(jsonObject));
+
+```
+
+### TUICalling 如何升级到 TUICallKit？
+
+TUICallKit 是腾讯云推出一款新的音视频通话 UI 组件，**是 TUICalling 的升级版本**，支持群组通话、AI 降噪等更多功能特性、支持全平台间互通呼叫，功能更加稳定。 从 TUICalling 升级到 TUICallKit 您可以参考：
+- 微信小程序升级方案
+
+- Web 升级方案
+
+- Android 升级方案
+
+- iOS 升级方案
+
+- uni-app (客户端) 升级方案
+
+- Flutter 升级方案
+
+- uni-app (小程序) 升级方案
+
+### 报错 inviteID 无效或邀请已处理
+
+该 inviteID 已经被主叫方取消，或者该邀请已经被接受。由于信令发送受网络带宽等诸多因素影响，在极端情况下(accept 与 reject 接口重复调用)可能会导致 inviteID 无效的错误。
+
+### 消息发送方或接收方 UserID 无效或不存在
+
+您呼叫的用户还没有登录过 TIM，导致呼叫失败，请尝试呼叫已经登录成功过的用户。
+
+### TUICallKit 是否可以不引入 IM SDK，只使用 TRTC？
+
+**不可以**，TUIKit 全系组件都使用了腾讯云 IM SDK 作为通信的基础服务，比如通话拨打信令、通话忙线信令等核心逻辑，如果您已经购买有其他 IM 产品，也可以参照 TUICallKit 逻辑进行适配。
+
+### 如何购买音视频通话套餐？
+
+请参考购买链接 [音视频通话 SDK 价格总览](https://cloud.tencent.com/document/product/1640/79968)，如有其他问题，请点击页面右侧，进行售前套餐咨询；或者加入 QQ 群：**605115878**，进行咨询和反馈。
+
+### **如何获取通话的房间号 Roomid？**
+
+通话接通后，您可以通过 onCallBegin 返回 roomid 字段进行获取。
+
+### 查询用户在线状态
+
+TUICallKit 底层通过 IM 管理用户，可以通过 IM 查询用户的在线状态，方式有以下两种：
+- **方式一：**通过 getUserStatus 高级接口查询
+
+   详情可参考：查询用户状态（[Android&iOS&Windows&Mac](https://cloud.tencent.com/document/product/269/75511#.E6.9F.A5.E8.AF.A2.E7.94.A8.E6.88.B7.E7.8A.B6.E6.80.81)、[web&小程序&uniapp](https://cloud.tencent.com/document/product/269/78125#.E6.9F.A5.E8.AF.A2.E7.94.A8.E6.88.B7.E7.8A.B6.E6.80.81)），您可以调用不同平台的接口去查询。
+
+   > **注意：**
+   >
+>   - 查询其他用户状态需要升级 TUICallKit 套餐包到**群组通话版本**。
+>   - 查询其他用户状态需要提前在 [即时通信 IM 控制台](https://console.cloud.tencent.com/im) 开启 “用户状态查询及状态变更通知”。不开启，调用`getUserStatus`会报错。
+
+   >
+   >
+
+   getUserStatus接口的返回结果有以下几种：
+
+  - 未知（UNKNOWN）
+
+  - 在线（ONLINE）：当前用户已登录上线，通常情况下，该用户可以正常收到通话请求。
+
+  - 离线（OFFLINE）：用户未主动调用`logout`退出登录，但长连接中断的状态。通常情况下，若接入了离线推送，该用户可以收到离线推送的消息。
+
+  - 未登录（UNLOGINED）：用户注册账号后从未登录过，或者用户主动调用`logout`退出登录，该用户收不到通话请求。
+
+- **方式二：**通过 REST API 进行查询
+
+   详情可参考：[查询账号在线状态](https://cloud.tencent.com/document/product/269/2566)。
+
+### **音视频通话信令里各字段常见问题？**
+
+|**问题**|**说明**|
+|---------|---------|
+|如何判断 “发起通话”|actionType = 1 且 cmd = 'videoCall' 或 'audioCall'|
+|如何判断 “已接听”|actionType = 3 |
+|如何判断 “通话已结束”，“通话时长是多少”|actionType = 1 且 cmd = 'hangup'，通话时长取 call_end 字段，单位：秒|
+|如何判断 “取消通话”|actionType = 2|
+|如何判断 “拒绝通话”|actionType = 4|
+|如何判断对端忙线产生的 “拒绝通话”|actionType = 4 且 cmd = "line_busy"|
+|如何被叫判断 “超时未接听”|actionType = 5|

package/resource/knowledge/callkit/faq/flutter.md

@@ -0,0 +1,52 @@
+### 同时集成 tencent_calls_uikit 和 tencent_trtc_cloud，或同时集成 tencent_calls_uikit 和 live_flutter_plugin，出现符号冲突报错，怎么解决？
+
+问题详情：当引入 flutter ''tencent_calls_uikit'' 进我们现有的 project 后，Android 构建 APK 时出现如下报错：
+``` bash
+Duplicate class com.tencent.liteav.LiveSettingJni found in modules jetified-LiteAVSDK_Professional-10.7.0.13053-runtime
+(com.tencent.liteav:LiteAVSDK_Professional:10.7.0.13053) and jetified-LiteAVSDK_TRTC-10.3.0.11225-runtime
+(com.tencent.liteav:LiteAVSDK_TRTC:10.3.0.11225)
+```
+
+iOS 在执行`pod install`出现如下报错：
+``` plaintext
+[!] The 'Pods-Runner' target has frameworks with conflicting names: txsoundtouch.xcframework and txffmpeg.xcframework.
+```
+
+这个问题原因是您使用的 tencent_calls_uikit 和 tencent_trtc_cloud 分别依赖于 TRTC Android SDK 的专业版和精简版，这个问题我们已经在最新的版本中解决，只需要您将 [tencent_calls_uikit](https://pub.dev/packages/tencent_calls_uikit) 和 [tencent_trtc_cloud](https://pub.dev/packages/tencent_trtc_cloud)升级到最新版本即可。
+
+### Flutter Android未添加混淆设置，怎么设置？
+
+如果您需要编译运行在 Android 平台，由于我们在 SDK 内部使用了Java 的反射特性，需要将 SDK 中的部分类加入不混淆名单，因此需要您在 proguard-rules.pro 文件中添加如下代码：
+``` html
+-keep class com.tencent.** { *; }
+```
+
+### 从1.8.0以下的版本升级到1.8.0及以上的版本，导致编译报错或者拉不起页面问题如何修复？
+
+如果是从1.8.0以下升级到1.8.0及以上的版本，需要您检查下面几个步骤是否正常：
+1. 将 navigatorObservers 添加到 MateriaApp。 目的是在收到呼叫邀请时导航到 TUICallKit 页面。示例代码如下：
+
+   ``` plaintext
+   import 'package:tencent_calls_uikit/tuicall_kit.dart';
+
+   MaterialApp（
+        navigatorObservers：[TUICallKit.navigatorObserver]，
+        ...
+   ）
+   ```
+2. tencent_calls_engine 插件中的导入文件统一替换为新的。
+
+   ``` plaintext
+   import 'package:tencent_calls_engine/tuicall_engine.dart';
+   import 'package:tencent_calls_engine/tuicall_observer.dart';
+   import 'package:tencent_calls_engine/tuicall_define.dart';
+   ```
+
+   上图内容替换为下图所示：
+
+   ``` plaintext
+   import 'package:tencent_calls_engine/tencent_calls_engine.dart';
+   ```
+3. 登录 API 调整更规范，不需要再指定参数。
+
+4. 离线推送参数构造优化。

package/resource/knowledge/callkit/faq/ios.md

@@ -0,0 +1,116 @@
+### 错误提示“The package you purchased does not support this ability”？
+
+如遇以上错误提示，是由于您当前应用的音视频通话能力包过期或未开通，请参见 开通服务，领取或者开通音视频通话能力，进而继续使用TUICallKit组件。
+
+### 如何购买音视频通话套餐？
+
+请参见购买链接 [开通正式版](https://cloud.tencent.com/document/product/647/104662#formal)，如有其他问题，请点击页面右侧，进行售前套餐咨询；也可以加入我们的 TUICallKit 技术交流平台 [zhiliao](https://zhiliao.qq.com/s/cWSPGIIM62CC/cEUPGIIM62CE)，进行咨询和反馈。
+
+### 如何修改 TUICallKit 源码？
+
+使用 `CocoaPods` 导入组件，具体步骤如下：
+1. 在您的工程 `Podfile` 文件同一级目录下创建 `TUICallKit` 文件夹。
+
+2. 单击进入 [Github/TUICallKit](https://github.com/tencentyun/TUICalling) ，选择克隆/下载代码，然后将 [iOS](https://github.com/tencentyun/TUICalling/tree/main/iOS) 目录下的 [TUICallKit_Swift](https://github.com/Tencent-RTC/TUICallKit/tree/main/iOS/TUICallKit_Swift) 文件夹和 [TUICallKit_Swift.podspec](https://github.com/Tencent-RTC/TUICallKit/blob/main/iOS/TUICallKit_Swift.podspec) 文件拷贝到您在 `步骤1` 创建的 `TUICallKit` 文件夹下。
+
+3. 在您的 `Podfile` 文件中添加以下依赖。
+
+   ``` bash
+   # :path => "指向 TUICallKit_Swift.podspec 的相对路径"
+   pod 'TUICallKit_Swift', :path => "TUICallKit/TUICallKit_Swift.podspec"
+   ```
+4. 执行 `pod install` 命令，完成导入。
+
+   > **注意：**
+   >
+
+   > `TUICallKit_Swift`文件夹和`TUICallKit_Swift.podspec`文件必须在同一目录下。
+   >
+
+   **TUICallKit_Swift 组件集成后效果**：
+
+   > **说明：**
+   >
+
+   > TUICallKit_Swift 组件集成后支持文件夹分层显示，方便您阅读和修改源代码。
+   >
+
+### Xcode 15 编译报错？
+
+#### 1、出现 **Sandbox: rsync **编译报错
+
+可以在 **Build Settings **中把 **User Script Sandboxing **设置为 **NO：**
+
+#### 2、出现 **SDK does not contain **编译报错
+
+可以在 Podfile 添加如下代码：
+``` bash
+# target 'xxxx' do
+#  ...
+#  pod 'TUICallKit_Swift'
+# end
+
+post_install do |installer|
+  installer.pods_project.targets.each do |target|
+    target.build_configurations.each do |config|
+      config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '13.0'
+    end
+  end
+end
+```
+
+#### 3、如果在 **M 系列电脑**上运行模拟器，可能会出现 **Linker command failed with exit code 1 (use -v to see invocation) **编译报错
+
+可以在 Podfile 添加如下代码：
+``` bash
+# target 'xxxx' do
+#  ...
+#  pod 'TUICallKit_Swift'
+# end
+
+post_install do |installer|
+  installer.pods_project.targets.each do |target|
+    target.build_configurations.each do |config|
+      config.build_settings['EXCLUDED_ARCHS[sdk=iphonesimulator*]'] = "arm64"
+    end
+  end
+end
+```
+
+### TUICallKit 和自己集成的音视频库冲突了？
+
+腾讯云的 `音视频库` 不能同时集成，可能存在符号冲突，可以按照下面的场景处理。
+1. 如果您使用了 `TXLiteAVSDK_TRTC` 库，不会发生符号冲突。可直接在 `Podfile` 文件中添加依赖，
+
+   ``` bash
+   pod 'TUICallKit_Swift'
+   ```
+2. 如果您使用了 `TXLiteAVSDK_Professional` 库，会产生符号冲突。您可在 `Podfile` 文件中添加依赖，
+
+   ``` bash
+   pod 'TUICallKit_Swift/Professional'
+   ```
+3. 如果您使用了 `TXLiteAVSDK_Enterprise` 库，会产生符号冲突。建议升级到 `TXLiteAVSDK_Professional` 后使用 TUICallKit_Swift`/Professional`。
+
+### TUICallKit 是否可以不引入 IM SDK，只使用 TRTC？
+
+**不可以。**`TUIKit` 全系组件都使用了腾讯云 IM SDK 作为通信的基础服务，比如通话拨打信令、通话忙线信令等核心逻辑，如果您已经购买有其他 `IM` 产品，也可以参照 `TUICallKit` 逻辑进行适配。
+
+### TUICallKit 组件支持自定义铃声吗？
+
+**支持**，调用 [setCallingBell](https://cloud.tencent.com/document/product/647/78753#setCallingBell) 即可。
+
+### TUICallKit 是否支持后台运行？
+
+**支持**，如需要进入后台仍然运行相关功能，可选中当前工程项目，在 **Capabilities** 下的 **Background Modes** 模块中勾选 **Audio，AirPlay and Picture in Picture** ，如下图所示：
+
+### 如何查看 TRTC 日志？
+
+TRTC 的日志默认压缩加密，后缀为 .xlog。日志是否加密是可以通过 setLogCompressEnabled 来控制，生成的文件名里面含 C(compressed) 的就是加密压缩的，含 R(raw) 的就是明文的。
+
+iOS：`sandbox的Documents/log`
+
+> **说明：**
+>
+> - 查看 .xlog 文件需要下载 [解密工具](https://dldir1.qq.com/hudongzhibo/log_tool/decode_mars_log_file.py)，在 Python 2.7环境中放到 xlog 文件同目录下直接使用 `python decode_mars_log_file.py` 运行即可。
+> - 查看 .clog 文件（9.6 版本以后新的日志格式）需要下载 [解密工具](http://dldir1.qq.com/hudongzhibo/log_tool/decompress_clog.py)，在 Python 2.7 环境中放到 clog 文件同目录下直接使用 `python decompress_clog.py `运行即可。

package/resource/knowledge/callkit/faq/uniapp-app.md

@@ -0,0 +1,89 @@
+### uni-app 集成 TUICallKit 如何做离线唤醒？
+
+建议您结合 [TUIPush 插件](https://cloud.tencent.com/document/product/647/105867) 实现离线唤醒。
+
+### 应用在后台时，不能自动将通话界面拉取到前台？
+
+详情请参见：（Android）应用在后台时，收到通话不能到前台。
+
+### 支持云端打包、本地打包，以及离线打包三种方式
+
+[TUICallKit](https://ext.dcloud.net.cn/plugin) 插件支持以下三种打包方式，前两种在 HBuilderX 开发工具中，适用于前端开发人员；离线打包适用于原生开发人员。
+
+方式一：云端打包，（**推荐**采用该方式打包，方便后续升级）。
+
+方式二：本地打包。下载插件到本地，在 HBuilderX 工程中创建 **nativeplugins** 目录，将下载的插件放到该目录下；点击 **manifest.json** 文件，点击 APP 原生插件配置，选择本地插件。
+
+方式三：离线打包。Android 离线打包 uniapp 官网文档较分散，可按照下述步骤进行：
+- 按照官网文档 [Android 离线打包](https://nativesupport.dcloud.net.cn/AppDocs/usesdk/android.html)，集成 Android 工程，直接使用 uniapp 官网提供的方式二，跑通官网 demo，减少踩坑。其中“配置工程”的第三步“**资源配置**”很重要，一定要仔细按照文档完成。
+
+- 从官网下载 [TUICallKit](https://ext.dcloud.net.cn/plugin) 插件，拷贝 TUICallKit-release.aar 放到 AndroidStudio工程的 **libs** 目录下。
+
+- 在 app/build.gradle 文件中增加依赖（下载的插件的 package.json 文件有依赖项）。
+
+- 在 **dcloud_uniplugins.json **文件中添加 module 的引入。
+
+- 检查 js 上层引用了 TUICallKit 插件，并有相关的调用。完成这些步骤，插件已引入，可以直接打包生成 apk。
+
+   |拷贝插件到 **libs** 目录下|在 app/build.gradle 中增加依赖|在 **dcloud_uniplugins.json **文件中添加 module 的引入|上层调用|
+   |---------|---------|---------|---------|
+   |||||
+
+### 提示“[-100013]:TRTC service is  suspended...”？
+
+单击**免费体验**以后，部分之前使用过 [实时音视频 TRTC](https://cloud.tencent.com/document/product/647/16788) 服务的用户会提示：
+``` bash
+[-100013]:TRTC service is  suspended. Please check if the package balance is 0 or the Tencent Cloud accountis in arrears
+```
+
+因为新的 IM 音视频通话能力是整合了腾讯云[实时音视频 TRTC](https://cloud.tencent.com/document/product/647/16788) 和 [即时通信 IM](https://cloud.tencent.com/document/product/269/42440) 两个基础的 PaaS 服务，所以当 [实时音视频 TRTC](https://cloud.tencent.com/document/product/647/16788) 的免费额度（10000分钟）已经过期或者耗尽，就会导致开通此项服务失败，这里您可以单击 [TRTC 控制台](https://console.cloud.tencent.com/trtc/app)，找到对应 SDKAppID 的应用管理页，示例如图，开通付费功能后，再次**启用应用**即可正常体验音视频通话能力。
+
+#### SDKAppID、sercretKey 参数说明
+- **SDKAppID**：在 步骤一：开通 TRTC 服务 中的最后一步中您已经获取到，这里不再赘述。
+
+- **userID**：当前用户的 ID，字符串类型，只允许包含英文字母（a-z 和 A-Z）、数字（0-9）、连词符（-）和下划线（_）。
+
+- **userSig**：使用 步骤一：开通 TRTC 服务 中获取的 SecretKey 对 SDKAppID、userID 等信息进行加密，就可以得到 userSig，它是一个鉴权用的票据，用于腾讯云识别当前用户是否能够使用 TRTC 的服务。您可以通过控制台中的 [**辅助工具**](https://console.cloud.tencent.com/im/tool-usersig) 生成一个临时可用的 userSig。
+
+- 更多信息请参见 [如何计算及使用 userSig](https://cloud.tencent.com/document/product/647/17275)。
+
+   > **注意**
+   >
+>   - **这个步骤也是目前我们收到的开发者反馈最多的步骤，常见问题如下**：
+>   - SDKAppID 设置错误，国内站的 SDKAppID 一般是以140开头的10位整数。
+>   - userSig 被错配成了加密密钥（Secretkey），userSig 是用 SecretKey 把 SDKAppID、userID 以及过期时间等信息加密得来的，而不是直接把 Secretkey 配置成 userSig。
+>   - userID 被设置成“1”、“123”、“111”等简单字符串，由于 **TRTC 不支持同一个 UserID 多端登录**，所以在多人协作开发时，形如 “1”、“123”、“111” 这样的 userID 很容易被您的同事占用，导致登录失败，因此我们建议您在调试的时候设置一些辨识度高的 userID。
+>   - Github 中的示例代码使用了 genTestUserSig 函数在本地计算 userSig 是为了更快地让您跑通当前的接入流程，但该方案会将您的 SecretKey 暴露在 App 的代码当中，这并不利于您后续升级和保护您的 SecretKey，所以我们强烈建议您将 userSig 的计算逻辑放在服务端进行，并由 App 在每次使用 TUICallKit 组件时向您的服务器请求实时计算出的 userSig。
+
+#### 自定义调试基座注意事项
+- 什么是自定义基座：[参见 uni-app 官网自定义基座说明](https://uniapp.dcloud.net.cn/tutorial/run/run-app.html#customplayground)。
+
+- 自定义基座不是正式版，真正发布时，需要再打正式包。使用自定义基座是无法正常升级替换 APK 的。
+
+- 请尽量不要使用本地插件，插件包超过自定义基座的限制，可能导致调试收费。
+
+- 使用自定义基座打包 uni 原生插件 （**请使用真机运行自定义基座**）
+
+- 使用 uni 原生插件必须先提交云端打包才能生效，购买插件后在应用的 `manifest.json` 页面的 **App原生插件配置** 项下单击**选择云端插件**，选择**腾讯云原生音视频插件**。
+
+- 直接云端打包后无法打 log，无法排查问题，需要自定义基座调试原生插件。
+
+#### 如何创建群组通话的 groupID
+
+群组的创建详见：[ IM 群组管理](https://cloud.tencent.com/document/product/269/75395#.E5.88.9B.E5.BB.BA.E7.BE.A4.E7.BB.84) ，或者您也可以直接使用 [IM TUIKit](https://cloud.tencent.com/document/product/269/64507)，一站式集成聊天、通话等场景。
+
+#### 虚拟背景设置失效
+
+请升级 HbuilderX 版本 ≥ 3.94。
+
+### 和 [livepusher](https://nativesupport.dcloud.net.cn/AppDocs/usemodule/androidModuleConfig/android_Library) 推流模块同时使用，打包冲突？
+
+**结论：**
+
+目前两者无法同时使用。
+
+**原因：**
+
+[uni-app 官网文档介绍](https://nativesupport.dcloud.net.cn/AppDocs/usemodule/androidModuleConfig/android_Library) 第三方 SDK 使用 LiteAVSDK（weex_livepusher-release.aar）做直播推流，和 uniapp TUICallKit 使用的 LiteAVSDK_TRTC 类冲突。和 uni-app 技术沟通后，对方反馈不清楚 SDK 属于哪个版本类型，因此 uni-app 他们无法对 livepusher 进行升级。
+
+**解决方案：**