乐趣区

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

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

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

    • 文档:https://docs.rongcloud.cn/v4-…
    • 官网: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 高级性能
       */
                       targetId:(NSString *)targetId
                           time:(long long)timestamp
                        success:(void (^)(void))successBlock
                          error:(void (^)(RCErrorCode nErrorCode))errorBlock;
 ```

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

 ```objective-c
 /*!
  @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 高级性能
     */
                        success:(void (^)(void))successBlock
                          error:(void (^)(RCErrorCode nErrorCode))errorBlock;
 ```

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

 ```objective-c
 /*!
  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 的浏览回执申请

 ```objective-c
 /*!
  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;
 ```

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

 ```objective-c
 /*!
  发送浏览回执
 
  @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

退出移动版