del_group_album_media

删除群相册中的图片或视频。

js

await api.del_group_album_media({ self_id: 1060221, group_id: 123456789, album_id: 'album-id', lloc: 'media-lloc' })

self_id、group_id、album_id、lloc 均必填。删除视频时可以填写视频 ID 或封面 lloc；框架会先读取媒体列表，补齐 QQ 删除协议需要的封面标识和批次 ID。

适用协议: 仅 Android
使用前准备: 目标 Bot 必须属于当前插件节点并处于在线状态；涉及群或好友操作时，账号还必须具备对应 QQ 权限。

选择协议

const androidApi = api.forProtocol('android') // 省略时也默认 Android

原始 action 请求只使用附件约定的 client_type: 'android' | 'linuxqq'；省略时选择 Android。

建议搭配

get_bot_info

常见失败原因

bot 不属于本节点
bot 未在线或账号状态不符合要求
client_type 无效或目标协议不支持该 action

注意事项

省略协议选择器时默认 Android；若指定 Linux，框架会明确拒绝，不会转交同 QQ 的 Android 实例。