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

用 Tag 驱动角色与演出

用 Tag 驱动角色与演出

这一节把 Ink 的 Tag 变成 Unity 演出指令:剧情文本继续由 Ink 管理,Unity 只解析稳定标签并切换角色名、立绘和音效。最终得到的是内容与表现解耦的对话链路,资源改名时不必批量修改 Ink 文本。

学习目标

  • 在 Story.Continue() 之后正确读取 Story.currentTags。
  • 用稳定 ID 映射角色、立绘和音效资源,而不是把场景路径写进 Ink。
  • 对未知 Tag 和缺失资源做可诊断的降级处理。

Tag 只表达演出意图

推荐使用 key:value 约定,例如 speaker:alice、portrait:angry、sfx:door。Ink 只说明“谁在说话、用什么表情、播放什么效果”,Unity 再把这些 ID 映射到实际资源。

下面是需要由 Ink 编译器编译的内容片段:

text
你终于来了。 # speaker:alice # portrait:angry # sfx:door

Ink Tag 到 Unity 表现层的数据流

在 Continue 之后读取标签

currentTags 对应最近一次 Continue() 返回的内容,所以顺序不能反过来。解析时也不要依赖 Tag 的书写顺序:先转成字典,再按“说话人 → 立绘 → 音效”的固定顺序应用。

csharp
using System;
using System.Collections.Generic;
using Ink.Runtime;
using UnityEngine;
using UnityEngine.UI;

public sealed class TagDrivenDialogue : MonoBehaviour
{
    [Serializable]
    private sealed class PortraitBinding
    {
        public string key;
        public Sprite sprite;
    }

    [Serializable]
    private sealed class ActorBinding
    {
        public string id;
        public string displayName;
        public Image portraitTarget;
        public PortraitBinding[] portraits;
    }

    [Serializable]
    private sealed class SfxBinding
    {
        public string id;
        public AudioClip clip;
    }

    [SerializeField] private TextAsset storyJson;
    [SerializeField] private Text dialogueText;
    [SerializeField] private Text speakerText;
    [SerializeField] private Button nextButton;
    [SerializeField] private AudioSource audioSource;
    [SerializeField] private ActorBinding[] actors;
    [SerializeField] private SfxBinding[] soundEffects;

    private Story story;
    private string currentActorId;

    private void Awake()
    {
        story = new Story(storyJson.text);
        nextButton.onClick.AddListener(Advance);
    }

    private void Start()
    {
        Advance();
    }

    public void Advance()
    {
        if (!story.canContinue) return;

        string line = story.Continue().Trim();
        Dictionary<string, string> tags = ParseTags(story.currentTags);

        ApplySpeaker(tags);
        ApplyPortrait(tags);
        ApplySound(tags);

        dialogueText.text = line;
        Debug.Log($"line={line} tags=[{string.Join(", ", story.currentTags)}]");
    }

    private static Dictionary<string, string> ParseTags(List<string> rawTags)
    {
        var result = new Dictionary<string, string>(StringComparer.OrdinalIgnoreCase);
        foreach (string raw in rawTags)
        {
            int separator = raw.IndexOf(':');
            if (separator <= 0 || separator >= raw.Length - 1) continue;
            result[raw.Substring(0, separator).Trim()] = raw.Substring(separator + 1).Trim();
        }
        return result;
    }

    private void ApplySpeaker(Dictionary<string, string> tags)
    {
        if (!tags.TryGetValue("speaker", out string actorId)) return;
        ActorBinding actor = FindActor(actorId);
        if (actor == null)
        {
            Debug.LogWarning($"Unknown speaker tag: {actorId}");
            return;
        }
        currentActorId = actor.id;
        speakerText.text = actor.displayName;
    }

    private void ApplyPortrait(Dictionary<string, string> tags)
    {
        if (!tags.TryGetValue("portrait", out string key)) return;
        ActorBinding actor = FindActor(currentActorId);
        if (actor == null)
        {
            Debug.LogWarning("Portrait tag has no active actor.");
            return;
        }
        foreach (PortraitBinding binding in actor.portraits)
        {
            if (!string.Equals(binding.key, key, StringComparison.OrdinalIgnoreCase)) continue;
            actor.portraitTarget.sprite = binding.sprite;
            return;
        }
        Debug.LogWarning($"Unknown portrait tag: {currentActorId}/{key}");
    }

    private void ApplySound(Dictionary<string, string> tags)
    {
        if (!tags.TryGetValue("sfx", out string id)) return;
        foreach (SfxBinding binding in soundEffects)
        {
            if (!string.Equals(binding.id, id, StringComparison.OrdinalIgnoreCase)) continue;
            audioSource.PlayOneShot(binding.clip);
            return;
        }
        Debug.LogWarning($"Unknown sfx tag: {id}");
    }

    private ActorBinding FindActor(string id)
    {
        foreach (ActorBinding actor in actors)
        {
            if (string.Equals(actor.id, id, StringComparison.OrdinalIgnoreCase)) return actor;
        }
        return null;
    }
}

预期输出假设 Ink 首行就是前面的示例,并且 Inspector 已完成资源映射:

text
line=你终于来了。 tags=[speaker:alice, portrait:angry, sfx:door]

页面同时显示该句台词,角色名切到 alice 的显示名,立绘切到 angry,并播放 door 对应音效。

对错误 Tag 做降级

内容侧最常见的问题是拼写错误或资源未配置。运行时不应因此终止剧情,而应使用 Debug.LogWarning 留下可定位信息,并保持上一张立绘或跳过缺失音效。这样测试人员能看到 alice/angyr 之类的错误,而玩家不会直接卡死。

复杂演出不要继续堆 Tag

当演出仍是一条指令对应一个动作时,Tag 很合适。若演出开始包含等待、并行、取消和复杂条件,应让 Tag 只触发一个高层演出 ID,再交给独立演出控制器管理时序;这样剧情文本不会逐渐变成 Unity 脚本的另一种写法。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 Tag 驱动角色与演出

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

登录哪都通