融云IM简介
融云的定位是只专注即时通讯的消息发送功能,融云服务器不会维护用户的好友关系及群组关系,这就需要集成的业务系统来管理用户的好友关系与群关系等。 通过融云,只需要知道目标用户的targetId就可以向目标用户发送消息。
如何连接融云服务器 ?
连接融云服务器,需要向融云服务器传递将要连接服务器的用户唯一标识,融云会根据传递的userid(唯一标识)来返回访问融云服务器的令牌token. 关于userid的选取,可以使用业务系统的userid(建议),或者单独建立一套唯一id的体系给融云服务器。格式不限,可以为数字,GUID,或任意的字符串(汉字除外)
融云会保存哪些信息?
对于用户,融云会去保存用户的唯一标识userid,昵称name, 头像portraitUri 的信息,这些信息被封装到RCUserInfo 类中。如果想要知道某个用户的信息也可以通过唯一标识userid向融云服务器来获取。
融云还会帮助我们管理群组中的成员列表。融云不关心你建了几个群,但却需要管理每个群下的成员,因为当在群中发送消息时,融云需要知道向哪些用户推送群消息,从这点上就可以看出来。业务系统也需要管理群及群成员,当用户进群与退群时,业务系统需要与融云保持同步 (进群,退群融云都有接口服务提供)
聊天消息,消息的发送都需要经过融云服务器,所以聊天消息融云是会存储的,但消息的保存时限会有免费用户与付费用户的不同。
与业务系统的集成
首先需要到融云的官网创建一个自己的应用,成功后会拿到AppKey。在AppDelegate didFinishLaunchingWithOptions:方法中做融云的初始化操作
融云SDK初始化
建议在用户登录后使用业务系统的userid(唯一标识)去获取令牌token,并使用此token尝试连接融云服务器。在用户退出时,断开与融云服务器的连接。 如果应用有持久保存用户登录的特性,那么在首次获取到令牌token后,也需要持久存储。当应用重启后需要根据存储的令牌token做重连操作。
在拿到令牌token去建立与融云服务器的连接时,可能会因token过期,或token 不正确导致连接失败的情况。这里可以根据不同策略做不同处理,比如当失败后重新尝试获取token并连接或干脆提示用户登录失效,请重新登录。
会话列表如何自定义?
融云提供了两套framework IMKit, IMLib. IMKit中融云封装了会话,聊天等UI界面。 使用IMKit可以很方便的将融云集成进来。其中主要包含如下两个主要的控制器:
RCConversationListViewController 会话列表控制器
RCConversationViewController 聊天窗口
在集成时,我们可以直接继承RCConversationListViewController 来实现会话列表,如果默认的会话列表展示无法满足你的需要,你也可以自定义cell的展示。但需要通过修改会话模型RCConversationModel的conversationType类型来告诉sdk 调用自定义cell的回调方法。
修改会话类型为自定义会话
只有当RCConversationModel的conversationModelType 值为 RC_CONVERSATION_MODEL_TYPE_CUSTOMIZATION时自定义cell的回调方法才会被执行
实现返回自定义cell的回调方法
会话列表中的用户头像,群组缩略图如何获取 ?
集成后,在发消息时,会碰到用户头像或群组图无法加载的情况。这时就需要检查在初始时是否指定了userInfoDataSource, groupDataSource的代理。这两个代理方法中有相关的返回用户信息,群组信息的回调方法,只需要在这个回调方法中返回用户信息,群组信息就可以解决这个问题。
设置用户信息源和群组信息源
可以看到,我把获取用户信息和群组信息源的代理都指向了一个名为RCDataManager的单例类中,在这个类里实现了返回用户信息与群组信息的方法
根据userId获取用户信息
如上是获取用户信息的回调方法,首先判断回调传回的userid是否是当前登录用户自己。如果是自己,从业务系统中将用户id, 昵称,头像等信息构造出来RCUserInfo对象,并告诉融云当前用户的信息
[RCIM sharedRCIM].currentUserInfo = myselfInfo;
如果用户不是自己,对于群聊用户,用户与用户之间没有朋友关系,如果要获取用户的信息,就只能是通过融云的后端接口,根据userid唯一标识来获取了。
补上连接融云时的代码
通过令牌token连接融云服务器
在连接融云成功后 ,同步获取一下群组的列表信息,并缓存。群组列表中存储的都是RCGroup对象。缓存群组信息,便于在获取某个群组信息时使用。
根据groupId获取群信息
通过实现该代理方法,融云会在适当的时机调用此方法返回群组的信息
如何在用户信息变化时,更新用户信息(头像,名称)?
当用户更新了业务系统中的头像及名称后如何同步会话列表及聊天窗口用户的信息呢?sdk为我们提供了一个方法就可以解决
更新当前用户头像
群聊@用户时,如何调出群成员列表 ?
在群聊时,通常会针对其中的某个用户发送一条消息,这时就用到了@某个用户的功能。融云sdk提供了协议方法来获取某个群组中所有的成员,并通过属性开关的方式来控制是否支持@功能,在融云初始化进行全局设置。
开启@功能并指定代理订阅者
当然我们还需要实现RCIMGroupMemberDataSource中的一个协议方法,用于返回所有的群成员,如下:
实现获取群组成员的回调方法
未完待续.....
转载自:https://www.jianshu.com/p/fdf5cc5f365e