PDF《V5 智能客服 Android 客户端 SDK 接口》

4 址,同时也支持第三方推送平台,需要按照本文档规定填写您的 device_token 和绑 定的用户 ID. 4. 下载 SDK 您可以到 V5KF 官网下载智能客服 SDK,包含了开发包和带 UI 界面的 Demo 示例工 程. 5. 环境要求 在您集成智能客服 SDK 前环境要求如下: ? Android SDK Build-tools 请升级到

21 及以上版本. ? JAVA 编译版本 JDK 1.7 及以上版本. ? 编译 Demo 需要 Android Support V7

21 及以上版本(需导入支持包 android-support-v7-appcompat). Android SDK 最低支持 Android API 9: Android 2.3(Gingerbread). 4.2 配置 AndroidManifest 可以参考 Demo 工程的 AndroidManifest.xml 文件来配置您的 AndroidManifest,无论是 使用 SDK 的接口开发还是直接使用 Demo 工程的 UI 快速集成都需要对您的项目的 AndroidManifest.xml 文件进行下述配置,具体配置项目如下: 1. 配置站点信息 2. 添加必需的权限 若使用腾讯地图模块,还需添加: V5 智能客服系统 Android 客户端 SDK 接口 深圳市智客网络科技有限公司 www.v5kf.com

5 3. 配置使用自定义的 Application 在Application 的onCreate 中需要进行 SDK 的初始化,故需要自定义自己的 Application 类,并在 AndroidManifest.xml 中进行下面配置: 4. 添加必需的服务和 Activity 5. 会话 Activity 及intent-filter 配置 注意上面的配置中 action 的值为 com.v5kf.android.intent.notification + 您的站点编号,用于响应通知栏消息点击以打开会话界面. 4.3 了解离线消息推送 客户离线后消息将推送到您指定的推送服务器或者第三方平台,需要在 V5 官网后台做 对应配置,选择对应推送平台并配置,否则离线后接收不到消息: 1. 您自己的推送服务器: 应用配置须填写:推送服务器接口地址,V5 系统将 POST 离线消息到您的服务器接口. APP 代码中需设置:V5ClientConfig.getInstance().setDeviceToken( 识别您的推送终端的唯 一ID ). 2. 第三方推送平台: 1) 信鸽推送: 应用配置须填写:ACCESS ID 和SECRET KEY V5 智能客服系统 Android 客户端 SDK 接口 深圳市智客网络科技有限公司 www.v5kf.com

7 APP 代码中需设置:V5ClientConfig.getInstance().setDeviceToken( 信鸽 SDK 中获取到的 token ). 2) 百度云推送: 应用配置须填写:API KEY 和SECRET KEY APP 代码中需设置: V5ClientConfig.getInstance().setDeviceToken( 百度云 SDK 中获取到的 channel_id ). 3) 其他平台待补充. 注:从第三方推送平台接收到消息会附带有自定义参数 v5_action : new_message (键 值对) ,在对应的推送 SDK 接口中获取,以识别此消息来自 V5 智能客服.

5 使用 SDK 提供的 UI 快速集成 5.1 导入文件 ? 将SDK 压缩包中的 res 文件夹复制到你项目的对应 res 文件夹下;

? 根据是否使用带腾讯地图模块的开发包,进行下面二选一操作: 1. 使用腾讯地图模块: 1) 将SDK 压缩包内的 V5KF_1.x.x_rxxxx.jar 复制到你的项目的 libs 文件夹下;

2) 将SDK 压缩包中的 libs 文件夹下,腾讯地图的 SDK 包导入你项目的对应的 libs 文件夹下;

3) 在复制过的 res 目录下的 values 文件夹内的 v5_arrays.xml 打开,确保包含如下 内容: 常见问题 相关问题 图片 拍照 人工客服 位置 v5_icon_ques v5_icon_relative_ques v5_icon_photo v5_icon_camera V5 智能客服系统 Android 客户端 SDK 接口 深圳市智客网络科技有限公司 www.v5kf.com

8 v5_icon_worker v5_icon_location 2. 不使用腾讯地图模块: 1) 将SDK 压缩包内的 V5KF_noMap_1.x.x_rxxxx.jar 复制到你的项目的 libs 文件夹下;