记录下项目中集成环信的坑。当做个总结。1.昵称显示,2.自定义表情,3.忘了(好像没了)
一、集成环信
项目用到的环信即时通讯云V3.0,官方文档点这里。环信有自己的Demo,里面很多功能都包含了,足够项目需求了,具体怎么集成就不说了,可以看文档,也不难。环信的第三方如果和自己的项目的第三方冲突就把环信的删掉,在替换相关方法就行。环信demo里集成了红包功能,红包里已经集成好支付宝了,所以想集成支付宝的可以直接用。
二、昵称
公司的服务器保存用户信息,环信那边不做保存。环信官方文档提供了两种方法:昵称和头像的显示与更新。
方法一:从APP服务器获取昵称和头像
昵称和头像的获取:当收到一条消息(群消息)时,得到发送者的用户ID,然后查找手机本地数据库是否有此用户ID的昵称和头像,如没有则调用APP服务器接口通过用户ID查询出昵称和头像,然后保存到本地数据库和缓存,下次此用户发来信息即可直接查询缓存或者本地数据库,不需要再次向APP服务器发起请求。
昵称和头像的更新:当点击发送者头像时加载用户详情时从APP服务器查询此用户的具体信息然后更新本地数据库和缓存。当用户自己更新昵称或头像时,也可以发送一条透传消息到其他用户和用户所在的群,来更新该用户的昵称和头像。
方法二:从消息扩展中获取昵称和头像
昵称和头像的获取:把用户基本的昵称和头像的URL放到消息的扩展中,通过消息传递给接收方,当收到一条消息时,则能通过消息的扩展得到发送者的昵称和头像URL,然后保存到本地数据库和缓存。当显示昵称和头像时,请从本地或者缓存中读取,不要直接从消息中把赋值拿给界面(否则当用户昵称改变后,同一个人会显示不同的昵称)。
昵称和头像的更新:当扩展消息中的昵称和头像 URI 与当前本地数据库和缓存中的相应数据不同的时候,需要把新的昵称保存到本地数据库和缓存,并下载新的头像并保存到本地数据库和缓存。
方案对比
昵称或头像处理的方法一和方法二区别:
方法一:在发送消息时不含有任何扩展,收消息时如果本地不存在发送人的用户信息则需要从APP服务器查询发送人的昵称和头像的 URL。
方法二:在发送消息时带有包含昵称和头像 URL 的消息扩展,收到消息时即可从消息扩展中取出,不需要再去 APP 服务器获取。
方法二和方法一相比:
优点:收到消息立即显示昵称不用等待APP服务器返回数据后显示。
缺点:每条消息都要带有扩展,增加消息体积,每次发消息都有一些不必要的数据。
根据自己的情况选择适合的,我用到的是第二种方法。
1.EaseMessageViewController在该页面中有提供发送消息拓展的方法。
- (void)sendTextMessage:(NSString *)text;
- (void)sendTextMessage:(NSString *)text withExt:(NSDictionary*)ext;
- (void)sendImageMessage:(UIImage *)image;
- (void)sendLocationMessageLatitude:(double)latitude
longitude:(double)longitude
andAddress:(NSString *)address;
- (void)sendVoiceMessageWithLocalPath:(NSString *)localPath
duration:(NSInteger)duration;
- (void)sendVideoMessageWithURL:(NSURL *)url;
- (void)sendLocationMessageLatitude:(double)latitude
longitude:(double)longitude
andAddress:(NSString *)address
{
NSDictionary *ext = [self userInfo];
EMMessage *message = [EaseSDKHelper sendLocationMessageWithLatitude:latitude
longitude:longitude
address:address
to:self.conversation.conversationId
messageType:[self _messageTypeFromConversationType]
messageExt:ext];
[self _sendMessage:message];
}
每个方法都带有ext字典可以携带拓展,把用户的头像和昵称存进去就可以在对面的方法中处理。
在ChatViewController中可以对发送过来的ext拓展消息进行处理。在下面这个方法里处理就可以,
- (id)messageViewController:(EaseMessageViewController *)viewController
modelForMessage:(EMMessage *)message
如果只是集成单聊的这些就足够了,如果还要群组的,就要用到本地数据库,存储用户信息,然后在取出来显示。数据用的是sqlite3.0,数据的操作我就不说了,你们可以自己研究。写个数据库操作管理类,在工程里搜索profileEntity,把环信里的云数据库替换成本地就可以让环信的群@功能,群详细,抢红包消息提示的用户显示昵称了。
二、集成自定义表情
这个很简单,在ChatViewController中找到这个方法,在这个方法中进行添加就可以加入自定义表情了。
- (NSArray*)emotionFormessageViewController:(EaseMessageViewController *)viewController
环信demo自带的兔斯基表情也是在这里处理的,可以参考下,就知道怎么添加自定义表情了。
三、暂时没啥好说的了。
四、最近都在赶项目,好久没时间写点东西。今天有空,就写点干货,希望对集成环信的朋友能有点帮助。环信的客服还是挺给力的,有啥不懂的就去问吧,问着就知道怎么弄了。