导语
由于公司的业务需求，产品中需要用到即时通讯功能，经由老大拍板后，决定接入和使用阿里百川的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];
会话列表
下面开始进入正题。
会话列表就是相当于微信的首页，一个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）数组
}];
聊天页面
聊天页面实现的思路是，聊天记录作为tableView的数据源，每次接收到信息或者发送新消息就刷新数据源，重新加载数据。所在中间最重要的是获取聊天的记录。
聊天记录通过YWConversation这个类中的方法获取：
/**
* 获取某个conversation的某一种消息体的所有本地消息记录
* @param className 消息体类型名，例如YWMessageBodyText
* @return 指定消息体类型的消息对象(id<IYWMessage>)
*/
- (NSArray *)fetchMessagesThatMessageBodyIsKindOfClass:(NSString *)className;
这个接口只能获取一种消息类型（文本，图片，音频等），因为在这个项目中只有文本和图片两种消息类型，所以我的做法是先分别获取这两种消息类型的记录，然后通过发送的时间进行排序，最后作为数据源，展示。（个人感觉这是一个很蠢的办法，各位有什么好的建议也可以在下方进行评论交流）
关于收消息和发消息，官方文档上的说明已经很明确了，按照上面的方法做没什么大的问题。
推送
最后讲一讲阿里百川的推送，按照文档上去做是没什么大问题的，但是有一点一定要吐槽一下的，官方文档上的介绍不知道是哪个版本的，图片上官网的样式和实际上的相差太多，在上传推送证书的时候，在开发者平台上怎么也找不到入口，缺乏更新维护的文档实在是让人恼火。
正确的入口应该是这样的：
个人中心 -- 我的产品后台 -- 选择开通百川即时通讯 -- 进入后台，然后就可以愉快的上传证书了。
另外提一点的就是测试推送的时候，需要打包一个IPA，上传到分发平台上，从上面下载安装就可以测试推送了。
总结
虽然说阿里百川上的官方文档写的很简单，论坛上的问答也缺乏更新维护，但是作为一名程序员，遇到问题，自主解决问题的能力很重要，不管是自己去看框架的头文件，还是去阿里旺旺的开发者群去咨询，总之要想尽一切办法去解决问题，最后就会发现，原来所谓的问题也就不过如此。
