IM即时通信全平台利器———— uniapp-tuikit
uniapp 在线客服场景
提供了示例客服群➕示例好友的基础模版,在线客服场景支持文本消息、语音消息、视频消息、群会话(支持创建、添加等操作)。
快速跑通 uniapp
步骤1:将 uniapp 工程文件,导入自己的HBuilderX 工程(版本3.2.11.20211021-alpha)
参考 uniapp 开发: https://uniapp.dcloud.io/quickstart-hx
步骤2:配置 uniapp 工程文件,填入您的应用信息
- 找到并打开
debug/GenerateTestUserSig.js
文件。 - 设置
GenerateTestUserSig.js
文件中的相关参数:
- SDKAPPID:默认为0,请设置为实际的 SDKAppID。
- SECRETKEY:默认为空字符串,请设置为实际的密钥信息。

!
- 本文提到的生成 UserSig 的方案是在客户端代码中配置 SECRETKEY,该方法中 SECRETKEY 很容易被反编译逆向破解,一旦您的密钥泄露,攻击者就可以盗用您的腾讯云流量,因此该方法仅适合本地跑通 uniapp 和功能调试。
- 正确的 UserSig 签发方式是将 UserSig 的计算代码集成到您的服务端,并提供面向 App 的接口,在需要 UserSig 时由您的 App 向业务服务器发起请求获取动态 UserSig。更多详情请参见 服务端生成 UserSig。
步骤3:编译运行
参考uniapp 开发 https://uniapp.dcloud.io/quickstart-hx?id=%e8%bf%90%e8%a1%8cuni-app
uniapp 支持平台
- 微信小程序
- 安卓
- iOS
常见问题
1. uniapp 支持安卓,IOS,微信小程序平台,im sdk 如何选择
请选择 tim-wx-sdk ,npm 安装或者静态进入
npm install tim-wx-sdk --save
import TIM from 'tim-wx-sdk';
uni.$TUIKit = TIM.create({
SDKAppID: xxx
});
!
1、请将im sdk 升级到2.15.0,该版本修复了ios 语音播放的兼容性问题
2. 上传图片cos插件怎么注册
请使用 cos-wx-sdk-v5
npm install cos-wx-sdk-v5 --save
import COS from "cos-wx-sdk-v5";
uni.$TUIKit.registerPlugin({
'cos-wx-sdk': COS
});
!
1、使用cos-js-sdk-v5会白屏报错,原因是js版的用到了window属性,在执行match匹配时报错了
2、tim-upload-plugin 暂不支持uniapp,可能会出现图片上传出错问题
3. uniapp 打包ios语音消息无法播放
请将im sdk 升级到2.15.0,该版本修复了ios 语音消息无法播放的兼容性问题
4. uniapp 打包app 发送语音消息时间显示错误
uniapp 打包app,recorderManager.onStop 回调中没有 duration 和 fileSize,所以需要用户自己补充
duration 需要本地计算
文件大小 = (音频码率) x 时间长度(单位:秒) / 8,粗略估算
详细代码请参考 uniapp-tuikit
!
语音消息对象中必须包括duration和fileSize,如果没有fileSize,语音消息时长是一串错误的数字
文档:
- SDK API 手册:https://web.sdk.qcloud.com/im/doc/zh-cn/SDK.html
- SDK 更新日志:https://cloud.tencent.com/document/product/269/38492
微信小程序域名添加: 不添加会报错
request合法域名
https://events.in.qcloud.com
https://web.sdk.qcloud.com
socket合法域名
wss://wss.im.qcloud.com
wss://wss.tim.qq.com