即时通信 IM uni-app(客户端)(常见问题)

这篇针对uni-app集成TUICallKit的常见问题给出解决方案:离线唤醒需结合TUIPush插件实现;支持云端、本地和离线三种打包方式;TRTC服务暂停因免费额度耗尽,需开通付费功能后重新启用应用。 打包方式:推荐云端打包,离线打包需按步骤拷贝aar、配置依赖和插件引入。 TRTC暂停:免费额度过期导致,需在TRTC控制台开通付费并启用应用。 参数注意:SDKAppID为140开头整型,userSig需服务端计。

相关产品
即时通信 IM 产品页,含版本规格、价格与购买入口。

一、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 进行升级。

解决方案:

赞 (0)
上一篇 4天前
下一篇 4天前