游戏叙事与剧情 / 系统课时

用外部函数调用游戏逻辑

用外部函数调用游戏逻辑

Ink 适合决定剧情走向,但发奖励、播放音效、开启任务等行为必须由 Unity 执行。本节把两侧通过外部函数连接起来,并明确绑定时机、参数边界与失败处理,让剧情能触发玩法而不直接依赖具体组件。

学习目标

  • 在 Ink 中声明外部函数,并在 Unity 的 Story 上完成绑定
  • 让剧情参数安全地进入游戏逻辑,同时保持剧情层与玩法层解耦
  • 理解外部函数的绑定时机、生命周期和常见失败原因

外部函数承担什么边界

Ink 外部函数可以理解为剧情层发给游戏层的一条“命令”。Ink 只表达“此时要发 10 金币”,不负责查找玩家对象、修改背包组件或播放特效;Unity 接收参数后,再调用真正的游戏服务。

这种边界比直接把所有玩法状态塞进 Ink 更稳定。奖励规则、存档、音频、任务系统仍由 Unity 管理,Ink 只决定何时触发它们。这样即使后续重构背包系统,也不需要批量修改剧情脚本。

Ink 调用 Unity 外部函数的时序

完成一次可运行绑定

假设项目已经安装 Ink Unity Integration,新建 reward.ink。EXTERNAL 只声明函数签名,真正实现由 Unity 提供。

text
EXTERNAL grant_coins(amount)

You found a hidden purse.
~ grant_coins(10)
The reward has been added.

-> END

让插件编译该 .ink 文件,然后把生成的 JSON TextAsset 拖到下面组件的 inkJsonAsset 字段。组件创建 Story 后立即绑定函数,再开始推进剧情。

csharp
using Ink.Runtime;
using UnityEngine;

public class InkExternalFunctionDemo : MonoBehaviour
{
    [SerializeField] private TextAsset inkJsonAsset;

    private Story story;
    private int coins;

    private void Start()
    {
        story = new Story(inkJsonAsset.text);

        // 绑定名必须与 Ink 中的 EXTERNAL 名称完全一致。
        story.BindExternalFunction("grant_coins", (int amount) =>
        {
            GrantCoins(amount);
        });

        string text = story.ContinueMaximally().Trim();
        Debug.Log(text);
    }

    private void GrantCoins(int amount)
    {
        if (amount <= 0)
        {
            Debug.LogWarning($"Ignored invalid reward: {amount}");
            return;
        }

        coins += amount;
        Debug.Log($"Coins = {coins}");
    }

    private void OnDestroy()
    {
        if (story != null)
        {
            story.UnbindExternalFunction("grant_coins");
        }
    }
}

预期输出如下。Unity 具体日志时间戳可能不同,但消息内容应一致。

text
Coins = 10
You found a hidden purse.
The reward has been added.

这里故意把 GrantCoins 留在 Unity 侧。真实项目中,它通常会继续调用 InventoryService、QuestService 或事件总线,而不是让 Ink 知道这些实现细节。

绑定时机比调用位置更重要

BindExternalFunction 必须发生在剧情执行到对应外部调用之前。最稳妥的做法是在创建 Story 后统一完成所有绑定,再允许 UI 调用 Continue()、ChooseChoiceIndex() 等推进接口。

如果同一个 Story 会长期存在,通常只绑定一次即可。销毁剧情实例时可以解除绑定,避免对象生命周期已经结束但旧委托仍引用 Unity 对象。若你每次切章节都会新建 Story,也应对每个新实例重新绑定。

什么时候适合用外部函数

外部函数最适合“剧情触发一次游戏行为”的场景,例如发放物品、播放一次音效、解锁成就、启动战斗或通知任务系统。它不适合持续轮询 Unity 状态;玩家属性、任务进度这类需要参与大量剧情判断的数据,更适合先同步为 Ink 变量,再由剧情条件读取。

把外部函数当成跨边界命令后,职责会很清楚:Ink 决定何时发生,Unity 决定怎样发生。这条边界能显著减少剧情文件对场景对象和具体组件的硬编码依赖。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用外部函数调用游戏逻辑

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通