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