recall
撤回消息
撤回指定消息,只有已发送成功的消息可被撤回。
默认情况下,融云对撤回消息的操作者不作限制。如需限制,可考虑以下方案:
- App 客户端自行限制撤回消息的操作者。例如,不允许 App 业务中的普通用户撤回他人发送的消息,允许 App 业务中的管理员角色撤回他人发送的消息。
- 如需避免用户撤回非本人发送的消息,可以提交工单申请打开IMLib SDK 只允许撤回自己发送的消息。从融云服务端进行限制,禁止用户撤回非本人发送的消息。
方法
recallMessage(message: RCIMIWMessage): Promise<number>;
参数说明
参数 | 类型 | 说明 |
---|---|---|
message | RCIMIWMessage | 消息对象 |
返回值
返回值 | 描述 |
---|---|
Promise<number> | 当次接口操作状态码,并不代表最终操作结果,状态码详细信息 |
代码示例
engine.recallMessage(message)
.then((code: number) => {});
回调方法
-
setOnMessageRecalledListener
接口调用结果的监听
setOnMessageRecalledListener(listener?: (code: number, message: RCIMIWMessage) => void): void;
参数说明
参数名 | 参数类型 | 描述 |
---|---|---|
code | number | 接口回调的状态码,0 代表成功,非 0 代表出现异常 |
message | RCIMIWMessage | 调用接口时传入的消息对象 |
代码示例
engine.setOnMessageRecalledListener((code: number, message: RCIMIWMessage) => {});
监听消息撤回事件
用于监听已接收的消息被撤回的事件。当接受到的某条消息被撤回时,会通过此监听器回调。
方法
setOnRemoteMessageRecalledListener(listener?: (message: RCIMIWMessage) => void): void;
参数说明
参数 | 类型 | 说明 |
---|---|---|
message | RCIMIWMessage | 原始消息类型会被标记为已撤回的状态 |
代码示例
engine.setOnRemoteMessageRecalledListener((message: RCIMIWMessage) => {});