美文网首页iOS黑科技iOS DeveloperiOS开发
融云IM iOS sdk 集成流程与心得

融云IM iOS sdk 集成流程与心得

作者: reyzhang | 来源:发表于2017-06-03 11:11 被阅读713次

    融云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中的一个协议方法,用于返回所有的群成员,如下:

    实现获取群组成员的回调方法

    未完待续.....

    写在最后:

    如果我的文章对你有所帮助,请帮忙点个赞👍,谢谢!

    相关文章

      网友评论

      • Mr_Zeng:你好, 融云的可以获取好友在线状态吗
      • Hello_kid:您好,融云视频可以加美颜吗?
        reyzhang:@Ruiz678 这个问题我也不太了解,最好去融云的官方去咨询一下
      • 无赖_V:你好,我在会话列表获取头像和名字的时候遇到一些问题, 在AppDelegate里面实现协议:RCIMUserInfoDataSource 和方法"- (void)getUserInfoWithUserId:(NSString *)userId completion:(void (^)(RCUserInfo *))completion" 进入app的时候不调用, 点击进入聊天页面的时候才去调用到这个函数.. 这是什么原因? 求指教
        reyzhang:@小召95 你的自定义的会员列表页面是继承融云的已经部分实现的ViewController来实现的吗?最好是基于融云kit 做开发,这样能简单些。
        无赖_V:@reyzhang 是在我自定义的会话列表页面,也没有调用这个函数,我把应用卸载,从新安装,获取到最近的2条会话,但是都没有显示名字和头像,我进入聊天页面,就直接走那个代理方法了,然后回到列表页面,就直接刷新了名字和头像
        reyzhang:@小召95 进入App的时候肯定不会被调用。 因为这是一个代理方法,它的调用取决于融云,融云sdk中在适当的时候才会走这个回调方法。这个适当的时候,指的是在会员列表,聊天等需要获取用户信息的地方。
      • 田小北北:大神有没有 自己获取过token? 我获取的时候老师提示1002 错误 (ps 测试的是获取token的接口)
        reyzhang:@田小北北 这个接口肯定要保证稳定,这是使用融云的第一步,如果token都获取不到,后面的操作就无法进行。 如果还有问题,你可以给融云发工单来问询。 你说的问题我没有遇到过
      • lawrenceWeiii:老铁,求demo
        reyzhang:需要结合后台接口来完成群加入,退群等操作。所以无法提供demo。如果需要看效果,可以参考我们的App : https://itunes.apple.com/cn/app/id1240634680
      • lawrenceWeiii:期待后续:kissing_heart:
      • 天蝎座沫沫:想问一下,我这里集成的融云客服功能,获取用户信息的方法不走
        reyzhang:融云客服功能,除了客服的信息外就是发起咨询人的信息,这个信息直接从RCIMClient 类中可以读取到的吧
      • J_Pisces:请问一下,如果对方头像更新, 要在哪里刷新
        reyzhang:@J_Pisces 对象头像更新,需要调用融云sdk去refresh用户头像。而你这边需要通过调用融云的server api来重新获取用户信息就可以拿到了
      • smkoc:写的不错
        reyzhang:@smkoc 谢谢~,你们的支持是我继续分享下去的动力
      • 73eabfcfca1c:灰常感谢楼主,最近刚好在集成这个。
        reyzhang:接下来还有一大波干货,欢迎关注啊

      本文标题:融云IM iOS sdk 集成流程与心得

      本文链接:https://www.haomeiwen.com/subject/wikbkttx.html