事件
原始事件
我们根据 OneBot11 协议中定义的所有事件结构， 在模块 simbot-component-onebot-v11-event 中提供了所有的实现类型。 它们是最基础的可序列化数据类，不含有任何功能。
- 元事件 RawMetaEvent
- 消息事件 RawMessageEvent
- 请求事件 RawRequestEvent
- 通知事件 RawNoticeEvent
- 未知事件 UnknownEvent
一个特殊的事件类型。 它是当遇到无法被上述这些类型所解析时使用的兜底类型，比如遇到未知的
type或由于各种原因导致反序列化失败。它不可序列化，除
time、selfId、postType之外直接提供raw属性(也就是原始的JSON字符串)。
组件事件
组件实现是基于simbot标准API中定义的事件类型、对上述原始事件的包装， 并提供相对应的功能性API实现。
- OneBotMessageEvent
与消息相关的事件。
- OneBotGroupMessageEvent
与群消息相关的事件。
- OneBotNormalGroupMessageEvent
与普通群消息相关的事件。
- OneBotAnonymousGroupMessageEvent
与匿名群消息相关的事件。
- OneBotNoticeGroupMessageEvent
与群系统消息通知相关的事件。
- OneBotPrivateMessageEvent
与私聊消息相关的事件。
- OneBotFriendMessageEvent
好友私信消息事件。
- OneBotGroupPrivateMessageEvent
群成员临时会话消息事件。
- OneBotMetaEvent
元数据相关的事件
- OneBotLifecycleEvent
生命周期事件
- OneBotHeartbeatEvent
心跳事件
- OneBotRequestEvent
请求相关的事件
- OneBotFriendRequestEvent
好友添加申请
- OneBotGroupRequestEvent
群添加申请
- OneBotNoticeEvent
通知相关的事件。
- OneBotFriendAddEvent
好友已添加事件
- OneBotFriendRecallEvent
好友消息撤回事件
- OneBotGroupAdminEvent
管理员变动事件
- OneBotGroupBanEvent
群禁言事件
- OneBotGroupChangeEvent
群成员变动事件
- OneBotGroupMemberIncreaseEvent
群成员添加事件
- OneBotGroupMemberDecreaseEvent
群成员离开事件
- OneBotGroupRecallEvent
群消息撤回事件
- OneBotGroupUploadEvent
群文件上传事件
- OneBotNotifyEvent
群荣耀事件、红包人气王事件或戳一戳事件。
- OneBotGroupNotifyEvent
v1.4.0后添加，是OneBotNotifyEvent的子类型，用来描述那些发生在群里的通知事件。- OneBotHonorEvent
群荣耀事件
- OneBotLuckyKingEvent
红包人气王事件
- OneBotPokeEvent
戳一戳事件
- OneBotMemberPokeEvent
戳一戳(普通群成员被戳)事件
- OneBotBotSelfPokeEvent
戳一戳(Bot被戳)事件
- OneBotPrivatePokeEvent
v1.4.0后添加，用来描述私聊里的戳一戳事件，实现OneBotPokeEvent。 此事件中的groupId始终为null。
- OneBotInternalEvent
与OneBot协议本身无关的用于内部流转或拦截的事件。
- OneBotBotStageEvent
与OneBot协议本身无关的Bot的阶段事件。
- OneBotBotRegisteredEvent
一个 `OneBotBot` 被注册了的事件
- OneBotBotStartedEvent
一个 `OneBotBot` 被(首次)启动了的事件
- OneBotInternalMessageInteractionEvent
OneBot 组件中与 Message 交互有关的事件。
基础类型
- OneBotInternalMessagePreSendEvent
OneBot 组件针对消息发送前的拦截事件。 继承
InternalMessagePreSendEvent- OneBotInternalMessagePostSendEvent
OneBot 组件针对消息发送后的通知事件。 继承
InternalMessagePostSendEvent
SendSupport相关类型- OneBotSendSupportInteractionEvent
SendSupport.send的行为事件- OneBotSendSupportPreSendEvent
SendSupport.send的拦截事件- OneBotSendSupportPostSendEvent
SendSupport.send的通知事件
SendSupport相关类型细分子类型- OneBotGroupInteractionEvent
OneBotGroup.send的行为事件- OneBotGroupPreSendEvent
OneBotGroup.send的拦截事件- OneBotGroupPostSendEvent
OneBotGroup.send的通知事件
- OneBotFriendInteractionEvent
OneBotFriend.send的行为事件- OneBotFriendPreSendEvent
OneBotFriend.send的拦截事件- OneBotFriendPostSendEvent
OneBotFriend.send的通知事件
- OneBotMemberInteractionEvent
OneBotMember.send的行为事件- OneBotMemberPreSendEvent
OneBotMember.send的拦截事件- OneBotMemberPostSendEvent
OneBotMember.send的通知事件
ReplySupport(MessageEvent) 相关类型- OneBotMessageEventInteractionEvent
OneBotMessageEvent.reply的行为事件- OneBotMessageEventPreReplyEvent
OneBotMessageEvent.reply的拦截事件- OneBotMessageEventPostReplyEvent
OneBotMessageEvent.reply的通知事件
ReplySupport(MessageEvent) 相关类型细分子类型群聊相关
- OneBotGroupMessageEventInteractionEvent
OneBotGroupMessageEvent.reply的行为事件- OneBotGroupMessageEventPreReplyEvent
OneBotGroupMessageEvent.reply的拦截事件- OneBotGroupMessageEventPostReplyEvent
OneBotGroupMessageEvent.reply的通知事件- OneBotNormalGroupMessageEventInteractionEvent
OneBotNormalGroupMessageEvent.reply的行为事件- OneBotNormalGroupMessageEventPreReplyEvent
OneBotNormalGroupMessageEvent.reply的拦截事件- OneBotNormalGroupMessageEventPostReplyEvent
OneBotNormalGroupMessageEvent.reply的通知事件- OneBotAnonymousGroupMessageEventInteractionEvent
OneBotAnonymousGroupMessageEvent.reply的行为事件- OneBotAnonymousGroupMessageEventPreReplyEvent
OneBotAnonymousGroupMessageEvent.reply的拦截事件- OneBotAnonymousGroupMessageEventPostReplyEvent
OneBotAnonymousGroupMessageEvent.reply的通知事件- OneBotNoticeGroupMessageEventInteractionEvent
OneBotNoticeGroupMessageEvent.reply的行为事件- OneBotNoticeGroupMessageEventPreReplyEvent
OneBotNoticeGroupMessageEvent.reply的拦截事件- OneBotNoticeGroupMessageEventPostReplyEvent
OneBotNoticeGroupMessageEvent.reply的通知事件
私聊相关
- OneBotPrivateMessageEventInteractionEvent
OneBotPrivateMessageEvent.reply的行为类型- OneBotPrivateMessageEventPreReplyEvent
OneBotPrivateMessageEvent.reply的拦截类型- OneBotPrivateMessageEventPostReplyEvent
OneBotPrivateMessageEvent.reply的通知类型- OneBotGroupPrivateMessageEventInteractionEvent
OneBotGroupPrivateMessageEvent.reply的行为类型- OneBotGroupPrivateMessageEventPreReplyEvent
OneBotGroupPrivateMessageEvent.reply的拦截类型- OneBotGroupPrivateMessageEventPostReplyEvent
OneBotGroupPrivateMessageEvent.reply的通知类型- OneBotFriendMessageEventInteractionEvent
OneBotFriendMessageEvent.reply的行为类型- OneBotFriendMessageEventPreReplyEvent
OneBotFriendMessageEvent.reply的拦截类型- OneBotFriendMessageEventPostReplyEvent
OneBotFriendMessageEvent.reply的通知类型
未知事件
OneBotUnknownEvent
是对上述原始事件中的 UnknownEvent 类型的包装。
未支持事件
OneBotUnsupportedEvent
是当出现了原始事件中有(除了 UnknownEvent)、 但是尚未提供对应的组件事件实现的事件类型时用来兜底的类型。
这些原始事件类型会被统一装入此事件中。
事件关系
简单列举一下原始事件与可能对应的组件事件之间的关系。
原始事件类型 | 组件事件 |
|---|---|
|
|
> | > |
> | > |
|
|
> | > |
> | > > |
> | > > |
> | > > |
> | > |
> | > > |
> | > > |
|
|
> | > |
> | > |
|
|
> | > |
> | > |
> | > |
> | > |
> | > |
> | > > |
> | > > |
> | > |
> | > |
> | > |
> | > > (since |
> | > > > |
> | > > > |
> | > > > |
> | > > > > |
> | > > > > |
> | > > > > (since |
| > |
无 |
|
无 | > |
无 | > |
任意未支持事件 |
|