API 参考 / 能力接口(capability 包)
TrackStyleQuery
轨道样式查询参数,由宿主在 TrackStyleProvider.styleFor 调用时构造,每帧构造,勿长期持有。
方法速览
| 方法 | 用途 |
|---|---|
trackId() | 轨道标识 |
isFake() | 是否假轨道 |
index() | 真轨 lane 序号 / 假轨 id |
完整签名
java
public interface UiCustomization {
interface TrackStyleQuery {
String trackId();
boolean isFake();
int index();
}
}trackId()
签名:
java
String trackId();行为:轨道标识。真轨道为 "lane_0" .. "lane_{n-1}";假轨道为 "fake_{id}"(id 为 fake_track_create 配置的假轨道 id)。画布原点模式的假轨道(originLane = -1)同样可被覆盖,可用 keyText 替换默认的 "?" 占位。
示例:
java
if ("lane_0".equals(query.trackId())) { /* 第一条真轨 */ }isFake()
签名:
java
boolean isFake();行为:true 表示假轨道(装饰 / 特殊轨道),false 表示参与判定的真轨道。
示例:
java
if (query.isFake()) {
return null; // 假轨道保持默认
}index()
签名:
java
int index();行为:真轨道返回 lane 序号(0-based,与 "lane_N" 的 N 一致);假轨道返回假轨道 id(整数)。不要用它推断真假——配合 isFake() 使用。
示例:
java
int lane = query.index();
boolean first = !query.isFake() && lane == 0;线程:游戏渲染线程。
稳定性:2.0 起冻结:2.x 内只增不破。