撤回消息

发送方可以撤回一条发送成功的消息，包括已经发送的历史消息，离线消息或漫游消息。若你当前套餐不支持该功能，需升级产品套餐。

默认情况下，发送方可撤回发出 2 分钟内的消息。你可以联系声网商务延长消息撤回时长，该时长不超过 7 天。

提示

除了透传消息，其他各类型的消息都支持撤回。

技术原理

即时通讯 IM 通过 ChatManager 和 ChatMessage 类支持你撤回一条发送成功的消息：

• recallMessage：撤回一条发送成功的消息。

前提条件

开始前，请确保满足以下条件：

• 完成 SDK 初始化，详见 快速开始。
• 了解即时通讯 IM 的使用限制，详见 使用限制。
• 产品套餐包支持消息撤回功能。

实现方法

撤回消息

你可以调用 recallMessage 方法撤回一条发送成功的消息。调用该方法后，服务端的该条消息（历史消息，离线消息或漫游消息）以及消息发送方和接收方的内存和数据库中的消息均会被移除，消息的接收方会收到 onMessageRecalledWithExt 事件。

提示

附件类型消息，包括图片、音频和视频和文件消息，撤回消息后，消息附件也相应删除。

• 同步方法：

// 你可以通过 `ext` 字段传入自定义字符串，设置扩展信息。
try {
    ChatClient.getInstance().chatManager().recallMessage(message,ext);
    EMLog.d("TAG", "撤回消息成功");
} catch (EMException e) {
    e.printStackTrace();
    EMLog.e("TAG", "撤回消息失败的原因: "+e.getDescription());
}

• 异步方法：

ChatClient.getInstance().chatManager().asyncRecallMessage(message,ext,new CallBack() {
    @Override
    public void onSuccess() {
        EMLog.d("TAG", "撤回消息成功");
    }
    @Override
    public void onError(int errorCode, String errorMessage) {
        EMLog.e("TAG", "撤回消息失败的原因: "+errorMessage);
    }
    @Override
    public void onProgress(int i, String s) {
    }
});

设置消息撤回监听

你可以设置消息撤回监听，通过 onMessageRecalledWithExt 事件监听发送方对已接收的消息的撤回。该事件的 RecallMessageInfo 中的 recallBy 为消息撤回者的用户 ID，recallMessageId 为撤回的消息 ID，ext 为扩展信息，conversationId 为撤回的消息所属的会话 ID。

• 若用户在线接收了消息，消息撤回时，该事件中的 RecallMessageInfo 中的 recallMessage 为撤回的消息的内容。
• 若消息发送和撤回时接收方离线，该事件中的 RecallMessageInfo 中的 recallMessage 为空。

void onMessageRecalledWithExt(List<RecallMessageInfo> recallMessageInfo){}