uni-app

最近更新时间:2024-06-24 14:52:31

我的收藏
体验反馈:
您在文档接入过程中是否遇到困难?接入过程是否显得过于复杂?无论是建议、疑惑还是吐槽,都欢迎在这里向我们反馈。希望各位开发者能在闲暇时花费1分钟填写 TUIKit for Uniapp 体验反馈。我们将根据您的反馈优化TUIKit,以提升您的使用体验。

TUIChat 独立集成新手接入指引视频

对于 TUIKit v2.2.0 及之后的版本,如果您是首次接入,强烈建议您参考视频指引完成 TUIChat 的独立接入。如果您已经完成了前置 TUIKit 的集成,可以跳转到 7 分 30 秒继续独立集成 TUIChat。


TUIChat 独立集成功能介绍

说明:
TUIKit v2.2.0 起请按照本文所述步骤接入。
uniapp 平台独立集成私信聊天(1V1)或者群聊(Group),例如房产中介咨询、电商在线客服、保险远程定损等。


集成指引

请按照 集成 TUIKit 的步骤进行操作,操作完成后,您需要配置 TUIChat 入口。

配置 TUIChat 入口

说明:
conversationID 规则: 单聊(`C2C${userID}`),群聊(`GROUP${groupID}`)。
如果您还没有群组,可以通过 IM 控制台或者 Chat SDK 创建一个群组:。
您需要将以下内容复制到主包的 pages/index/index.vue 文件中。
<template>
<button @click="openChat">OpenChat</button>
</template>
<script>
export default {
methods: {
openChat() {
// 1v1 chat: conversationID = `C2C${userID}`
// group chat: conversationID = `GROUP${groupID}`
const conversationID = '';
uni.navigateTo({
url: `/TUIKit/components/TUIChat/index?conversationID=${conversationID}`
});
}
}
}
</script>

更多高级特性(强烈推荐)

TIMPush 推送插件

说明:
TUIKit 中默认没有集成 TencentCloud-TIMPush 推送插件。TencentCloud-TIMPush 是腾讯云即时通信 IM Push 插件。目前推送支持小米、华为、荣耀、OPPO、vivo、魅族、APNs、一加、realme、iQOO 和 苹果等厂商通道。
如果您需要在 App 中集成离线推送能力,请参见 uni-app 推送 实现。




音视频通话 TUICallKit 插件

说明:
TUIKit 中默认没有集成 TUICallKit 音视频组件,TUICallKit 主要负责语音、视频通话。
如果您需要集成通话功能,可参考以下文档实现。
打包到 App 请参见: 音视频通话(客户端)
打包到小程序请参见:音视频通话(小程序)
打包到 H5 请参见:音视频通话(H5)

客服插件

根据 uniapp客服集成指引 集成并设置客服号后,将客服 userID 组合成客户会话的 conversationID 。


云端审核

在消息发送、资料修改场景中,很有可能会扩散不合适的内容,特别是与敏感事件/人物相关、黄色不良内容等令人反感的内容,不仅严重损害了用户们的身心健康,更很有可能违法并导致业务被监管部门查封。
即时通信 IM 支持云端审核(反垃圾信息)功能,可针对不安全、不适宜的内容进行自动识别、处理,为您的产品体验和业务安全保驾护航。
云端审核:在服务端检测由单聊、群聊、资料场景中产生的文本、图片、音频、视频内容,支持针对不同场景的不同内容分别配置审核策略,并对识别出的不安全内容进行拦截。此功能已提供默认预设拦截词库和审核场景,只需在 IM 控制台打开功能开关,即可直接使用。

常见问题

1. 我想集成完整的TUIKit,例如联系人、会话、群组管理等,应该在哪里集成?
完整集成TUIKit,请参见 集成 TUIKit
2. 小程序如果需要上线或者部署正式环境怎么办?
请在 微信公众平台 > 开发 > 开发管理 > 开发设置 > 服务器域名 中进行域名配置,域名配置方法请参见: 小程序 socket 合法域名
3. 独立集成场景下,如何清除会话未读数?
答:在执行“步骤2 > 集成 TUIKit 组件 > 小程序分包首页”这一步时,TUIChat 在 onLoad 事件里调用了 TUIConversationService.switchConversation() 方法,该方法会主动清除当前会话的未读数,因此不需要手动清除会话未读数。
4. 更多问题请参见 uni-app 相关问题

参考文档

TUIKit (vue2/vue3)相关:
ChatEngine 相关:

技术咨询

点此进入 IM 社群,享有专业工程师的支持,解决您的难题。