sendMessageReadReceipts
Introduction
Send the message read receipt.
After receiving the message, the receiver determines whether the message requires a read receipt based on the needReadReceipt
field in V2TIMMessage
.
If yes, after the user reads the message, the receiver calls the this method to send a read receipt.
This method only works with Ultimate Edition, you can find the pricing plan here.
All the messages provided needs to be in the same group, it group messages provided.
After the receiver sends a message read receipt, the sender can listen for a receipt notification through onRecvMessageReadReceipts
in V2TimAdvancedMsgListener
and update the UI based on the notification to display the message as, for example, "Read by two members".
Do not works on Web.
Works since version 3.9.3.
Specifying a group type for which to support message read receipts: Log in to the IM console, select Feature Configuration > Login and Message > Group Message Read Receipts.
Parameter details
Parameter name | Parameter type | Required | Platform | Description |
---|---|---|---|---|
messageIDList | List< String > | yes | All | The read messages list. |
Returned template
V2TimCallback
{
code : int
desc : String
}
Return value details
name | type | description |
---|---|---|
code | int | Request result: Error codes. 0 means success. |
desc | String | The description of the failure. |
Code example
V2TimValueCallback<V2TimMsgCreateInfoResult> createCustomMessageRes =
await TencentImSDKPlugin.v2TIMManager
.getMessageManager()
.createCustomMessage(
data: 'Typing...',
);
TencentImSDKPlugin.v2TIMManager.getMessageManager().sendMessage(
id: createCustomMessageRes.data!.id!,
receiver: "",
groupID: "groupID",
onlineUserOnly: true,
needReadReceipt: true);
V2TimCallback sendMessageReadReceipts = await TencentImSDKPlugin
.v2TIMManager
.getMessageManager()
.sendMessageReadReceipts(
messageIDList: [createCustomMessageRes.data!.id!]);
if (sendMessageReadReceipts.code == 0) {
} else {
}