API 参考 / 只读视图、场景、音频与文本

SceneInfo

想先跑起来？

这一页是签名与行为参考。场景身份声明。直接做一遍：教程 · 自定义场景。

场景信息只读视图。由 SceneHost#current() / top() / find(String) 返回，模组可据此得知当前处于哪个场景。宿主为模组场景返回其声明 id（内部注册名 _mod_* 不外泄），宿主场景则返回注册名。

方法速览

方法	用途
`id()`	场景唯一标识（路由依据）
`name()`	场景名称（展示用）

java

String id();

行为：场景唯一标识。模组场景返回其 Scene#id() 的声明值；宿主场景返回注册名。路由一律用 id。示例：

java

boolean inMine = "mymod:panel".equals(host.current().id());

java

String name();

行为：场景名称，用于展示，非路由依据。当前宿主对两类场景均返回同一个 id 值。示例：

java

String label = host.current().name();

java

public interface SceneInfo {
    String id();
    String name();
}

线程：源码未声明额外线程约束。

稳定性：2.0 起冻结：2.x 内只增不破。