通知事件
注意
对于 Shamrock 未实现的事件,会在标题添加标记 未实现
提示
所有上报事件都包含通用数据,详见 通用数据。
包含在通用数据中的字段不会在下面的表格中重复出现。
私聊消息撤回
当 notice_type
为 friend_recall
时,表示收到了私聊消息撤回事件。
字段 | 类型 | 说明 |
---|---|---|
user_id | int64 | 好友 QQ 号 |
operator_id | int64 | 操作者 QQ 号 |
message_id | int64 | 消息 ID |
群聊消息撤回
当 notice_type
为 group_recall
时,表示收到了群聊消息撤回事件。
字段 | 类型 | 说明 |
---|---|---|
group_id | int64 | 群号 |
user_id | int64 | 发送者 QQ 号 |
operator_id | int64 | 操作者 QQ 号 |
message_id | int64 | 消息 ID |
群组成员增加
当 notice_type
为 group_increase
时,表示收到了群组成员增加事件。
字段 | 类型 | 说明 |
---|---|---|
group_id | int64 | 群号 |
user_id | int64 | 新增成员 QQ |
operator_id | int64 | 操作者 QQ 号 |
operator_uid | string | 操作者 UID |
user_uid | string | 新成员 UID |
sub_type | string | 子类型(approve/invite) |
群组成员减少
当 notice_type
为 group_decrease
时,表示收到了群组成员减少事件。
字段 | 类型 | 说明 |
---|---|---|
group_id | int64 | 群号 |
user_id | int64 | 减少成员 QQ |
operator_id | int64 | 操作者 QQ 号 |
operator_uid | string | 操作者 UID |
user_uid | string | 新成员 UID |
sub_type | string | 子类型(leave/kick/kick_me) |
群组管理员变动
当 notice_type
为 group_admin
时,表示收到了群组管理员变动事件。
字段 | 类型 | 说明 |
---|---|---|
group_id | int64 | 群号 |
user_id | int64 | 变动成员 QQ |
sub_type | string | 子类型(set/unset) |
群文件上传
当 notice_type
为 group_upload
时,表示收到了群文件上传事件。
字段 | 类型 | 说明 |
---|---|---|
group_id | int64 | 群号 |
user_id | int64 | 上传者 QQ |
file | object | 群文件信息 |
群文件信息结构体
字段名 | 数据类型 | 说明 |
---|---|---|
id | string | 文件 ID |
name | string | 文件名 |
size | int64 | 文件大小 ( 字节数 ) |
busid | int64 | busid ( 目前不清楚有什么作用 ) |
url | string | 下载地址 |
私聊文件上传
当 notice_type
为 private_upload
时,表示收到了群文件上传事件。
字段 | 类型 | 说明 |
---|---|---|
user_id | int64 | 上传者 QQ |
sender | int64 | 上传者 QQ |
private_file | object | 私聊文件信息 |
私聊文件信息结构体
字段名 | 数据类型 | 说明 |
---|---|---|
id | string | 文件 ID |
name | string | 文件名 |
size | int64 | 文件大小 ( 字节数 ) |
url | string | 下载地址 |
sub_id | string | 子文件ID |
exppire | int64 | 文件过期时间 |
群禁言
当 notice_type
为 group_ban
时,表示收到了群禁言事件。
字段 | 类型 | 说明 |
---|---|---|
group_id | int64 | 群号 |
user_id | int64 | 被禁言成员 QQ |
operator_id | int64 | 操作者 QQ |
duration | int64 | 禁言时长(秒) |
sub_type | string | 子类型(ban/lift_ban) |
群成员名片变动
当 notice_type
为 group_card
时,表示收到了群成员名片变动事件。
字段 | 类型 | 说明 |
---|---|---|
group_id | int64 | 群号 |
user_id | int64 | 变动成员 QQ |
card_new | string | 新名片 |
card_old | string | 旧名片 |
未实现
好友添加当 notice_type
为 friend_add
时,表示收到了好友添加事件。
字段 | 类型 | 说明 |
---|---|---|
user_id | int64 | 新添加好友 QQ 号 |
未实现
收到离线文件当 notice_type
为 offline_file
时,表示收到了离线文件事件。
字段 | 类型 | 说明 |
---|---|---|
user_id | int64 | 发送者 QQ |
file | object | 文件信息 |
文件信息
字段 | 类型 | 说明 |
---|---|---|
name | string | 文件名 |
size | int64 | 文件大小 |
url | string | 下载链接 |
精华消息
当 notice_type
为 essence
时,表示收到了精华消息事件。
字段 | 类型 | 说明 |
---|---|---|
group_id | int64 | 群号 |
sender_id | int64 | 发送者 QQ |
operator_id | int64 | 操作者 QQ |
message_id | int64 | 消息 ID |
sub_type | string | 子类型(add/delete) |
未实现
客户端状态当 notice_type
为 client_status
时,表示收到了客户端状态事件。
字段 | 类型 | 说明 |
---|---|---|
client | object | 客户端信息 |
online | bool | 在线状态 |
头像戳一戳
当 notice_type
为 notify
且 sub_type
为 poke
时,表示收到了头像戳一戳事件。
字段 | 类型 | 说明 |
---|---|---|
user_id | int64 | 发送者 QQ |
sender_id | int64 | 好友 QQ (仅私聊) |
group_id | int64 | 群号(仅群聊) |
target_id | int64 | 被戳者 QQ |
poke_detail | PokeDetail | 戳一戳的详细信息 |
PokeDetail
字段 | 类型 | 说明 |
---|---|---|
action | string | 操作名称,如“戳了戳” |
suffix | string | 后缀,未设置则未空 |
action_img_url | string | 操作图标 |
未实现
群红包运气王当 notice_type
为 notify
且 sub_type
为 lucky_king
时,表示收到了群红包运气王事件。
字段 | 类型 | 说明 |
---|---|---|
group_id | int64 | 群号 |
user_id | int64 | 发送者 |
target_id | int64 | 运气王 |
未实现
群荣誉变更当 notice_type
为 notify
且 sub_type
为 honor
时,表示收到了群荣誉变更事件。
字段 | 类型 | 说明 |
---|---|---|
group_id | int64 | 群号 |
user_id | int64 | 操作者 |
honor_type | string | 荣誉类型 |
群头衔变更
当 notice_type
为 notify
且 sub_type
为 title
时,表示收到了群头衔变更事件。
字段 | 类型 | 说明 |
---|---|---|
group_id | int64 | 群号 |
user_id | int64 | 操作者 |
title | string | 获得头衔 |