API 参考 / spi 包:游戏模式、谱面扩展与内容
ComboBehavior
想先跑起来?
这一页是签名与行为参考。这一档判定对连击做什么。直接做一遍:教程 · 添加判定等级。
判定等级对连击(combo)的影响行为枚举,由 JudgmentKindDefinition.comboBehavior() 返回。宿主直接 switch 该枚举,因此实现不得返回 null。
常量
| 常量 | 含义 |
|---|---|
INCREMENT | combo 递增(如 PERFECT、GREAT) |
RESET | combo 归零(如 MISS) |
NONE | combo 不变(特殊判定,如未判定 NONE) |
方法速览
| 方法 | 用途 |
|---|---|
values() | 按声明顺序返回全部常量 |
valueOf(String) | 按名称取常量,名称非法时抛 IllegalArgumentException |
values()
签名:
java
public static ComboBehavior[] values();行为:返回 {INCREMENT, RESET, NONE},每次调用返回新数组。
valueOf(String name)
签名:
java
public static ComboBehavior valueOf(String name);行为:按名称精确匹配(区分大小写);null 或未知名称抛 IllegalArgumentException。
示例
java
ComboBehavior behavior = ComboBehavior.RESET;完整签名
java
public enum ComboBehavior {
INCREMENT,
RESET,
NONE
}线程:源码未声明额外线程约束;枚举常量不可变,可跨线程读取。
生命周期阶段:运行期读取。
稳定性:2.0 起冻结:2.x 内只增不破(禁止删签名/改签名/改语义)。