Appearance
移动应用 SDK for iOS ##主要类:
1、DKChatKit (IMSDK主要类)
2、DKChatConfig ( IMSDK自定义参数类)
目录 (Table of Contents)
[TOC]
导入SDK
手动导入SDK
通过官网下载对应平台的SDK,并将SDK导入到项目中
使用SDK
1.1初始化SDK
javascript
DKChatKit.shared.initialize(accessId: accessId, accessSecret: secret, userId: userId) { success, errorMessage in
if success{
QMUITips.show(withText: "初始化成功")
}else{
QMUITips.show(withText: "初始化失败")
}
}1.2参数说明
accessId 和 accessSecret都是在点控云智能客服管理平台生成的,userId 用来标识客户,可传入用户在数据库中的ID。 具体路径:智能客服管理平台 => 在线客服设置 => 渠道接入设置 => app接入 => 绑定App
1.3 返回结果
success 是 bool 类型,true 代表成功, false 代表失败, errorMessage 失败的错误信息
1.4展示聊天界面
javascript
DKChatKit.shared.showChatViewController(from: controller)在需要展示对话界面调用showChatViewController方法,并传入当前控制器。
1.5 自定义参数
| 功能说明 | SDK字段名 | 默认值 |
|---|---|---|
| 标题栏TitleBar的背景色,通过颜色设置 | navigationBarColor | #1E75FE |
| 标题栏TitleBar,座席姓名颜色 | navigationBarTitleColor | #FFFFFF |
| IM界面,座席文字颜色 | customerTextColor | #333333 |
| IM界面,访客文字颜色 | agentTextColor | #333333 |
| IM界面,左侧客服昵称文字的字体颜色 | agentNameColor | #999999 |
| IM界面,时间文字的字体颜色 | #000000 | #000000 |
| IM界面,提示语文字颜色(系统消息) | tipsColor | #999999 |
| 返回箭头图标资源(UIImage类型) | backIcon | UIImage(named: "back_arrow") |
| 返回图标颜色 | backIconColor | #000000 |
| 是否使用录音功能 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().shared.setNavigationBarColor("#000000") //设置标题栏颜色