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

PlayingSound

正在播放的音效快照。由 AudioAccess#playingSounds() 返回，描述宿主当前正在播放的一个音效：注册 id、文件路径与类别。

方法速览

java

String id();

行为：注册的音频 id（与 AudioAccess#playSound 使用的 id 相同）。示例：

java

String id = sound.id();

java

String path();

行为：音频文件路径，与注册时一致（供诊断/显示）。示例：

java

String p = sound.path();

java

SoundCategory category();

行为：音频类别，受对应类别音量控制。示例：

java

SoundCategory c = sound.category();

java

public interface PlayingSound {
    String id();
    String path();
    SoundCategory category();
}

关键契约：播放结束或已停止的音效不包含在列表中；仅统计经宿主音效引擎启动且仍在播放的音效，同一音效多实例并发播放时只出现一次。

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

性能：列表可能为空（AudioAccess#playingSounds() 的默认实现返回空列表）。

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