# 更新日志

<mark style="color:默认;background-color:red;">**P.S. 请务必在更新任何内容之前备份你的项目（**</mark>*<mark style="color:默认;background-color:red;">**或者更好：使用版本控制**</mark>*<mark style="color:默认;background-color:red;">**）——即使是在 Text Animator 之外。祝好！**</mark>

***

## 最新发布

{% hint style="info" %}
我们遵循标准 **主版本.次版本.修订号** 约定，通常在商店中发布时会有新的“**次版本**”版本直接发布。
{% endhint %}

### 3.11.1 - Naninovel、打字机改进和常规修复 \[2026.04.14]

#### 新增

* 新增 Naninovel 集成： [Naninovel](/text-animator-unity/3.x-zh/ji-cheng/ji-cheng-de-cha-jian-yu-dui-hua-xi-tong/naninovel.md)
* 新增选项，可在句末跳过标点等待
* 新增选项，可在打字机效果期间跳过带标点的缩写词（例如 Dr.、Miss. 等）
* 新增方法，可在开始前估算显示或隐藏文本时的打字机持续时间
* 新增选项，可通过“waitinput”标签等待特定输入操作，而不是等待所有输入

{% hint style="info" %}
我们也在发布与 Text Animator 配套使用的新教程！&#x20;

第一个是关于伤害数字的： <https://blog.febucci.com/2026/04/how-to-create-animated-damage-numbers-in-unity/> 。加入我们的 Discord，提议新的教程吧！&#x20;
{% endhint %}

#### 改进

* 改进了文本在设置到无效、被禁用或已实例化的画布和组件上时，以及之后的显示方式&#x20;
* 改进了数据库的用户体验，现在会对重复标签发出警告
* 改进了打字速度脚本化 API

#### 修复

* 修复了播放在回退到 `DefaultPlayback` 时（通过检查器设置）的问题
* 修复了在 UI Toolkit 中消失效果触发错误的问题
* 修复了 UI Toolkit 中时间不缩放功能不起作用的问题
* 修复了 UI Toolkit 与 TMPro 之间效果动画方向相反的问题
* 修复了动画标签未正确填充字符信息的问题
* 修复了默认数据库中缺少摆锤效果的问题
* 修复了运行时未带设置实例化时打字机组件报错的问题
* 修复了打字机的 `在效果结束后触发消失` 未正常生效的问题

***

### 3.5.0 - 稳定性与修复 \[2026.03.03]

{% hint style="warning" %}
插件现在作为包导入。请删除之前的资源文件夹（效果除外），然后导入新的包。这将有助于更快获得新更新，同时不会覆盖你的数据！&#x20;
{% endhint %}

#### 新增

* 新增带自定义枢轴旋转的效果
* 新增摆锤效果
* 为“Append”方法新增参数，可跳过前一段文本

#### 改进

* **插件现在作为包导入**.
* 允许在播放模式下更改打字速度脚本化对象
* 改进了字符和单词延迟下拉菜单
* 通过 API 暴露了字符已经过时间
* 大幅改进了我们的后端，以便未来能更快发布！

#### 修复

* 修复了新闻面板因博客上不存在的文章而报错的问题
* 修复了文本动画器在启用时第一帧不工作的的问题
* 修复了在同一帧调用时“设置字符可见性”方法不起作用的问题
* 修复了在播放模式下更改打字速度脚本化对象未被应用的问题
* 修复了启动时显示文本会在一帧内闪现完整文本的问题
* 修复了文本动画器和打字机在某些溢出设置下无法工作的问题
* 修复了消失文本抛出索引越界异常的问题
* 改进了 append 方法的实现
* 改进了打字机从最后一个可见字母而不是第一个字母继续的问题&#x20;
* 修复了在某些使用内容适配器或布局组件的情况下，第一帧出现布局偏移的问题
* 修复了空字符串因 TMP 无效数据而报错的问题
* 修复了“textAnimator.allLettersShown”在空字符串时不会返回 true 的问题
* 修复了在某些情况下低帧率时打字机跳过字符/文本的问题
* 改进了在某些情况下进入/退出播放模式时搜索 TextAnimator 包的过程
* 修复了应用效果时 TMPro 渐变未被应用的问题
* 修复了抖动效果未应用到第一个字符的问题
* 修复了数据库上下文菜单显示警告，因为它位于泛型类内部的问题
* 修复了在选项被禁用时，等待最后一个字符未被正确跳过的问题
* 修复了共享设置未应用时间缩放的问题

{% hint style="info" %}
由于一些小插曲，版本号被跳过了。
{% endhint %}

### 3.3.0 - Unity 对话系统 \[2025.01.19]

#### 新增

* 的集成指南 [Unity 对话系统](/text-animator-unity/3.x-zh/ji-cheng/ji-cheng-de-cha-jian-yu-dui-hua-xi-tong/unity-dui-hua-xi-tong.md)

#### 改进

* 将菜单项路径和优先级移动到专用文件中 *（以便在与其他资源冲突时你可以修改它）*

