网易云信IM已读回执开发总结

1.网易云信

网易云信算是国内比较老牌的IM即时通讯服务商了,公司项目里集成的网易云信SDK,关于这个SDK就不多说了,官网上的介绍比较详细。

项目里接入了SDK,然后UI界面是使用的网易提供的一套UI框架,叫NIMKit.h 在此基础上进行开发。

2.IM已读回执

IM已读回执,整个的过程简单说来就是:

1.聊天消息的发送方,发出的一条带开通回执功能的消息(可以是文字,图片等等,语音一般都自带回执);
2.聊天接收方查看了(前提是收到了该消息)了这条消息,要告诉发送方我我已经查看了,此时发一条该消息已读的指令给发送方;
3.聊天发送方,收到接收方,发来的消息已读回执。这个时候,就要更新本地数据,在UI界面上把那条聊天信息,显示为已读;

群聊也是如此,在群聊中发出一条消息,通过回执功能可以看出谁已读或者未读。
如果你用过钉钉,就很好理解这个流程。

3.前期准备

既然是迭代开发,没玩过这个SDK肯定是要查看开发文档的。
NIMKit文档
单聊文档
群聊文档

敲黑板,划重点,要考!!
网易云信SDK,已读回执功能,需要单独开通服务,而且是付费服务
也就是说,代码写的再好,不花钱开通也没吊用。

卧槽.png

讲到这里,其实最最首要的任务是:充钱,充钱,充钱!

4.拿起键盘就是干

就是干

4.1 聊天Cell定制

如下图,NIMKit里面已经封装好了一套聊天Cell。根据业务需要自行调整。


cell结构

比如,它的readLabel是放在最左侧,我们需求是放在底部位置。所以自行重定义布局,很简单代码就不贴了。

当然NIMKitConfig里面你要自定义好readLabel的字体大小颜色,内容等等。
NIMMessageModel是每一条聊天消息的model实体,readlabel的隐藏显示是由shouldShowReadLabel这个属性来驱动。

NIMSessionTableAdapter这个类用来负责聊天页面的tableview相关,因为需求是将已读放到了消息底部,那必然要对cell的高度进行调整。

