API 参考 / 事件系统
HostAudioSpeedEvent
宿主事实转播:全局音乐播放速度发生变化(变速已生效)。覆盖全部经宿主命令通道的调速(游玩内 GameStateAccess#setMusicSpeed、编辑器调速与退出重置);局部变速播放(不改变全局速度)不投递。
方法速览
| 方法 | 用途 |
|---|---|
oldSpeed() | 变速前的播放速度倍率 |
newSpeed() | 变速后的播放速度倍率 |
oldSpeed()
java
public float oldSpeed();行为:返回变速前的播放速度倍率。
newSpeed()
java
public float newSpeed();行为:返回变速后的播放速度倍率。
示例
java
ctx.eventBus().subscribe(HostAudioSpeedEvent.class, event -> {
visualScale = 1.0 / Math.max(0.25f, event.newSpeed());
});完整签名
java
public class HostAudioSpeedEvent extends Event {
public HostAudioSpeedEvent(float oldSpeed, float newSpeed);
public float oldSpeed();
public float newSpeed();
}行为核验:速度已生效,不可取消;转播点在游戏线程内同步投递,保持轻量即可。
稳定性:2.0 起冻结,2.x 内只增不破。