IM-SDK和客服SDK并存开发指南—iOS篇

一、SDK 介绍
  1. hg3399.com|官方网站客服访客端SDK 基于 IM SDK 3.x , 如果同时使用客服访客端SDK和IM ?SDK,只需要在初始化、登录、登出操作时使用客服访客端 SDK 提供的相应 API ,IM 的其他API 均不受影响。
  2. UI 部分集成需要分别导入HelpDeskUI 和 EaseUI(也可以自定义UI)。

?下面详细介绍IM 和 客服共存的开发步骤。
二、注意事项
  1. 开发过程中 初始化、登录和登出,务必使用客服访客端SDK 的API。
  2. IM SDK 和客服SDK 都包括了模拟器的CPU 架构,在上传到app store时需要剔除模拟器的CPU 架构,保留armv7、arm64。

?
三、资源准备
  1. 到hg3399.com|官方网站官网下载客服访客端的开源的商城Demo源码 + SDK,下载链接:http://www.easemob.com/download/cs ?选择“iOS客服访客端SDK”下载(如下图)。
    01.jpg
  2. 到hg3399.com|官方网站官网下载IM的开源的Demo源码 + SDK ,下载链接:http://www.easemob.com/download/im 选择iOS SDK(如下图)。 ?
    02.png

四、资源简介
  1. 只有访客端客服SDK包含视频通话功能,IM SDK不包含
  2. 从官网下载的客服访客端SDK包括以下目录: kefu-ios-demo、HelpDeskFramework、BaseFramework,HelpDeskUI文件在kefu-ios-demo—>CustomerSystem-ios中分别表示:
  3. - helpdeskdemo-ios 为包含实时音视频的Demo,可直接运行。
  4. - HelpDeskFramework 为客服访客端SDK,HelpDesk.framework包含实时音视频、HelpDeskLite.framework不包含实时音视频。
  5. - HelpDeskUI 为hg3399.com|官方网站用户提供的单聊UI,可在集成的时候视情况使用。
  6. - BaseFramework 为客服SDK依赖库(IM SDK)


下载的IM SDK+Demo,包含五个文件夹,并且和客服SDK 中都有 IM 的framework文件,为了保持版本的匹配,我们只使用其中的 EaseUI 而不使用IM SDK中 的framework文件。

五、集成步骤
  1. 参考客服访客端SDK文档集成客服的访客端SDK,文档地址:http://docs.easemob.com/cs/300visitoraccess/iossdk
  2. 将IM SDK 中的EaseUI 导入到工程中,需要在导入访客端客服SDK的地方导入#import "EaseUI.h" ? [重要提示:IM 的初始化、登录、登出操作需要使用客服的相关API]
  3. 在pch文件中引入

 #ifdef __OBJC__
//包含实时音视频功能
#import
//若不包含实时音视频,则替换为
#import

#import "HelpDeskUI.h"
#import "EaseUI.h"
#endif

? ?4. 然后将EaseUI或者HelpDeskUI中的 FixFopen.c文件删除(重复冲突)。
? ?5. 由于HelpDeskUI 和 EaseUI 中使用了 第三方库,如果工程中出现三方重复的问题,可将HelpDeskUI 和 EaseUI ?中的重复文件删除,如果部分接口已经升级或弃用可自行升级、调整。
?
六、工程设置
  1. 在General -> Embedded Binaries 中导入HelpDesk.framework和Hyphenate.framework(这是包含实时音视频的,如果不包含实时音视频则导入HelpDeskLite.framework和HyphenateLite.framework)。
  2. 在Build Settings -> Linking -> Other Linker Flags 中增加 -ObjC项,注意区分大小写。
  3. 客服 访客端SDK暂不支持bitcode,所以需要将Build Settings -> Build Options -> Enable Bitcode 设为NO。
  4. 为了减少不必要的警告,可将Build Settings -> Documentation Comments 设为 NO。


提供的兼容Demo介绍:
  1. Demo是在客服的商城Demo上修改,在左上角添加了一个聊天室的按钮,点击按钮会根据appkey随机创建一个账号并登录,登录成功后会进入聊天室列表界面,点击某个聊天室可以在聊天室中聊天。
  2. Demo中客服部分功能还是和原商城Demo功能一致。
  3. Demo中为了演示因此采用随机注册账号的方式,对于用户场景中,可以先注册好这些账号和自己的账号绑定,这样每次咨询客服就都是同一个人了,也可以显示这个访客曾经的聊天记录。

?
Demo源码地址:下载链接:https://pan.baidu.com/s/1IC3YT ... q.c2c
?

3 个评论

我真的不明白为什么两个都是3.0.0版本的EMOptions竟然是不一样的
iOS兼容版的demo地址已经失效,哪里还能下载?
iOS兼容版的demo地址已经失效,哪里还能下载?

要回复文章请先登录注册

知识价值的认可,源自您的赞赏

扫描二维码,你的支付将由imGeek代收后转给对方

×