- (CGFloat)tableView:(UITableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath {
    CGFloat cellHeight = 0;
    id modelInArray = [[self.interactor items] objectAtIndex:indexPath.row];
    if ([modelInArray isKindOfClass:[NIMMessageModel class]]) {
        NIMMessageModel *model          = (NIMMessageModel *)modelInArray;
        CGSize size                     = [model contentSize:tableView.nim_width];
        UIEdgeInsets contentViewInsets  = model.contentViewInsets;
        UIEdgeInsets bubbleViewInsets   = model.bubbleViewInsets;
        CGFloat unreadLabelHeight       = [model.message.from isEqualToString:[NIMSDK sharedSDK].loginManager.currentAccount] ? 20 : 0;// 高度适配
        cellHeight                      = size.height + contentViewInsets.top + contentViewInsets.bottom + bubbleViewInsets.top + bubbleViewInsets.bottom + unreadLabelHeight;
    }
  ....
}

4.2 P2P聊天

P2P就是点对点聊天,就是单聊。

在会话界面中调用发送已读回执的接口并传入最后一条消息,即表示这之前的消息都已读,对端将收到此回执。
发送已读回执

@protocol NIMChatManager <NSObject>
- (void)sendMessageReceipt:(NIMMessageReceipt *)receipt
                completion:(NIMSendMessageReceiptBlock)completion;
@end

接受已读回执

@protocol NIMChatManagerDelegate <NSObject>
- (void)onRecvMessageReceipts:(NSArray<NIMMessageReceipt *> *)receipts;
@end

文档里说了这些,所有只要在生命周期方法里,把最后一条消息捞出来,调一下sendMessageReceipt方法即可。
如果发送了回执,对方的onRecvMessageReceipts就会被调用。网易牛逼的地方就是,收到回执的时候,SDK内部已经把数据都处理好了,上层只需要把UI刷新一下即可。
什么?你问我怎么刷新??
在onRecvMessageReceipts里[self.tableView reloadData];
爽不爽?

4.3 群聊发送已读回执

群聊和单聊方法基本差不多,但是要改一个属性,

发送需要标记已读回执的群组消息标记

/**
*  其他群成员收到此消息是否需要发送已读回执
*  @discussion 默认为NO,设置成 YES 之后所有群回执相关操作才会生效
*/
@property (nonatomic,assign) BOOL teamReceiptEnabled;

一句话搞定
[NIMSDKConfig sharedConfig].teamReceiptEnabled = YES;

消息接收方收到消息,并回复回执 在会话界面中调用发送已读回执的接口并传入最后一条消息,即表示这之前的消息都已读,对端将收到此回执。

@protocol NIMChatManager <NSObject>
- (void)sendMessageReceipt:(NIMMessageReceipt *)receipt
                completion:(NIMSendMessageReceiptBlock)completion;
@end

到这里就遇到坑了,属性都配置好了,发回执就是不行。后来咨询了网易的技术支持,他丢给了我一个链接https://faq.yunxin.163.com/kb/main/#/item/KB0335
原来网易还有知识宝库这玩意

image.png

原来不只是要将NIMSDKConfig的teamReceiptEnabled要改成YES,NIMMessage中的setting中的teamReceiptEnabled也要改成YES,这个文档里居然没写。要不是技术支持发给我谁知道有这玩意???

#pragma mark - NIMChatManagerDelegate
- (void)willSendMessage:(NIMMessage *)message {
 
    id<NIMSessionInteractor> interactor = self.interactor;
    if (message.session.sessionType == NIMSessionTypeTeam) {
        message.setting.teamReceiptEnabled = YES; // 设置里打开才行。
    }
....
}

这样之后才能正确发送已读回执。

发送已读回执之后,对方的那条消息,就能看到
model.message.teamReceiptInfo.unreadCount就能再UI上显示多少人未读。

4.4 群聊查看消息已读未读列表

SDK里面已提供了查询消息已读id列表接口
查询详情接口
包括已读人数的 id 和 未读人数的 id 列表。需要注意查询详情对象不会跟着回执人数变化而变化,如果要获取最新的详情,必须再次调用此接口。

@protocol NIMChatManagerDelegate <NSObject>

/**
 *  查询群组消息回执详情
 *
 *  @param NIMMessage    要查询的消息
 *  @discussion          详情包括已读人数的 id 列表和未读人数的 id 列表
 *                       查询详情对象不会跟着回执人数变化而变化,如果要获取最新的详情,必须再次调用此接口
 *
 */
- (void)queryMessageReceiptDetail:(NIMMessage *)message
                       completion:(NIMQueryReceiptDetailBlock)completion;

@end

参数正确之后,会返回这条消息的已读id列表和未读id列表,列表里面保存的是userid。

这里也遇到一个坑:
在聊天界面,当前新发送的消息,能够查询到已读未读列表。但是打开页面之前的历史消息,无论如何都查不到。
经过debug发现,当退出聊天窗口,所有的消息变成历史数据之后,才进入聊天窗口,所有的历史消息message.setting.teamReceiptEnabled统统变成了NO,解决方法也很简单,每次queryMessageReceiptDetail查询之前,再把这个属性设置成YES就能正确查询列表了。

注意点:网易云信最多支持100人群聊的已读消息回执
超过100也就不支持了,如果不能满足需求,要么有本事自己写一套IM,要么就换一家SDK吧。

5.结束语

虽然是第一次接触,总体觉得网易这整个一套IM的SDK也不是很难,嵌套的比较多,需要认真梳理各个类各个协议,所承载的功能。其次,开发难免会遇到一些坑和弯路,写这篇文章也算是为了帮后来人吧。

如有错误,还请各位看官批评指正~

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,723评论 6 481
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,485评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 152,998评论 0 344
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,323评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,355评论 5 374
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,079评论 1 285
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,389评论 3 400
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,019评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,519评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,971评论 2 325
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,100评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,738评论 4 324
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,293评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,289评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,517评论 1 262
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,547评论 2 354
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,834评论 2 345

推荐阅读更多精彩内容