游戏叙事与剧情 / 系统课时
用 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
在 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 脚本的另一种写法。
按自己的节奏,确认真正理解。