更新时间: 2021-03-08

# 功能描述

开发者可使用此功能实现消息已读未读功能的展示。

当 A 给 B 发送了一条消息,B 在未阅读之前 A 用户显示未读,当 B 用户阅读并调用发送回执接口之后,A 用户可在监听回执中收到通知,此时可根据对应的数据内容将发送的消息显示为已读。

此功能目前仅在 GROUP 类型的会话中开放。用户可以对自己发送的消息发起阅读回执请求,发起后,可以看到有多少人阅读过这条消息。

# 发起方

发送阅读回执请求

"提示"

对于需要阅读之后收到阅读回执的消息,可以调用这个接口来发送阅读回执请求。
已复制
参数 类型 说明
message RCMessage 要求阅读回执的消息
successBlock void 发送请求成功的回调
errorBlock void 发送请求失败的回调 [nErrorCode: 失败的错误码]
- (void)sendReadReceiptRequest:(RCMessage *)message
                       success:(void (^)(void))successBlock
                         error:(void (^)(RCErrorCode nErrorCode))errorBlock;
已复制
1
2
3

接收阅读回执响应

"提示"

收到消息阅读回执响应的回调函数(收到此响应后,可以从消息中获取获取到阅读回执消息的 `messageUId` 和 阅读消息用户的列表,消息的发送方即可直接知道哪些人已经阅读。)
已复制
参数 类型 说明
conversationType RCConversationType 会话类型
targetId NSString 目标会话 Id
messageUId NSString 阅读回执消息的 messageUId
userIdList NSMutableDictionary 发送阅读回执响应的用户列表
- (void)onMessageReceiptResponse:(RCConversationType)conversationType 
						targetId:(NSString *)targetId 
					  messageUId:(NSString *)messageUId 
					  readerList:(NSMutableDictionary *)userIdList;
已复制
1
2
3
4

# 接收方

接收阅读回执请求

"提示"

收到消息已读回执请求的回调函数(收到此请求后,如果用户阅读了对应的消息,需要调用 `sendMessageReadReceiptResponse` 接口发送已读响应。)
已复制
参数 类型 说明
conversationType RCConversationType 会话类型
targetId NSString 目标会话 Id
messageUId NSString 收到阅读回执请求消息的 messageUId
- (void)onMessageReceiptRequest:(RCConversationType)conversationType 
					   targetId:(NSString *)targetId 
					 messageUId:(NSString *)messageUId;
已复制
1
2
3

发送阅读回执响应

"提示"

当收到阅读回执请求之后,如果用户阅读了对应的消息,可以调用此接口来发送消息阅读回执响应。
已复制
参数 类型 说明
conversationType RCConversationType 会话类型
targetId NSString 目标会话 Id
messageList NSArray 已经阅读了的消息列表
successBlock void 发送成功的回调
errorBlock void 发送失败的回调 [nErrorCode: 失败的错误码]
- (void)sendReadReceiptResponse:(RCConversationType)conversationType
                       targetId:(NSString *)targetId
                    messageList:(NSArray<RCMessage *> *)messageList
                        success:(void (^)(void))successBlock
                          error:(void (^)(RCErrorCode nErrorCode))errorBlock;
已复制
1
2
3
4
5

文档是否解决您的问题 ?

如果遇到产品相关问题,您可 提交工单 寻求帮助