什么是环信?
1.环信是一个第三平台,提供即时通信(IM–Instant Messaging )的服务
2.环信是在XMPP的基础上进行二次开发
3.环信在网络上传输的数据也是XML
4.使用环信,不用自己搭建服务器,节约成本
5.环信日活30万以下,永远免费
为什么要选择环信?
数据来源艾瑞:点击跳转
数据来源易观:点击跳转
集成环信前提准备:
1.注册成为环信开发者点击进入环信
2.在开发者后台创建APP获取Key
3.下载官方SDK DEMO点击查看
集成SDK步骤:
1.导入SDK
2. 设置工程属性
2.2 SDK依赖库有
注意:(如果使用的是xcode7,后缀为tbd) <官网有提示>
2.3 如果项目中使用-ObjC有冲突,可以添加-force_load来解决
2.4 SDK不支持bitcode,向Build Settings → Linking → Enable Bitcode中设置NO。
编译工程
以上步骤进行完后,编译工程,如果没有报错,恭喜你,集成sdk成功,可以进行下一步了。
SDK同步/异步方法区分:
SDK中,大部分与网络有关的操作,提供的是同步方法(注:同步方法会阻塞主线程,需要用户自己创建异步线程执行;带有async的方法为异步方法)
初始化SDK
1.引入相关头文件 #import “EMSDK.h”
2.在工程的AppDelegate中的以下方法中,调用SDK对应方法:
调用的SDK接口参数解释如下:
1.AppKey: 区别app的标识,开发者注册及管理后台
2.apnsCertName: iOS中推送证书名称。制作与上传推送证书
3.环信为im部分提供了apns推送功能,如果您要使用,请跳转到apns离线推送
注册:
1.注册模式分两种,开放注册和授权注册。只有开放注册时,才可以客户端注册。
2.开放注册是为了测试使用,正式环境中不推荐使用该方式注册环信账号, 授权注册的流程应该是您服务器通过环信提供的rest api注册,之后保存到您的服务器或返回给客户端。
登陆:
登录:调用SDK的登录接口进行的操作;
自动登录:
自动登录:即首次登录成功后,不需要再次调用登录方法,在下次app启动时,SDK会自动为您登录。并且如果您自动登录失败,也可以读取到之前的会话信息。配置是否进行自动登录SDK中自动登录属性默认是关闭的,需要您在登录成功后设置,以便您在下次app启动时不需要再次调用环信登录,并且能在没有网的情况下得到会话列表。
自动登录在以下几种情况下会被取消
1.用户调用了SDK的登出动作;
2.用户在别的设备上更改了密码, 导致此设备上自动登陆失败;
3.用户的账号被从服务器端删除;
4.用户从另一个设备登录,把当前设备上登陆的用户踢出.
所以,在您调用登录方法前,应该先判断是否设置了自动登录,如果设置了,则不需要您再调用
SDK中,如果发生自动登录,会有以下回调
重连:
当掉线时,IOS SDK会自动重连,只需要监听重连相关的回调,无需进行任何操作。
退出登陆:
退出登录分两种类型:主动退出登录和被动退出登录。
主动退出登录:调用SDK的退出接口;
被动退出登录: 1、 正在登陆的账号在另一台设备上登陆; 2、 正在登陆的账号被从服务器端删除。
logout:YES:是否解除device token的绑定,在被动退出时SDK内部处理,不需要调用退出方法
被动退出登录:
回调方法监听:
还有很多很多功能,而且官网 写的非常非常清楚!
好友管理
注:环信不是好友也可以聊天,不推荐使用环信的好友机制。如果你有自己的服务器或好友关系,请自己维护好友关系。
获取好友列表
获取好友列表,环信提供了两种方法。
1. 从服务器获取所有的好友
2. 从数据库获取所有的好友
好友申请
发送加好友申请
环信iOS SDK提供了添加好友的方法
如果您已经发过,并且对方没有处理,您将不能再次发送
实时通话管理
客户端
1.发起实时通话
2.被叫方同意实时通话
3.结束实时通话
4.实时通话实例
等等等... 点击查看详细
EaseUI使用指南
EaseUI是一个UI库,封装了IM功能常用的控件、fragment等等,旨在帮助开发者快速集成环信sdkeaseui及demo的github下载地址为:
https://github.com/easemob/easeui;
https://github.com/easemob/sdkdemoapp3.0_android,3.0的代码需要切换到sdk3.0分支
注意:因为这是一个ui库,后续很可能还会继续改动,新旧版本在api的兼容上不会像im sdk那样绝对的兼容。(官网有提示)
代码导入
easeui库的代码是开源的,下载的sdk压缩包里面已经包含此库,解压后路径为/examples/easeui
Eclipse中导入:
1.先把easeui项目导入到eclipse中
2.在自己的项目中把easeui作为一个library引入。右键你的项目→Android→点击右下角的Add按钮→选中EaseUI→OK→OK
Android studio中导入:打开你的AS项目→File→New→Import Module→选择或输入easeui库路径→Next→Next→Finish
导入完可能会有如下错误:
找到相应报错的地方把swipeRefreshLayout.setColorSchemeResources改成swipeRefreshLayout.setColorScheme,ViewCompat.getX改成new ViewCompat().getX,然后重新build即可;或者把v4包的版本号加大,譬如compile ‘com.android.support:support-v4:23.1.1‘。
主要fragment
1.EaseConversationList - 聊天页面,最主要的fragment
2.EaseContactListFragment - 联系人页面
3.EaseConversationListFragment - 会话列表页面
主要控件
1.EaseTitleBar - 标题栏
2.EaseChatMessageList - 聊天消息列表控件
3.EaseConversationList - 会话列表控件
4.EaseContactList - 联系人列表页面
5.EaseChatInputMenu - 聊天输入菜单栏
其他子控件,后文会做详细介绍
这里对聊天页面几个控件做简单图示:
类似这些功能:
这里都有介绍,只不过觉得这么好的东西放在官网没人看,太可惜了...点击查看详细
API大致变动介绍:
都是官网的东西,与君共勉!
文/百度工程师阿伟(简书作者)
原文链接:http://www.jianshu.com/p/73be68baa1ac
著作权归作者所有,转载请联系作者获得授权,并标注“简书作者”。