跳到主要内容

删除消息

超级群会话消息存储在服务端（免费存储 7 天）和用户设备本地数据库。App 用户通过客户端 SDK 删除自己的历史消息，支持仅从本地数据库删除消息、或仅从融云服务端删除消息。

提示
  • 客户端的删除消息的操作均指从当前登录用户的历史消息记录中删除消息，不影响会话中其他用户的历史消息记录。
  • 如果 App 的管理员或者某普通用户希望在该 App 中彻底删除一条消息，例如在所有超级群成员的聊天记录中删除一条消息，应使用客户端或服务端的撤回消息功能。消息成功撤回后，原始消息内容会在所有用户的本地与服务端历史消息记录中删除。

删除所有频道指定时间之前的消息​

删除本地单个超级群所有频道指定时间之前的消息。

方法​


clearUltraGroupMessagesForAllChannel(
  targetId: string, 
  timestamp: number, 
  callback: IRCIMIWClearUltraGroupMessagesForAllChannelCallback
): Promise<number>;

参数说明​

参数名参数类型描述
targetIdstring会话 ID
timestampnumber时间戳
callbackIRCIMIWClearUltraGroupMessagesForAllChannelCallback接口调用结果回调。

返回值​

返回值描述
number当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调，非 0 代表当前接口调用操作失败，不会触发接口回调，详细错误参考错误码

代码示例​


const callback = {
    onUltraGroupMessagesClearedForAllChannel: (code: number) => {
        //...
    },
};
let code = await engine.clearUltraGroupMessagesForAllChannel(targetId, timestamp, callback);

删除特定频道指定时间之前的消息​

删除本地单个超级群特定频道指定时间之前的消息。

方法​


clearUltraGroupMessages(
  targetId: string, 
  channelId: string, 
  timestamp: number, 
  policy: RCIMIWMessageOperationPolicy, 
  callback: IRCIMIWClearUltraGroupMessagesCallback
): Promise<number>;

参数说明​

参数名参数类型描述
targetIdstring会话 ID
channelIdstring频道 ID，仅支持超级群使用。
timestampnumber时间戳
policyRCIMIWMessageOperationPolicy清除策略
callbackIRCIMIWClearUltraGroupMessagesCallback接口调用结果回调。

返回值​

返回值描述
number当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调，非 0 代表当前接口调用操作失败，不会触发接口回调，详细错误参考错误码

代码示例​


const callback = {
    onUltraGroupMessagesCleared: (code: number) => {
        //...
    },
};
let code = await engine.clearUltraGroupMessages(targetId, channelId, timestamp, policy, callback);

从服务端删除​

删除服务端单个超级群特定频道指定时间之前的消息。

方法​


clearUltraGroupMessages(
  targetId: string, 
  channelId: string, 
  timestamp: number, 
  policy: RCIMIWMessageOperationPolicy, 
  callback: IRCIMIWClearUltraGroupMessagesCallback
): Promise<number>;

参数说明​

参数名参数类型描述
targetIdstring会话 ID
channelIdstring频道 ID，仅支持超级群使用。
timestampnumber时间戳
policyRCIMIWMessageOperationPolicy清除策略
callbackIRCIMIWClearUltraGroupMessagesCallback接口调用结果回调。

返回值​

返回值描述
number当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调，非 0 代表当前接口调用操作失败，不会触发接口回调，详细错误参考错误码

代码示例​


const callback = {
    onUltraGroupMessagesCleared: (code: number) => {
        //...
    },
};
let code = await engine.clearUltraGroupMessages(targetId, channelId, timestamp, policy, callback);

最后于 更新