Q&A

以下内容是针对一些问题的解答。未尽之处，欢迎加入 QQ 群 讨论相关细节。

xxx 字段是用 null/undefined 还是用 0/空字符串表示“无值”？

省流：如果这个字段被标记了 optional，那么就大大方方用 null/undefined 表示“无值”；否则就用 0/空字符串表示“无值”。

至于为什么有的字段被标记为 optional，有的没有，这与 Milky 的可空性设计哲学有关，具体如下：

• 如果 null/undefined 和 0/空字符串在语义上是等价的，则不标记为 optional，使用 0/空字符串表示“无值”；
• 如果 null/undefined 和 0/空字符串在语义上不等价，或 0/空字符串是不合法的值（例如时间戳、QQ 号），则标记为 optional，使用 null/undefined 表示“无值”。

message_seq 是否相当于 OneBot 11 中的 message_id？

省流：message_scene + peer_id + message_seq = 完整版 message_id。

message_seq 不是“大号的 message_id”，而是一个自增的数字，表示消息在当前会话中的顺序，对于每个会话（好友或群聊）都是独立的。Milky 用 message_scene、peer_id 和 message_seq 组合来唯一标识一条消息。其中：

• message_scene 是一个字符串，表示消息的场景（例如：好友、群聊等）
• peer_id 是一个数字，表示会话的 ID。对于好友消息，peer_id 是好友的 QQ 号；对于群消息，peer_id 是群号。

OneBot 11 则使用 message_id 来唯一标识一条消息。

消息撤回（recall）和戳一戳（nudge）的事件推送中 display_ 开头的字段指的是什么？

假如一条消息撤回的提示如下：

Salt 撤回了一条消息，并假装无事发生。

那么其对应的 message_recall 事件中的 display_suffix 字段是 并假装无事发生。。

假如一条戳一戳的提示如下：

Milk 戳了戳 Shama 的……。不许戳啦！

那么其对应的 message_nudge 事件中的 display_action 字段是 戳了戳，display_suffix 字段是 的……。不许戳啦！。

forward 消息段中的 title、preview 和 summary 分别指的是什么？

这些是用户在接收到合并转发消息但未展开查看时，看到的预览信息。例如这样一条合并转发消息的预览信息：

群聊的聊天记录      // title
Salt: [动画表情]   // preview[0]
Milk: [图片]      // preview[1]
Shama: [视频]     // preview[2]
---
查看3条转发消息     // summary

file 消息段和 file_upload 事件是同一个东西吗？

是的，包含在消息中的 file 消息段和 friend_file_upload、group_file_upload 事件上报的内容是相同的，都是表示好友 / 群成员上传了文件，两者的字段和含义也完全一致。协议端在收到文件消息后，需要同时推送包含 file 消息段的 IncomingMessage 和 {friend,group}_file_upload 事件，应用端可以按需处理。

二者的主要不同在于用途：前者方便在拉取消息时获取文件信息，后者方便在 event 驱动的应用中处理用户上传的文件。

image、record 和 video 消息段分别支持哪些格式？

• image：协议端至少需要支持 JPG、PNG、GIF、BMP、WEBP 格式的图片；
• record：QQ 使用的语音格式是 SILK 。在发送时，协议端至少需要支持 WAV 和 MP3 格式到 SILK 的转码；
• video：协议端至少需要支持 MP4 格式的视频，并且在用户未提供 thumb_uri 时从视频中截取一帧作为缩略图。

face_id 都有哪些？

以下页面整理了可用的 QQ 表情 ID 列表，供参考：

• Koishi QFace 
• QQ 机器人文档的表情对象 
• 表情 CQ 码 ID 表 

如何获取用户或群的头像？

QQ 有一些公开的 API 可以用来获取头像：

• 用户头像：https://q1.qlogo.cn/g?b=qq&nk=${user_id}&s=${quality}
  • user_id：用户 QQ 号；
  • quality：图片质量，可选值为 100（100x100）、640（640x640）等。
• 群头像：https://p.qlogo.cn/gh/${group_id}/${group_id}/0/
  • group_id：群号。