更新日志

此页面包含 Unity 文本动画器的更新日志。!

P.S. 请务必在更新任何内容之前备份你的项目(或者更好:使用版本控制)——即使是在 Text Animator 之外。祝好!


最新发布

我们遵循标准 主版本.次版本.修订号 约定,通常在商店中发布时会有新的“次版本”版本直接发布。

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

新增

  • 新增 Naninovel 集成: Naninovel

  • 新增选项,可在句末跳过标点等待

  • 新增选项,可在打字机效果期间跳过带标点的缩写词(例如 Dr.、Miss. 等)

  • 新增方法,可在开始前估算显示或隐藏文本时的打字机持续时间

  • 新增选项,可通过“waitinput”标签等待特定输入操作,而不是等待所有输入

我们也在发布与 Text Animator 配套使用的新教程!

第一个是关于伤害数字的: https://blog.febucci.com/2026/04/how-to-create-animated-damage-numbers-in-unity/ 。加入我们的 Discord,提议新的教程吧!

改进

  • 改进了文本在设置到无效、被禁用或已实例化的画布和组件上时,以及之后的显示方式

  • 改进了数据库的用户体验,现在会对重复标签发出警告

  • 改进了打字速度脚本化 API

修复

  • 修复了播放在回退到 DefaultPlayback 时(通过检查器设置)的问题

  • 修复了在 UI Toolkit 中消失效果触发错误的问题

  • 修复了 UI Toolkit 中时间不缩放功能不起作用的问题

  • 修复了 UI Toolkit 与 TMPro 之间效果动画方向相反的问题

  • 修复了动画标签未正确填充字符信息的问题

  • 修复了默认数据库中缺少摆锤效果的问题

  • 修复了运行时未带设置实例化时打字机组件报错的问题

  • 修复了打字机的 在效果结束后触发消失 未正常生效的问题


3.5.0 - 稳定性与修复 [2026.03.03]

新增

  • 新增带自定义枢轴旋转的效果

  • 新增摆锤效果

  • 为“Append”方法新增参数,可跳过前一段文本

改进

  • 插件现在作为包导入.

  • 允许在播放模式下更改打字速度脚本化对象

  • 改进了字符和单词延迟下拉菜单

  • 通过 API 暴露了字符已经过时间

  • 大幅改进了我们的后端,以便未来能更快发布!

修复

  • 修复了新闻面板因博客上不存在的文章而报错的问题

  • 修复了文本动画器在启用时第一帧不工作的的问题

  • 修复了在同一帧调用时“设置字符可见性”方法不起作用的问题

  • 修复了在播放模式下更改打字速度脚本化对象未被应用的问题

  • 修复了启动时显示文本会在一帧内闪现完整文本的问题

  • 修复了文本动画器和打字机在某些溢出设置下无法工作的问题

  • 修复了消失文本抛出索引越界异常的问题

  • 改进了 append 方法的实现

  • 改进了打字机从最后一个可见字母而不是第一个字母继续的问题

  • 修复了在某些使用内容适配器或布局组件的情况下,第一帧出现布局偏移的问题

  • 修复了空字符串因 TMP 无效数据而报错的问题

  • 修复了“textAnimator.allLettersShown”在空字符串时不会返回 true 的问题

  • 修复了在某些情况下低帧率时打字机跳过字符/文本的问题

  • 改进了在某些情况下进入/退出播放模式时搜索 TextAnimator 包的过程

  • 修复了应用效果时 TMPro 渐变未被应用的问题

  • 修复了抖动效果未应用到第一个字符的问题

  • 修复了数据库上下文菜单显示警告,因为它位于泛型类内部的问题

  • 修复了在选项被禁用时,等待最后一个字符未被正确跳过的问题

  • 修复了共享设置未应用时间缩放的问题

由于一些小插曲,版本号被跳过了。

3.3.0 - Unity 对话系统 [2025.01.19]

新增

改进

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

修复

  • 修复了等待最后一个字符未被正确跳过的问题

  • 修复了在不同域重载设置下数据库未刷新的问题

  • 修复了数据库上下文菜单的警告,因为它位于泛型类内部 (Unity 的小把戏)

  • 修复了抖动效果未应用到最前面的第一个字符的问题

  • 修复了应用效果时 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 版本开始)

  • 在检查器(打字机组件)中新增事件:当打字机开始等待某个字符以及结束等待时触发

  • 在关于窗口中直接显示新闻面板,以便无需离开编辑器即可跟踪新更新

错误修复

  • 修复了“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),便于更轻松地引用场景对象

  • 打字机操作现在同时支持协程以及无状态的“tick”推进方式

  • 新增一种名为“PlaySound”的打字机操作:播放并等待音频源结束后再继续打字机流程

  • 还新增了许多其他小改进、提示信息等更多内容。

改进

  • 整篇文档已重写,希望能让它更易理解,并涵盖更多最佳实践、技巧和常见问题

  • 改进了该资源的许可协议,现在对独立开发者和更大的团队都更加友好。

  • 优化了效果,期间实现 0 垃圾回收,并考虑了许多其他优化事项

  • 修复了效果之间的竞态条件(在某些极端情况下会发生)

  • 修复了操作之间的竞态条件,同时允许你为特定打字机指定局部操作

  • 改进了编辑器和 API 的用户体验。

  • 改进了欢迎界面和设置窗口,现在会进行一些额外检查

  • 你现在可以在多个打字机和文本动画器之间共享设置。

  • 改进了处理富文本标签参数的 API,现在由 Text Animator 自动处理

  • 许多错误修复(例如新的输入系统警告)以及更多内容.

破坏性 API 更改

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


已知问题