游戏叙事与剧情 / 系统课时
把玩家选择送回运行时
把玩家选择送回运行时
Ink 把当前可选项暴露给游戏界面后,故事会停在选择点等待输入。界面真正需要送回运行时的不是按钮文本,而是当前选项对应的索引;运行时接收索引后推进状态,再产生下一段文本和下一批选项,形成完整交互闭环。
学习目标
- 能把
currentChoices映射为可点击的界面选项 - 能使用正确的选择索引推进 Ink 运行时
- 能在一次选择后继续读取文本并重新渲染选项
选择点为什么会暂停
游戏通常先循环读取 Continue(),直到 canContinue 变为 false。此时并不一定意味着故事结束:如果 currentChoices 中还有内容,说明 Ink 正在等待玩家做出选择。
界面可以显示每个 choice 的 text,但点击后应把当前数组中对应的位置传给 ChooseChoiceIndex(index)。选择完成后,运行时改变故事状态,游戏再回到“继续读取文本”的阶段。

建立界面到运行时的回路
下面的片段示例展示核心控制逻辑。假设 story 已经由编译后的 Ink JSON 创建,renderLine、clearChoices 和 createChoiceButton 是项目自己的界面函数。
function advanceStory() {
while (story.canContinue) {
const line = story.Continue().trim();
if (line) {
renderLine(line);
}
}
clearChoices();
// 当前数组下标就是本轮 ChooseChoiceIndex 需要的索引。
story.currentChoices.forEach((choice, index) => {
createChoiceButton(choice.text, () => {
story.ChooseChoiceIndex(index);
advanceStory();
});
});
}
advanceStory();假设当前 Ink 节点产生“调查房间”和“立刻离开”两个选项,界面依次点击第二个按钮时,关键调用等价于下面的结果。
预期结果
story.ChooseChoiceIndex(1)
随后继续读取被第二个选项选中的剧情分支,并重新渲染新的文本和选项。这里使用的是从 0 开始的运行时索引。界面即使向玩家显示“1、2、3”,也不要直接把这个显示编号当成运行时索引,否则第二个按钮可能被错误地当成索引 2。
不要用选项文本反查选择
把按钮文字重新与 currentChoices 做字符串匹配看似简单,但很脆弱。文案可能重复、经过本地化,也可能在显示层被添加图标或格式。可靠做法是在渲染按钮时就把本轮的索引绑定到点击回调。
判断等待选择还是故事结束
当 canContinue 为 false 时,应继续检查 currentChoices。有选择时进入等待输入状态;没有选择时,当前故事流才可能已经到达终点。这个判断顺序可以避免把“正在等待玩家”误判成“故事播放完毕”。
实际项目还可以在按钮点击后暂时禁用选择区域,等 ChooseChoiceIndex 和下一轮 advanceStory() 完成后再开放新按钮。这样界面输入、Ink 状态推进和下一轮渲染始终保持一一对应,玩家的一次点击就只会产生一次剧情推进。