Appearance
移动应用 SDK for Android ##主要类:
1、DKChatKit (IMSDK主要类)
2、DKChatConfig ( IMSDK自定义参数类)
目录 (Table of Contents)
[TOC]
导入SDK
手动导入SDK
通过官网下载对应平台的SDK,并将SDK导入到项目中
使用SDK
1.1初始化SDK
javascript
DKChatKit.getInstance().initialize( accessId,accessSecret, userId, baiduKey, new InitializeCallback() {
@Override
public void onSuccess() {
Log.d("TAG", "onSuccess: ");
@Override
public void onFailure(String error, int code) {
Log.d("TAG", "onSuccess: ");
}
});1.2参数说明
accessId 和 accessSecret都是在点控云智能客服管理平台生成的,userId 用来标识客户,可传入用户在数据库中的ID,baidukey是用于使用发送位置功能调用百度地图所需的key,需要使用者在百度后台注册,再传入SDK中。 具体路径:智能客服管理平台 => 在线客服设置 => 渠道接入设置 => app接入 => 绑定App
1.3 返回结果
onSuccess 代表成功, onFailure 代表失败, error 失败的错误信息
1.4展示聊天界面
javascript
DKChatKit.getInstance().showIMActivity(MainActivity.this);在需要展示对话界面调用showIMActivity方法,并传入当前控制器。
1.5 自定义参数
| 功能说明 | SDK字段名 | 默认值 |
|---|---|---|
| 标题栏TitleBar的背景色,通过颜色设置 | navigationBarColor | #1E75FE |
| 标题栏TitleBar,座席姓名颜色 | navigationBarTitleColor | #FFFFFF |
| IM界面,座席文字颜色 | customerTextColor | #333333 |
| IM界面,访客文字颜色 | agentTextColor | #333333 |
| IM界面,左侧客服昵称文字的字体颜色 | agentNameColor | #999999 |
| IM界面,时间文字的字体颜色 | timeColor | #000000 |
| IM界面,提示语文字颜色(系统消息) | tipsColor | #999999 |
| 返回箭头图标资源(Drawable类型) | backIcon | |
| 返回图标颜色 | backIconColor | #FFFFFF |
| 是否使用录音功能 true表示使用 false表示不使用 | isUseVoice | true |
| 是否使用发送图片的功能 true表示使用 false表示不使用 | isUseSendPhoto | true |
| 是否使用拍照的功能 true表示使用 false表示不使用 | isUseTakePhoto | true |
| 是否使用上传文件功能 true表示使用 false表示不使用 | isUseSendFile | true |
| 是否使用发送位置功能 true表示使用 false表示不使用 | isUseSendLocation | true |
| 是否使用表情 true表示使用 false表示不使用 | isUseSendEmoji | true |
| 是否使用展示出更多功能选项 true表示使用 false表示不使用 | isShowMoreFunction | true |
| 设置是否需要小视频的功能 true表示使用 false表示不使用 | isUseTakeVideo | true |
| 上传图片是否使用原图 还是缩略图 | isUseImageOriginal | 1原图 2压缩 |
| 设置客户的头像地址 | customerAvatarUrl | |
| 设置客户名称 | customerName |
使用示例:
javascript
DKChatConfig.getInstance().setNavigationBarColor("#000000")//设置标题栏颜色