ctx.config 管理音量、文字速度、跳过策略等玩家运行时配置。

​
API

方法返回值说明
get(key)对应 key 的值读取一项配置
set(key, value)void | Promise<void>修改一项配置
reset()Promise<void>恢复设置界面管理的默认值
snapshot()EngineConfigSnapshot获取全部配置快照
useValue(key)[value, setter]React Hook；订阅一项配置

​
配置项

Key类型说明
skipMode"all" | "read"跳过全部内容或只跳已读内容
textSpeednumber每个字的显示间隔（ms）
autoModeTextSpeednumber自动模式的文字间隔（ms）
stopVoiceOnNextDialogueboolean下一句对话时是否停止当前语音
masterVolumenumber主音量，通常为 0～100
bgmVolumenumberBGM 音量，通常为 0～100
seVolumenumber音效音量，通常为 0～100
voiceVolumenumber语音音量，通常为 0～100

​
案例：把主音量调整到 65

输入： 当前 masterVolume 为 100，玩家把音量滑块拖到 65。 
const before = ctx.config.get("masterVolume");
await ctx.config.set("masterVolume", 65);
const after = ctx.config.get("masterVolume");

console.log({ before, after });
输出： 
{
  "before": 100,
  "after": 65
}
主音量立即按新值生效。React 设置面板中使用 useValue("masterVolume") 的组件也会重新渲染。