Skip to content

移动应用 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参数说明

accessIdaccessSecret都是在点控云智能客服管理平台生成的,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类型)backIconUIImage(named: "back_arrow")
返回图标颜色backIconColor#000000
是否使用录音功能 true表示使用 false表示不使用isUseVoicetrue
是否使用发送图片的功能 true表示使用 false表示不使用isUseSendPhototrue
是否使用拍照的功能 true表示使用 false表示不使用isUseTakePhototrue
是否使用上传文件功能 true表示使用 false表示不使用isUseSendFiletrue
是否使用发送位置功能 true表示使用 false表示不使用isUseSendLocationtrue
是否使用表情 true表示使用 false表示不使用isUseSendEmojitrue
否使用展示出更多功能选项 true表示使用 false表示不使用isShowMoreFunctiontrue
设置是否需要小视频的功能 true表示使用 false表示不使用isUseTakeVideotrue
上传图片是否使用原图还是缩略图isUseImageOriginal1原图 2压缩
设置客户的头像地址customerAvatarUrl
设置客户名称customerName

使用示例:

javascript
DKChatConfig().shared.setNavigationBarColor("#000000") //设置标题栏颜色