get_qun_album_list
分页获取群相册列表。接口直接调用 QQ Android 的 QunAlbum.trpc 服务，不依赖 PC QQ。
此接口在已认证的服务连接中调用，账号须属于当前框架且处于在线状态。self_id 与 protocol_id 共同选择账号。
适用协议
Android（手机 / 平板）/ Linux QQ。
调用方式
向已认证的 WebSocket 连接发送：
json
{
"type": "action",
"id": "example-1",
"action": "get_qun_album_list",
"params": {
"self_id": 123456789,
"protocol_id": 0,
"group_id": 987654321
}
}响应通过相同 id 对应请求。连接、HTTP 调用与错误处理见通信协议。
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
self_id | integer | 是 | 当前框架内的账号 QQ 号 |
protocol_id | integer | 是 | 账号协议配置 ID；从 get_protocol_list 获取，必须显式传入，0 也是有效 ID |
group_id | integer | 是 | 目标群号 |
attach_info | string | 否 | 上一页返回的分页游标，首次可省略 |
返回值
以下为成功响应的 data，错误通过 ok: false 与 error 返回。
| 字段 | 类型 | 说明 |
|---|---|---|
album_list | object[] | 相册列表 |
album_list[].id | string | 资源标识 |
album_list[].owner | string | 所属账号 |
album_list[].name | string | 上传后显示的文件名 |
album_list[].desc | string | 内容描述 |
album_list[].create_time | integer | 创建时间 |
album_list[].modify_time | integer | 最后修改时间 |
album_list[].last_upload_time | integer | 最近上传时间 |
album_list[].upload_number | integer | 上传数量 |
album_list[].cover | object | 封面信息 |
album_list[].cover.type | integer | 操作类型，见使用说明 |
album_list[].cover.image | object | 图片来源或图片元信息 |
album_list[].cover.image.name | string | 上传后显示的文件名 |
album_list[].cover.image.sloc | string | 图片资源位置标识 |
album_list[].cover.image.lloc | string | 相册媒体列表返回的媒体位置标识 |
album_list[].cover.image.photo_urls | object[] | 不同规格图片地址 |
album_list[].cover.image.photo_urls[].spec | integer | 资源规格标识 |
album_list[].cover.image.photo_urls[].url | object | 资源地址 |
album_list[].cover.image.photo_urls[].url.url | string | 资源地址 |
album_list[].cover.image.photo_urls[].url.width | integer | 像素宽度 |
album_list[].cover.image.photo_urls[].url.height | integer | 像素高度 |
album_list[].cover.image.default_url | object | 默认图片地址及尺寸 |
album_list[].cover.image.default_url.url | string | 资源地址 |
album_list[].cover.image.default_url.width | integer | 像素宽度 |
album_list[].cover.image.default_url.height | integer | 像素高度 |
album_list[].cover.image.is_gif | boolean | 是否为 GIF |
album_list[].cover.image.has_raw | boolean | 是否有原图 |
album_list[].cover.video | object | 视频信息 |
album_list[].cover.video.id | string | 资源标识 |
album_list[].cover.video.url | string | 资源地址 |
album_list[].cover.video.cover | object | 封面信息 |
album_list[].cover.video.width | integer | 像素宽度 |
album_list[].cover.video.height | integer | 像素高度 |
album_list[].cover.video.video_time | integer | 视频时长 |
album_list[].cover.video.video_urls | object[] | 不同规格视频地址 |
album_list[].cover.video.video_urls[].spec | integer | 资源规格标识 |
album_list[].cover.video.video_urls[].url | object | 资源地址 |
album_list[].cover.video.video_urls[].url.url | string | 资源地址 |
album_list[].cover.video.video_urls[].url.width | integer | 像素宽度 |
album_list[].cover.video.video_urls[].url.height | integer | 像素高度 |
album_list[].cover.uploader | string | 上传者信息 |
album_list[].cover.batch_id | integer | 相册媒体的批次标识 |
album_list[].cover.upload_time | integer | 上传时间 |
album_list[].creator | object | 创建者信息 |
album_list[].creator.uid | string | QQ 原生用户 UID |
album_list[].creator.nick | string | 昵称 |
album_list[].creator.portrait | string | 头像信息 |
album_list[].creator.uin | string | QQ 号 |
album_list[].top_flag | integer | 置顶标识 |
album_list[].status | integer | 处理状态 |
attach_info | string | 上一页返回的分页游标，首次可省略 |
has_more | boolean | 是否还有后续结果 |