更新记录
1.0.2(2023-02-17) 下载此版本
- 优化应用体验
- 优化SDK连接效率
1.0.1(2022-12-03) 下载此版本
初始发布
- 支持进入客户聊天页面
- 支持基本消息类型收发
- 支持客户留言功能
平台兼容性
Android | Android CPU类型 | iOS |
---|---|---|
适用版本区间:5.0 - 12.0 | armeabi-v7a:未测试,arm64-v8a:未测试,x86:未测试 | 适用版本区间:11 - 15 |
原生插件通用使用流程:
- 购买插件,选择该插件绑定的项目。
- 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
- 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
- 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
- 开发完毕后正式云打包
付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios
注意事项:使用HBuilderX2.7.14以下版本,如果同一插件且同一appid下购买并绑定了多个包名,提交云打包界面提示包名绑定不一致时,需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择
开通服务
简介
欢迎使用“智慧服务平台”的在线客服移动端开发者工具套件(plugin)。本文针对uniapp端使用做详细说明,通过引入本插件,可以在您的APP中快速集成访客端在线聊天的功能,以具备文本、图片、视频等类型消息收发。
开通账户
详情咨询 https://www.ti-net.com.cn/
环境准备
- 建议使用最新的 HBuilderX 编辑器 。
- iOS 9.0 或以上版本且支持音视频的 iOS 设备,暂不支持模拟器。
- Android 版本不低于 5.0 且支持音视频的 Android 设备,暂不支持模拟器。建议使用 Android 5.0 (SDK API Level 21)及以上版本。
下载插件
云端依赖插件
-
购买 uni-app 原生插件 登录 uni 原生插件市场,并访问 AICC-TOSClientKit 插件,在插件详情页中购买(免费插件也可以在插件市场0元购)。购买后才能够云端打包使用插件。购买插件时请选择正确的 appid,以及绑定正确包名。
-
使用自定义基座打包 uni 原生插件 (请使用真机运行自定义基座) 使用 uni 原生插件必须先提交云端打包才能生效,购买插件后在应用的 manifest.json 页面的 App原生插件配置 项下单击选择云端插件,选择(AICC在线客服插件)。
下载离线插件包
- 下载 uni-app 原生插件 登录 uni 原生插件市场,并访问 AICC-TOSClientKit 插件,在插件详情页中点击下载,将插件压缩包下载至本地。
- 将原生插件配置到uni-app项目的“nativeplugins”下,还需要在manifest.json文件的“App原生插件配置”项下点击“选择本地插件”,在列表中选择需要打包生效的插件。
引入并使用插件
在 vue 页面中引入原生插件
使用 uni.requireNativePlugin 的 API 在 vue 页面中引入原生插件,参数为插件的 ID。如下:
uni.requireNativePlugin("AICC-TOSClientKit");
使用插件
初始化
参数说明
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
accessId | String | 是 | 访问标识 |
accessSecret | String | 是 | 访问秘钥 |
enterpriseId | String | 是 | 企业号 |
apiUrl | String | 是 | 平台apiUrl |
onlineUrl | String | 是 | 平台onlineUrl |
debug | boolean | 否 | 是否开启debug模式 |
advanceParams | Map<String, Object> | 否 | 自定义可配参数,可为空 |
代码示例如下:
tOSClientKit.initPlugin({
'accessId': '',//会话接入id
'accessSecret': '',//会话接入Secret
'enterpriseId': ,//企业id
'apiUrl': '',//aip地址
'onlineUrl': '',//在线地址
'debug': true,//是否开启debug模式
'advanceParams':{}//高级配置参数
},
(ret) => {
if (ret.code == 0) {
// 成功
} else {
//失败
}
})
进入在线客服会话页面
参数说明
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
visitorId | String | 否 | 用户App的userID(为空的情况下,系统默认为UUID去除-号,不可包含中文或特殊符号,建议使用用户系统ID方便APP拓展功能) |
nickname | String | 否 | 昵称 |
headUrl | String | 否 | 头像地址 |
mobile | String | 否 | 手机号 |
advanceParams | Map<String, Object> | 否 | 自定义可配参数 |
代码示例如下:
tOSClientKit.enterSession({
'nickname': 'uniapp体验用户名',//用户昵称
'headUrl': 'https://img2.baidu.com/it/u=1229468480,2938819374&fm=253&fmt=auto&app=120&f=JPEG?w=500&h=500',//用户头像
'mobile': '135xxxx9206'//手机号
},
(ret) => {
if (ret.code == 0) {
// 成功
} else {
//失败
}
})