#### 修复

* 修复了等待最后一个字符未被正确跳过的问题
* 修复了在不同域重载设置下数据库未刷新的问题
* 修复了数据库上下文菜单的警告，因为它位于泛型类内部 *（Unity 的小把戏）*&#x20;
* 修复了抖动效果未应用到最前面的第一个字符的问题
* 修复了应用效果时 TMPro 渐变未被保留的问题

### 3.2.0 - 自定义旋转枢轴与错误修复 \[2025.12.18]

#### 新增

* 新增带自定义枢轴旋转的效果
* 重新实现了摆锤效果，适用于出现、持续和消失
* \[API] 在 CharacterData 中暴露了字符的经过时间

#### 错误修复

* 修复了一个烦人的 bug：对某些用户而言，脚本重新加载后会显示 Text Animator 窗口
* 修复了当 Unity 编辑器出现卡顿时打字机跳过字符的问题
* 修复了 Unity 包管理器无法找到该包时的错误

***

### 3.1.1 - Yarn Spinner、打字机事件和新闻面板 \[2025.12.03]

#### 新增

* Yarn Spinner 现在已正式集成！（从 3.1 版本开始）
* 在检查器（打字机组件）中新增事件：当打字机开始等待某个字符以及结束等待时触发&#x20;
* 在关于窗口中直接显示新闻面板，以便无需离开编辑器即可跟踪新更新

#### 错误修复

* 修复了“waitforinput”操作未在内置操作数据库中正确序列化的问题
* 修复了父对象被禁用时打字机未正确启动的问题

#### 小改动

* 在 package.json 中新增文档和许可证链接
* 新增虚拟方法，可在打字机等待字符之前或之后执行某些操作
* 为 Text Animator 和 Typewriter 组件新增自定义图标

***

### 3.0.0 - UI Toolkit 支持、新动画引擎以及更多内容！\[2025.11.18]

#### 新增

* 从 Unity 6.3 开始支持 UI Toolkit
* 借助“Playbacks”，你可以让效果只播放一次、循环 x 次、延迟开始以及许多其他组合（可通过编辑器或富文本标签实现）
* 同一个效果现在可以在所有场合下作为出现、持续（此前为“行为”）和消失来播放，从而进一步增加可用效果数量（例如，一个“wave”可作为出现效果，并且其参数与作为持续/行为时的“wave”不同）。
* 你可以使用富文本标签修饰符直接设置效果参数、对其进行乘法运算，或设置特定关键字
* 现在你可以为效果设置不同曲线，从而改变不同过渡及其随时间的运动/影响（例如，让旋转看起来有延迟感，逐步增强）。
* 为已有效果添加了更多选项，例如“扩展”和“滑动”方向
* 打字机操作现在可以创建为“组件”（而不只是 Scriptable Object），便于更轻松地引用场景对象&#x20;
* 打字机操作现在同时支持协程以及无状态的“tick”推进方式
* 新增一种名为“PlaySound”的打字机操作：播放并等待音频源结束后再继续打字机流程&#x20;
* *还新增了许多其他小改进、提示信息等更多内容。*

{% hint style="success" %}
*我们可能会发现这里漏写了一些功能，并会在接下来的几周内更新此页面——在过去几个月的开发中，已有 **数百** 次提交！*.
{% endhint %}

#### **改进**

* 整篇文档已重写，希望能让它更易理解，并涵盖更多最佳实践、技巧和常见问题
* 改进了该资源的许可协议，现在对独立开发者和更大的团队都更加友好。
* 优化了效果，期间实现 0 垃圾回收，并考虑了许多其他优化事项&#x20;
* 修复了效果之间的竞态条件（在某些极端情况下会发生）
* 修复了操作之间的竞态条件，同时允许你为特定打字机指定局部操作
* 改进了编辑器和 API 的用户体验。
* 改进了欢迎界面和设置窗口，现在会进行一些额外检查
* 你现在可以在多个打字机和文本动画器之间共享设置。
* 改进了处理富文本标签参数的 API，现在由 Text Animator 自动处理
* *许多错误修复（例如新的输入系统警告）以及更多内容*.&#x20;

#### 破坏性 API 更改

* 大多数 API 都有破坏性更改（因为我们更改了命名空间和一些核心架构，尤其是如果你编写了自定义 C# 效果或操作）。为了实现这个新版本并为我们未来的所有计划做准备，有很多内容都需要改变——所以我们一次性完成了这一切（包括许可证变更），这样 a) 这件事你只需要考虑一次，b) 我们可以更轻松地推进新更新，而不会被卡住。请务必阅读 [从 2.X 升级到 3.X](/text-animator-unity/3.x-zh/qi-ta/geng-xin-ri-zhi/cong-2.x-sheng-ji-dao-3.x.md)。谢谢！

***

## 已知问题


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.febucci.com/text-animator-unity/3.x-zh/qi-ta/geng-xin-ri-zhi.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.