跳转到正文

事件总览

萌喵插件可订阅的群聊消息、好友消息、群聊事件与好友事件说明及回调约定。

消息与事件均通过可选导出函数投递。未导出对应回调时,主程序不会向插件投递该类数据。

通用约定

  • 回调有效期:传入的结构体及其所有字符串均非 NULL,且仅在当前回调期间有效。异步或延后处理必须先复制所需字段。
  • 并发与性能:不同账号的消息与事件可能由多个线程并发投递;同一账号按到达顺序依次投递。不要在回调中直接调用网络接口,应复制到插件工作线程处理。
  • 事件独立于聊天开关:群聊事件和好友事件不受聊天消息开关控制,也不计入聊天消息接收数。
  • 不自动执行动作:收到入群请求或好友申请事件后,框架不会自动同意、拒绝或标记已读;需要处理时请原样保存完整 data 字符串并在工作线程中调用处理接口。
  • 未知内容:遇到未列出的 event_type、消息段或 JSON 字段按未知内容处理,不要猜测其业务含义。

回调一览

分类导出函数说明
群聊消息on_group_message群聊收到的消息内容、发送人身份、群名片与头衔
好友消息on_friend_message好友私聊收到的消息内容与显示名
群聊事件on_group_event管理员变更、成员入群、成员减少/解散、群请求、入群申请被拒
好友事件on_friend_event自身状态变更、昵称变更、备注变更、好友关系移除、好友申请

本页目录