API 参考 / 事件系统
EventPriority
想先跑起来?
这一页是签名与行为参考。先收谁的后收谁的。直接做一遍:教程 · 订阅游玩事件。
监听器优先级。枚举声明顺序即执行顺序:HIGHEST 最先收到事件,LOWEST 最后;同一优先级内按注册顺序(稳定序)。
常量
| 常量 | 相对次序 | 用途 |
|---|---|---|
HIGHEST | 最先收到 | 抢先否决或强行放行 |
HIGH | 较早收到 | 压过默认优先级意见的干预 |
NORMAL | 默认 | 单参数 subscribe 走此级 |
LOW | 较晚收到 | 常规观察 |
LOWEST | 最后收到 | 纯观察 / 记录(可看到其它监听器处理后的最终状态) |
方法速览
| 方法 | 用途 |
|---|---|
values() | 按声明顺序返回全部常量 |
valueOf(String) | 按名称取常量 |
values()
java
public static EventPriority[] values();行为:返回 {HIGHEST, HIGH, NORMAL, LOW, LOWEST},每次调用返回新数组。
valueOf(String name)
java
public static EventPriority valueOf(String name);行为:按名称精确匹配;null 或未知名称抛 IllegalArgumentException。
示例
java
ctx.eventBus().subscribe(NoteJudgedEvent.class, EventPriority.LOW, event -> {
// 观察型:等干预型监听器先表态
});完整签名
java
public enum EventPriority {
HIGHEST,
HIGH,
NORMAL,
LOW,
LOWEST
}稳定性:2.0 起冻结,2.x 内只增不破。