安装与快速入门

使用此资源只需几次点击（导入 -> 添加组件 -> 按播放），但为更好地理解所有内容，请查看以下页面，这样你可以更快且以正确的方向开始。

1. 在 Unity 中导入 Text Animator

第一步，你需要在项目中导入 Text Animator for Unity。

兼容性检查

该资源兼容以下用户界面和 Unity 版本:

Text Mesh Pro （Unity 2022.3 及更高版本）
UI 工具包 (Unity 6.3 及更高版本).

它同样支持新的 Unity 输入系统（也支持旧版输入系统）。

导入包

一旦项目正确设置，你可以从包管理器（Asset Store 选项卡）导入 Text Animator。

确保包含 "Samples/BuiltIn" 文件夹，否则该资源可能无法正常工作。

安装成功后， 欢迎窗口 将会弹出，Text Animator 已准备好为你的文本添加动画！

如果关于窗口未显示，或你想稍后查看，可以随时从菜单的 Tools/Febucci/TextAnimator/About Window 访问它！

2. 示例场景

你可以直接从检视面板了解大多数 Text Animator 功能，并从示例场景中查看我们如何设置以及它们的直接效果。

从名为“00 - Welcome”的场景开始，或在 Text Animator 的欢迎窗口中点击“Get Started”。

要访问示例场景，请确保你已经导入它们！当你不再需要时，也可以安全地移除/删除它们。

3. 为你的首批文本添加动画

你可以在几次点击内让文本运行起来！

附注。假设你已经知道 如何使用 UI Toolkit 以及它的功能。

从 UI Builder

转到库 -> 项目
拖动 "AnimatedLabel" 从你的层级视图中的 "Custom Controls/Febucci/Text Animator for Unity"！

我们正在努力确保你可以直接从 UI Toolkit 为内置的 Label 和 Button 添加动画！ （Unity 6.3 及更高版本。） 保持更新！

你的 .uxml 应该看起来像这样：

通过代码

你可以创建一个 "Febucci.TextAnimatorForUnity.AnimatedLabel" 类的实例并将其添加到你的 UI 文档，像这样：

using UnityEngine;
using UnityEngine.UIElements;
using Febucci.TextAnimatorForUnity; // <- 导入 Text Animator 的命名空间

public class ExampleScript : MonoBehaviour
{ 
    [SerializeField] UIDocument document;

    void Start()
    {
        var container = document.rootVisualElement.contentContainer;
        var animatedLabel = new AnimatedLabel(); // <- 创建一个动画标签
        container.Add(animatedLabel); // <- 将其添加到内容容器中
        // [..]
        animatedLabel.SetText("<wave>hello"); // <- 设置文本
    }
}

你可以阅读设置文本以获取更多细节和建议！

在文本中书写效果

在文本中添加效果的一种方式是使用富文本标签，例如：“I'm <shake>freezing</shake>”，其中 “shake” 是内置效果的 ID。

尝试通过实验以下标签来书写文本： <wiggle> <shake> <wave> <bounce>，例如“<wiggle>I'm joking</wiggle> hehe now <shake>I'm scared</shake>”，然后进入 Unity 的播放模式（Play）。

你的文本会根据你写的效果对字母进行动画处理！

祝你玩得开心！你可以继续下一页，深入了解该资源的所有功能。