get_music_ark

根据 QQ Android 实际接收的音乐分享结构，生成可由 send_msg、send_group_msg 或 send_friend_msg 发送的 Ark 音乐卡片。

此接口在已认证的服务连接中调用，账号须属于当前框架且处于在线状态。self_id 与 protocol_id 共同选择账号。

type 支持 qq、163（或 netease），默认 qq。title 最多 200 字，content 最多 300 字；url、audio、image 须为 HTTP/HTTPS 地址。返回 data 是可放入 ark 消息段的音乐卡片对象。

适用协议

Android / Linux QQ；使用当前账号生成音乐卡片。

调用方式

向已认证的 WebSocket 连接发送：

{
  "type": "action",
  "id": "example-1",
  "action": "get_music_ark",
  "params": {
    "self_id": 123456789,
    "protocol_id": 0,
    "title": "example",
    "content": "你好",
    "url": "https://example.com/song",
    "audio": "https://example.com/song.mp3",
    "image": "https://example.com/cover.jpg"
  }
}

响应通过相同 id 对应请求。连接、HTTP 调用与错误处理见通信协议。

参数

参数	类型	必填	说明
self_id	integer	是	当前框架内的账号 QQ 号
protocol_id	integer	是	账号协议配置 ID；从 get_protocol_list 获取，必须显式传入，0 也是有效 ID
type	string	否	操作类型，见使用说明
title	string	是	专属头衔
content	string	是	正文内容
url	string	是	资源地址
audio	string	是	音乐音频 HTTP/HTTPS 地址
image	string	是	图片来源或图片元信息

返回值

以下为成功响应的 data，错误通过 ok: false 与 error 返回。

字段	类型	说明
data	object	内容对象