Theseus 模组文档
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 内只增不破。