群聊消息回执
用户可以对自己发送的消息发起阅读回执请求,发起后,可以看到有多少人阅读过这条消息。
发起回执请求
发起消息已读回执请求。
方法
TypeScript
sendGroupReadReceiptRequest(
message: RCIMIWMessage,
callback: IRCIMIWSendGroupReadReceiptRequestCallback
): Promise<number>;
参数说明
参数名 | 参数类型 | 描述 |
---|---|---|
message | RCIMIWMessage | 需要请求已读回执的消息 |
callback | IRCIMIWSendGroupReadReceiptRequestCallback | 接口调用结果回调。 |
返回值
返回值 | 描述 |
---|---|
number | 当次接口 操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码 |
代码示例
TypeScript
const callback = {
onGroupReadReceiptRequestSent: (code: number, message: RCIMIWMessage) => {
//...
},
};
let code = await engine.sendGroupReadReceiptRequest(message, callback);
监听群聊回执请求
方法
TypeScript
setOnGroupMessageReadReceiptRequestReceivedListener(listener?: (targetId: string, messageUId: string) => void): void;
参数说明
参数名 | 参数类型 | 描述 |
---|---|---|
targetId | string | 会话 ID |
messageUId | string | 消息的 messageUid |
代码示例
TypeScript
engine?.setOnGroupMessageReadReceiptRequestReceivedListener((targetId: string, messageUId: string) => {
//...
});
响应回执请求
收到了回执请求,接收者需要响应该请求,通知对方已阅读此消息。可以一次响应同一会话中的多条消息。
方法
TypeScript
sendGroupReadReceiptResponse(
targetId: string,
channelId: string,
messages: Array<RCIMIWMessage>,
callback: IRCIMIWSendGroupReadReceiptResponseCallback
): Promise<number>;
参数说明
参数名 | 参数类型 | 描述 |
---|---|---|
targetId | string | 会话 ID |
channelId | string | 频道 ID,仅支持超级群使用,其他会话类型传 null 即可。 |
messages | Array<RCIMIWMessage> | 会话中需要发送 已读回执的消息列表 |
callback | IRCIMIWSendGroupReadReceiptResponseCallback | 接口调用结果回调。 |
返回值
返回值 | 描述 |
---|---|
number | 当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码 |
示例代码
TypeScript
const callback = {
onGroupReadReceiptResponseSent: (code: number, message: Array<RCIMIWMessage>) => {
//...
},
};
let code = await engine.sendGroupReadReceiptResponse(targetId, channelId, messages, callback);