注册

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

  
   环信作为国内领先的企业级软件服务提供商,产品包括国内上线最早规模最大的即时通讯云平台——环信即时通讯云,以及国内领先的全媒体智能云客服平台——环信移动客服。区别于环信即时通讯云SDK(IM SDK),环信移动客服也专门提供了访客端SDK。很多小伙伴在环信开发过程中,同时使用了环信即时通讯云和环信移动客服服务,就会有这样的疑问,这个时候应该使用哪个SDK 呢?这两个有什么区别?于是让开发者惊呼“还有这种操作”的《IM-SDK和客服-SDK并存开发指南》应运而生,希望能帮助小伙伴们更快速、高效集成环信。嗯,就是有这种操作,不服就来尬舞啊!!!
 一、SDK介绍
  1. 访客端客服SDK基于IM-SDK 3.x开发,包含了IM-SDK所有的API和功能,当同时使用IM和客服时,只需要在初始化、登录、登出操作时使用访客端客服 SDK 提供的相应API即可。
  2. UI部分集成需要分别导入Kefu-easeui和EaseUI(IM的EaseUI),也可以自己写UI部分。


二、注意事项
  1. 开发过程中 初始化、登录、登出,务必使用客服SDK的API。
  2. IM-SDK和客服SDK都包含了armeabi、armeabi-v7、arm64-v8a、x86的CPU架构,在发版的时候,可以选择部分CPU,例如剔除模拟器用的x86架构,在build.gradle中配置即可。

 
三、资源准备
  1. 到环信官网下载访客端客服SDK+Demo源码,下载链接:http://www.easemob.com/download/cs选择“Android客服访客端”下载(如下图)。 

    001.jpg

  2. 到环信官网下载IM的SDK+Demo源码,下载链接:http://www.easemob.com/download/im 选择Android SDK(如下图)。  

    002.jpg



四、资源简介
  1. 解压后的SDK压缩包中,含有基础版和实时音视频版,根据需求的不同使用不同的SDK。默认EaseUI使用的是libs文件夹内的SDK,此SDK含有实时音视频功能,因此比较大,如果不需要使用实时音视频功能的,可以使用libs.without.audio文件夹下的SDK。
  2. 从官网下载的客服访客端SDK包括以下目录: 



003.png


其中:kefu-android-demo为包含实时音视频的商城demo,可以直接运行。
 libs 为客服访客端SDK,包含实时音视频功能。
libs.without.audio 为不包含实时音视频功能的客服访客端SDK。
 
五、集成步骤
  1. 参考客服访客端文档或demo源码集成客服的访客端SDK,文档地址:http://docs.easemob.com/cs/300visitoraccess/androidsdk 。
  2. 可以把Kefu-Easeui作为一个module,libs放入客服的SDK(kefu-sdk_*.jar和相关so),import IM的easeUI到项目中,去掉里面的hyphenate_*.jar以及相关so。注释掉EaseUI.java中的IMSDK的初始化方法,最终结果为:app项目依赖IM-easeui module,IM-easeui 依赖kefu-easeui module。
  3. 在自己项目中的Application中的onCreate方法中,先调用客服SDK的初始化方法,再调动IM-easeui和Kefu-easeui的初始化方法(如果不用IM或客服的EaseUI则不需要对EaseUI做初始化)。
  4. 在app项目中,调用登录、登出方法需要调动客服的API,其他的API为各自的API。在调用EaseUI相关的Activity时,如为IM-easeui的Activity需要在AndroidManifest.xml中注册,kefu-easeui则不需要再注册(因为在kefu-easeui这个module中的AndroidManifest.xml中已注册)。Demo和EaseUI的源码是开源的,也可查看下。

 
六、注意事项

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

 
Demo源码地址:http://kefu-prod-apk.oss-cn-hangzhou.aliyuncs.com/kefu-android-demo.zip

3 个评论

ios篇请上车http://www.imgeek.org/article/825308790
集成了同时存在IM和客服云,Demo代码里的ChatClient.getInstance().init(context, options)这个方法,是不是把IM的SDK也初始化好了?在IM的SDK Demo里初始化用的是EaseUI.getInstance().init(context, options)这个方法.而这个demo里用了ChatClient.getInstance().init(context, options),有点混乱,请释疑.
之前集成了easeUI3.37,现在加上kefu-easeui1.1.3,按照文档的说明,去掉里面的hyphenate_*.jar以及相关so.。以easeUI做为app的model,依赖kefu-easeui。编译的时候,在原来的CallActivity,VideoCallActivity,VoiceCallActivity中 报以下错误,发现好多easeUI里用到的类,在kefu-sdk_1.1.3.jar 中已经没有了,不知道如何整理,请指教。多谢。 G:\projet\yxys\ExamManager\yingnuo\app\src\main\java\com\yxys\yingnuo\ease\ui\CallActivity.java Error:(16, 26) 错误: 找不到符号 符号: 类 EMCallManager 位置: 程序包 com.hyphenate.chat Error:(17, 26) 错误: 找不到符号 符号: 类 EMCallStateChangeListener 位置: 程序包 com.hyphenate.chat Error:(49, 15) 错误: 找不到符号 符号: 类 EMCallStateChangeListener 位置: 类 CallActivity Error:(53, 18) 错误: 程序包EMCallManager不存在 G:\projet\yxys\ExamManager\yingnuo\app\src\main\java\com\yxys\yingnuo\ease\ui\VideoCallActivity.java Error:(42, 26) 错误: 找不到符号 符号: 类 EMCallStateChangeListener 位置: 程序包 com.hyphenate.chat Error:(46, 27) 错误: 程序包com.hyphenate.media不存在 Error:(66, 15) 错误: 找不到符号 符号: 类 EMCallSurfaceView 位置: 类 VideoCallActivity Error:(67, 15) 错误: 找不到符号 符号: 类 EMCallSurfaceView 位置: 类 VideoCallActivity Error:(98, 44) 错误: 找不到符号 符号: 类 EMCameraDataProcessor 位置: 类 VideoCallActivity G:\projet\yxys\ExamManager\yingnuo\app\src\main\java\com\yxys\yingnuo\ease\ui\VoiceCallActivity.java Error:(36, 26) 错误: 找不到符号 符号: 类 EMCallStateChangeListener 位置: 程序包 com.hyphenate.chat Error:Execution failed for task ':app:compileDebugJavaWithJavac'. > Compilation failed; see the compiler error output for details.

要回复文章请先登录注册