一、uni-app 集成 TUICallKit 如何做离线唤醒?
建议你结合 TUIPush 插件 实现离线唤醒。
二、应用在后台时,不能自动将通话界面拉取到前台?
详情请参见:(Android)应用在后台时,收到通话不能到前台。
三、支持云端打包、本地打包,以及离线打包三种方式
TUICallKit 插件支持以下三种打包方式,前两种在 HBuilderX 开发工具中,适用于前端开发人员;离线打包适用于原生开发人员。
方式一:云端打包,(推荐采用该方式打包,方便后续升级)。
方式二:本地打包。下载插件到本地,在 HBuilderX 工程中创建 nativeplugins 目录,将下载的插件放到该目录下;点击 manifest.json 文件,点击 APP 原生插件配置,选择本地插件。
方式三:离线打包。Android 离线打包 uniapp 页面文档较分散,可按照下述步骤进行:
·按照页面文档 Android 离线打包,集成 Android 工程,直接使用 uniapp 页面提供的方式二,跑通页面 demo,减少踩坑。其中“配置工程”的第三步“资源配置”很重要,一定要仔细按照文档完成。
·从页面下载 TUICallKit 插件,拷贝 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 服务的用户会提示:
[-100013]:TRTC service is suspended. Please check if the package balance is 0 or the Tencent Cloud accountis in arrears
因为新的 IM 音视频通话能力是整合了腾讯云实时音视频 TRTC 和 即时通信 IM 两个基础的 PaaS 服务,所以当 实时音视频 TRTC 的免费额度(10000分钟)已经过期或者耗尽,就会导致开通此项服务失败,这里你可以单击 TRTC 控制台,找到对应 SDKAppID 的应用管理页,示例如图,开通付费功能后,再次启用应用即可正常体验音视频通话能力。
五、SDKAppID、sercretKey 参数说明
·SDKAppID:在 步骤一:开通 TRTC 服务 中的最后一步中你已经获取到,这里不再赘述。
·userID:当前用户的 ID,字符串类型,只允许包含英文字母(a-z 和 A-Z)、数字(0-9)、连词符(-)和下划线(_)。
·userSig:使用 步骤一:开通 TRTC 服务 中获取的 SecretKey 对 SDKAppID、userID 等信息进行加密,就可以得到 userSig,它是一个鉴权用的票据,用于腾讯云识别当前用户是否能够使用 TRTC 的服务。你可以通过控制台中的 辅助工具 生成一个临时可用的 userSig。
·更多信息请参见 如何计算及使用 userSig。
六、自定义调试基座注意事项
·什么是自定义基座:参见 uni-app 页面自定义基座说明。
·自定义基座不是正式版,真正发布时,需要再打正式包。使用自定义基座是无法正常升级替换 APK 的。
·请尽量不要使用本地插件,插件包超过自定义基座的限制,可能导致调试收费。
·使用自定义基座打包 uni 原生插件 (请使用真机运行自定义基座)
·使用 uni 原生插件必须先提交云端打包才能生效,购买插件后在应用的 manifest.json 页面的 App原生插件配置 项下单击选择云端插件,选择腾讯云原生音视频插件。
·直接云端打包后无法打 log,无法排查问题,需要自定义基座调试原生插件。
七、如何创建群组通话的 groupID
群组的创建详见: IM 群组管理 ,或者你也可以直接使用 IM TUIKit,一站式集成聊天、通话等场景。
八、虚拟背景设置失效
请升级 HbuilderX 版本 ≥ 3.94。
九、和 livepusher 推流模块同时使用,打包冲突?
结论:
目前两者无法同时使用。
原因:
uni-app 页面文档介绍 第三方 SDK 使用 LiteAVSDK(weex_livepusher-release.aar)做直播推流,和 uniapp TUICallKit 使用的 LiteAVSDK_TRTC 类冲突。和 uni-app 技术沟通后,对方反馈不清楚 SDK 属于哪个版本类型,因此 uni-app 他们无法对 livepusher 进行升级。
解决方案: