撤回消息
超级群业务中,消息发送方可撤回已发送成功的消息。撤回成功后,服务端即删除原始消息。
撤回指定消息,只有已发送成功的消息可被撤回。
撤回指定消息
方法
recallUltraGroupMessage(message: RCIMIWMessage, deleteRemote: boolean): Promise<number>;
参数说明
参数 | 类型 | 说明 |
---|---|---|
message | RCIMIWMessage | 本地消息ID |
deleteRemote | boolean | 指定移动端发送方与接收方是否需要从本地删除原始消息记录。为 false 时,移动端不会删除原始消息记录,会将消息内容替换为撤回提示(小灰条通知)。为 true 时,移动端会删除原始消息记录,不显示撤回提示(小灰条通知)。 |
返回值
返回值 | 描述 |
---|---|
Promise<number> | 当次接口操作状态码,并不代表最终操作结果,状态码详细信息 |
代码示例
engine.recallUltraGroupMessage(
message,
deleteRemote
)
.then((code: number) => {});
回调方法
- setOnUltraGroupMessageRecalledListener
setOnUltraGroupMessageRecalledListener(listener?: (code: number, message: RCIMIWMessage, deleteRemote: boolean) => void): void;
参数说明
参数 | 类型 | 说明 |
---|---|---|
code | number | 接口回调的状态码,0 代表成功,非 0 代表出现异常 |
message | RCIMIWMessage | 撤回的消息 |
deleteRemote | boolean | 指定移动端发送方与接收方是否需要从本地删除原始消息记录。为 false 时,移动端不会删除原始消息记录,会将消息内容替换为撤回提示(小灰条通知)。为 true 时,移动端会删除原始消息记录,不显示撤回提示(小灰条通知)。 |
代码示例
engine.setOnUltraGroupMessageRecalledListener(
(
code: number,
message: RCIMIWMessage,
deleteRemote: boolean
) => {}
);
监听远端消息撤回
当 SDK 与融云服务器的连接状态发生变化时,开发者可通过下面方法进行处理。
方法
setOnRemoteUltraGroupMessageRecalledListener(listener?: (messages: Array<RCIMIWMessage>) => void): void;
参数说明
参数 | 类型 | 说明 |
---|---|---|
status | RCIMIWConnectionStatus | SDK 与融云服务器当前的连接状态 |
代码示例
engine.setOnRemoteUltraGroupMessageRecalledListener(
(
messages: Array<RCIMIWMessage>
) => {}
);