乐趣区

关于即时通讯:干货分享使用融云通讯能力库-IMLib-实现单群聊的阅读回执

jiezi

明天的干货分享是对于“浏览回执”性能，这是一个很广泛的性能，然而针对应用融云的 SDK 去实现，还是有些坑在等着咱们的，上面就开始分（bì）享（kēng）喽～

  1. 分享之前先做一些筹备工作，先找到咱们须要调用的接口文档

    • 文档：https://docs.rongcloud.cn/v4-platform/views/im/noui/guide/platform-ios/message/receipt/private-p.html?match=imlib-ios
    • 官网：https://www.rongcloud.cn/

  2. 依据不同的会话类型以及音讯的发送方和接管方，要别离解决

    • 单聊

      接管方 ：在浏览音讯后，调用 RCIMClient 类的发送浏览回执接口，参数如下:

      conversationType 单聊会话类型

      targetId 音讯的会话 ID

      time 会话最初一条音讯的发送工夫（sentTime）

      /*!
      发送某个会话中音讯浏览的回执
      ​
      @param conversationType    会话类型
      @param targetId            会话 ID
      @param timestamp           该会话中已浏览的最初一条音讯的发送工夫戳
      @param successBlock        发送胜利的回调
      @param errorBlock          发送失败的回调 [nErrorCode: 失败的错误码]
      ​
      @discussion 此接口只反对单聊, 如果应用 IMLib 能够注册监听
      RCLibDispatchReadReceiptNotification 告诉, 应用 IMKit 间接设置 RCIM.h
      中的 enabledReadReceiptConversationTypeList。
      ​
      @warning 目前仅反对单聊。
      ​
      @remarks 高级性能
      */

      • (void)sendReadReceiptMessage:(RCConversationType)conversationType
        targetId:(NSString *)targetId
        time:(long long)timestamp
        success:(void (^)(void))successBlock
        error:(void (^)(RCErrorCode nErrorCode))errorBlock;

      发送方 ：监听上面这个告诉，在接管后批改音讯的展现

      /*!
      @const 收到已读回执的 Notification
      ​
      @discussion 收到音讯已读回执之后，IMLib 会散发此告诉。
      ​
      Notification 的 object 为 nil，userInfo 为 NSDictionary 对象，
      其中 key 值别离为 @”cType”、@”tId”、@”messageTime”,
      对应的 value 为会话类型的 NSNumber 对象、会话的 targetId、已浏览的最初一条音讯的 sendTime。
      如：
      NSNumber *ctype = [notification.userInfo objectForKey:@”cType”];
      NSNumber *time = [notification.userInfo objectForKey:@”messageTime”];
      NSString *targetId = [notification.userInfo objectForKey:@”tId”];
      NSString *fromUserId = [notification.userInfo objectForKey:@”fId”];
      ​
      收到这个音讯之后能够更新这个会话中 messageTime 以前的音讯 UI 为已读（底层数据库音讯状态曾经改为已读）。
      ​
      @remarks 事件监听
      */
      FOUNDATION_EXPORT NSString *const RCLibDispatchReadReceiptNotification;

    • 群聊

      发送方 ：

      在发送音讯 A 后，须要针对该音讯发送回执申请，message 传之前发的音讯 A

      /*!
      申请音讯浏览回执
      ​
      @param message      要求浏览回执的音讯
      @param successBlock 申请胜利的回调
      @param errorBlock   申请失败的回调 [nErrorCode: 失败的错误码]
      ​
      @discussion 通过此接口，能够要求浏览了这条音讯的用户发送浏览回执。
      ​
      @remarks 高级性能
      */

      • (void)sendReadReceiptRequest:(RCMessage *)message
        success:(void (^)(void))successBlock
        error:(void (^)(RCErrorCode nErrorCode))errorBlock;

      设置上面代理函数，在接管到发送方发来的浏览回执响应后，批改音讯的展现

      /*!
      IMlib 音讯接管的监听器
      ​
      @discussion
      设置 IMLib 的音讯接管监听器请参考 RCIMClient 的 setReceiveMessageDelegate:object: 办法。
      ​
      @warning 如果您应用 IMlib，能够设置并实现此 Delegate 监听音讯接管；
      如果您应用 IMKit，请应用 RCIM 中的 RCIMReceiveMessageDelegate 监听音讯接管，而不要应用此监听器，否则会导致 IMKit 中无奈自动更新 UI！
      */
      @protocol RCIMClientReceiveMessageDelegate <NSObject>

      /*!
      音讯已读回执响应（收到浏览回执响应，能够依照 messageUId 更新音讯的阅读数）
      @param messageUId       申请已读回执的音讯 ID
      @param conversationType conversationType
      @param targetId         targetId
      @param userIdList 已读 userId 列表
      */

      • (void)onMessageReceiptResponse:(RCConversationType)conversationType
        targetId:(NSString *)targetId
        messageUId:(NSString *)messageUId
        readerList:(NSMutableDictionary *)userIdList;

      ​

      接管方 ：

      设置上面代理函数，在接管到音讯 A 后，还会接管到针对音讯 A 的浏览回执申请

      /*!
      IMlib 音讯接管的监听器
      ​
      @discussion
      设置 IMLib 的音讯接管监听器请参考 RCIMClient 的 setReceiveMessageDelegate:object: 办法。
      ​
      @warning 如果您应用 IMlib，能够设置并实现此 Delegate 监听音讯接管；
      如果您应用 IMKit，请应用 RCIM 中的 RCIMReceiveMessageDelegate 监听音讯接管，而不要应用此监听器，否则会导致 IMKit 中无奈自动更新 UI！
      */
      @protocol RCIMClientReceiveMessageDelegate <NSObject>
      ​
      /*!
      申请音讯已读回执（收到须要浏览时发送回执的申请，收到此申请后在会话页面曾经展现该 messageUId 对应的音讯或者调用
      getHistoryMessages 获取音讯的时候，蕴含此 messageUId 的音讯，须要调用 sendMessageReadReceiptResponse
      接口发送音讯浏览回执）
      ​
      @param messageUId       申请已读回执的音讯 ID
      @param conversationType conversationType
      @param targetId         targetId
      */

      • (void)onMessageReceiptRequest:(RCConversationType)conversationType
        targetId:(NSString *)targetId
        messageUId:(NSString *)messageUId;

      在代理办法中，调用上面接口发送浏览回执响应给发送方

      /*!
      发送浏览回执
      ​
      @param conversationType 会话类型
      @param targetId         会话 ID
      @param messageList      曾经浏览了的音讯列表
      @param successBlock     发送胜利的回调
      @param errorBlock       发送失败的回调 [nErrorCode: 失败的错误码]
      ​
      @discussion 当用户浏览了须要浏览回执的音讯，能够通过此接口发送浏览回执，音讯的发送方即可间接晓得那些人曾经浏览。
      ​
      @remarks 高级性能
      */

      • (void)sendReadReceiptResponse:(RCConversationType)conversationType
        targetId:(NSString *)targetId
        messageList:(NSArray<RCMessage *> *)messageList
        success:(void (^)(void))successBlock
        error:(void (^)(RCErrorCode nErrorCode))errorBlock;

    总结

    浏览回执须要辨别会话类型解决，且单聊的浏览回执是针对会话的，群聊的浏览回执是针对某一条音讯的：

    单聊：接管方浏览某个会话的音讯后，发送浏览回执 ——发送方接到浏览回执，更新 UI

    群聊：发送方发送音讯 A，针对该音讯，发送浏览回执申请 —— 接管方实现监听代理，接管到音讯 A 的浏览回执申请 —— 接管方发送浏览回执响应 —— 发送方收到浏览回执响应，更新 UI

退出移动版