频道

注意: QQ频道功能目前还在测试阶段, go-cqhttp 也在适配的初期阶段, 以下 API Event 的字段名可能存在错误并均有可能在后续版本修改/添加/删除. 目前仅供开发者测试以及适配使用

QQ频道相关说明

命名说明

API以及字段相关命名均为参考QQ官方命名或相似产品命名规则, 由于QQ频道的账号系统独立于QQ本体, 所以各个 ID 并不能和QQ通用.也无法通过 tiny_id 获取到 QQ号

下表为常见字段命名说明

命名	说明
tiny_id	在频道系统中代表用户ID, 与QQ号并不通用
guild_id	频道ID
channel_id	子频道ID

所有频道相关事件的 user_id 均为 tiny_id

特殊说明

• 由于频道的限制, 目前无法通过图片摘要查询到频道图片消息的详细信息, 所以通过频道消息收到的图片均会下载完整文件到 images/guild-images. (群图片转发不受此限制)
• 由于无法通过 GlobalID 放下频道消息的ID, 所以所有频道消息的 message_id 均为 string 类型
• send_msg API将无法发送频道消息
• get_msg API暂时无法获取频道消息
• reply 等消息类型暂不支持解析
• at 消息的 target 依然使用 qq 字段, 以保证一致性. 但内容为 tiny_id
• 所有事件的 self_id 均为 BOT 的QQ号. tiny_id 将放在 self_tiny_id 字段
• 遵循我们一贯的原则, 将不会支持主动加频道/主动拉人/红包相关消息类型
• 频道相关的API仅能在 Android Phone 和 iPad 协议上使用.
• 由于频道相关ID的数据类型均为 uint64 , 为保证不超过某些语言的安全值范围, 在 v1.0.0-beta8-fix3 以后, 所有ID相关数据将转换为 string 类型, API调用 uint64 或 string 均可接受.
• 为保证一致性, 所有频道接口返回的 用户ID 均命名为 tiny_id, 所有频道相关接口的 用户ID 入参均命名为 user_id