更新记录

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

原生插件通用使用流程:

  1. 购买插件,选择该插件绑定的项目。
  2. 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
  3. 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
  4. 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
  5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
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)及以上版本。

下载插件

云端依赖插件

  1. 购买 uni-app 原生插件 登录 uni 原生插件市场,并访问 AICC-TOSClientKit 插件,在插件详情页中购买(免费插件也可以在插件市场0元购)。购买后才能够云端打包使用插件。购买插件时请选择正确的 appid,以及绑定正确包名。

  2. 使用自定义基座打包 uni 原生插件 (请使用真机运行自定义基座) 使用 uni 原生插件必须先提交云端打包才能生效,购买插件后在应用的 manifest.json 页面的 App原生插件配置 项下单击选择云端插件,选择(AICC在线客服插件)。

下载离线插件包

  1. 下载 uni-app 原生插件 登录 uni 原生插件市场,并访问 AICC-TOSClientKit 插件,在插件详情页中点击下载,将插件压缩包下载至本地。
  2. 将原生插件配置到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 {
                            //失败
                        }
                    })

隐私、权限声明

1. 本插件需要申请的系统权限列表:

涉及的个人信息类型:相册权限,相机权限,麦克风权限,存储读写权限 - 使用目的: 相册权限:帮助用户在应用内发送相册中的图片和视频消息 相机权限:帮助用户在应用内拍摄和录制图片和视频 麦克风权限:帮助用户在应用内录制视频,录制语音 存储读写权限:帮助用户在应用内发送手机中的文本、语音、图片、视频、文件类型的消息 - 使用场景: 相册权限:用户在应用内发送相册中的图片和视频消息时 相机权限:用户在应用内拍摄和录制图片和视频时 麦克风权限:用户在应用内录制视频消息或语音消息时,可以开启麦克风权限进行录音 存储读写权限:用户在应用内发送手机中的文本、语音、图片、视频、文件类型的消息,以及用户将文件下载至本地等可以通过开启存储权限使用或保存图片、视频或文件

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件 客服聊天 功能使用了“AICC 智慧服务原生 SDK”,参考其官方文档:https://develop.clink.cn/develop/mobile/chat-mobile.html

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

作者未提供license.md

暂无用户评论。

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问