iOS:即时通讯之<掌握篇 环信>

什么是环信?

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大致变动介绍:


都是官网的东西,与君共勉!



阅读更多
个人分类: iOS开发
想对作者说点什么? 我来说一句

没有更多推荐了,返回首页

关闭
关闭
关闭