美文网首页
即时通讯-阿里百川的接入与使用

即时通讯-阿里百川的接入与使用

作者: 李丘 | 来源:发表于2017-05-23 09:33 被阅读0次

    导语

    由于公司的业务需求,产品中需要用到即时通讯功能,经由老大拍板后,决定接入和使用阿里百川的SDK,因为我们需要在其中加入自动回复的功能,所以需要使用自己的UI,本文就记录了在这个过程中遇到的一些问题和经验。

    现在的需求是一个咨询的功能,所以主要页面上也就两个,会话列表聊天界面,但是为了这两个需求,阿里百川的API也看的差不多了,所以在此基础上添加新的功能也不会很难。

    阿里百川的基本介绍

    网上很多阿里百川的使用介绍,就不啰嗦了(顺便吐槽一下阿里百川的文档),这里只是着重讲一下几个重要的服务。

    在这之前,还需要引入YWIMCore,YWIMCore对象代表了一个OpenIM账号的上下文信息,可以从该对象中获取IM的各种服务,所获取的各种服务就是我们使用自己的UI的界面的时候所需要的数据来源,比如聊天记录,用户的个人信息等。

    服务:
    IYWLoginService.h 登录及长连接相关
    IYWConversationService.h 会话及消息相关(获取聊天记录等)
    IYWTribeService.h 群相关接口
    IYWContactService.h 在线状态相关接口(用户头像,昵称等信息)

    使用的方法是,先从IMCore中获取服务,然后调用服务中的方法,从而获得想要的数据,比如下面的监听新消息的回调(详细的方法请在各个头文件中查看,官方的文档介绍得太简单了):

    [[_appDelegate.ywIMKit.IMCore getConversationService] addOnNewMessageBlock:^(NSArray *aMessages) {
           //新消息    
        } forKey:self.description ofPriority:YWBlockPriorityDeveloper];
    

    会话列表

    下面开始进入正题。

    会话列表.png

    会话列表就是相当于微信的首页,一个tableView,显示所有的聊天记录,其中每一个cell一般需要显示的内容是以下几个:

    1.头像
    2.昵称
    3.最后一条信息的时间
    4.最后一条信息的内容
    5.未读消息的badge

    其中,前两条需要从IYWContactService.h中获取,后三条从IYWConversationService.h获取。
    首先是获取聊天的用户信息,包括头像,昵称等,同样的,需要从IMCore中获取服务,然后调用API,获取到数据之后就可以作为数据源,展示在cell上了。

        [[self.imCore getContactService] asyncGetAllProfileFromServerForPersons:persons withCompletionBlock:^(NSError *aError, NSArray *aProfileDictionariesArray) {
              //aProfileDictionariesArray是一个字典数组,字典的key在YWContactServiceDef.h头文件中,比如avatarUrl,displayName等
        }];
    

    后三条内容的获取就需要获取会话了(conversation),在openIM中,YWConversation是一个基类,与会话有关的信息都在这个类中,获取的方式也是一样的,首先是获取服务,再获取数据。

    [[_appDelegate.ywIMKit.IMCore getConversationService] asyncFetchAllConversationsWithCompletionBlock:^(NSArray *aConversationsArray) {
             //aConversationsArray是一个会话(YWConversation)数组
        }];
    
    会话属性.png

    聊天页面

    聊天页面实现的思路是,聊天记录作为tableView的数据源,每次接收到信息或者发送新消息就刷新数据源,重新加载数据。所在中间最重要的是获取聊天的记录。

    聊天记录通过YWConversation这个类中的方法获取:

    /**
     *  获取某个conversation的某一种消息体的所有本地消息记录
     *  @param className 消息体类型名,例如YWMessageBodyText
     *  @return 指定消息体类型的消息对象(id<IYWMessage>) 
     */
    - (NSArray *)fetchMessagesThatMessageBodyIsKindOfClass:(NSString *)className;
    

    这个接口只能获取一种消息类型(文本,图片,音频等),因为在这个项目中只有文本和图片两种消息类型,所以我的做法是先分别获取这两种消息类型的记录,然后通过发送的时间进行排序,最后作为数据源,展示。(个人感觉这是一个很蠢的办法,各位有什么好的建议也可以在下方进行评论交流)

    关于收消息和发消息,官方文档上的说明已经很明确了,按照上面的方法做没什么大的问题。

    推送

    最后讲一讲阿里百川的推送,按照文档上去做是没什么大问题的,但是有一点一定要吐槽一下的,官方文档上的介绍不知道是哪个版本的,图片上官网的样式和实际上的相差太多,在上传推送证书的时候,在开发者平台上怎么也找不到入口,缺乏更新维护的文档实在是让人恼火。

    正确的入口应该是这样的:
    个人中心 -- 我的产品后台 -- 选择开通百川即时通讯 -- 进入后台,然后就可以愉快的上传证书了。

    推送上传证书.png

    另外提一点的就是测试推送的时候,需要打包一个IPA,上传到分发平台上,从上面下载安装就可以测试推送了。

    总结

    虽然说阿里百川上的官方文档写的很简单,论坛上的问答也缺乏更新维护,但是作为一名程序员,遇到问题,自主解决问题的能力很重要,不管是自己去看框架的头文件,还是去阿里旺旺的开发者群去咨询,总之要想尽一切办法去解决问题,最后就会发现,原来所谓的问题也就不过如此。

    相关文章

      网友评论

          本文标题:即时通讯-阿里百川的接入与使用

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