关于 unity-primetween-design
unity-primetween-design 是用于编写和审查 PrimeTween 代码的指导模块，依据 1.4.6 版本。内容涵盖补间与序列生命周期、回调、异步行为、序列化设置和运行时配置。
主要功能
- 01Tween 与 Sequence 生命周期指导
- 02动画串联、分组和插入规则
- 03绑定目标的回调建议
- 04异步与协程分配说明
- 05TweenSettings 和 PrimeTweenConfig 用法
适用场景
- 01审查 PrimeTween 动画代码
- 02设计顺序执行和重叠的补间序列
- 03处理 Unity 目标销毁时的回调
- 04选择异步或基于序列的动画控制
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/unity-primetween-design确认已加载。
详细介绍
**调用此模块中的任何技能之前：**如果你打算根据技能名称或描述猜测参数后调用技能，请停止——先阅读此文件（或通过
GET /skills/recommend?includeSchema=true获取其架构）。如果你已从 recommend/schema 获取参数定义，则可直接进行 dryRun。
触发条件
- 编写或审查 PrimeTween 代码
- 诊断补间生命周期行为
- 编写或审查 PrimeTween 代码、诊断补间生命周期行为
PrimeTween - 设计规则
指导性模块。规则基于通过 com.kyrylokuzyk.primetween 安装的 PrimeTween 1.4.6 包。
模式：仅文档——没有需要设限的 REST 技能；可在任何运行模式下自由加载。
何时加载此模块
在编写或审查以下内容之前加载：
Tween.Position、LocalPosition、EulerAngles、LocalEulerAngles、Scale、Alpha、Color、Custom、延迟或震动调用。Sequence.Create、Chain、Group、Insert、回调或序列循环。Tween.Stop、Complete、StopAll、CompleteAll、PausedAll、进度、时间缩放或手动更新控制。OnComplete、OnUpdate、零分配回调重载或目标销毁处理。await tween、ToYieldInstruction、序列化的TweenSettings、PrimeTweenConfig或容量调整。
关键规则摘要
| # | 规则 | 来源锚点 |
|---|---|---|
| 1 | PrimeTween 使用静态 Tween 工厂。其 Tween 句柄是一个结构体，已完成或已停止的句柄已失效且不可复用；若要重播或反转动画，请创建新的补间。 | Runtime/Tween.cs:53,256-264；readme.md “Controlling tweens” |
| 2 | 使用 Sequence.Chain 执行顺序工作，使用 Group 针对前一项并行执行工作，使用 Insert 实现绝对时间重叠。这些命名与 DOTween 的 Append/Join 术语不同。 | Runtime/Sequence.cs:154,193,202 |
| 3 | 创建 Sequence 时，它有自己的循环、循环模式、缓动、更新类型和非缩放时间设置。请在 Sequence.Create 上配置这些设置，而不是使用 DOTween 风格的链式设置器。 | Runtime/Sequence.cs:108 |
| 4 | 回调可以通过 OnComplete<T> 或序列回调重载显式绑定目标。这样可避免捕获闭包，并允许 PrimeTween 在目标被销毁时抑制回调。 | Runtime/Tween.cs:365-382；Runtime/Sequence.cs:228-281 |
| 5 | PrimeTween 会检测已销毁的 Unity 目标，并通过 PrimeTweenConfig 提供针对性警告。不要假设存在 DOTween 的 SetLink API；如果预期的生命周期要求如此，请持有句柄，并在组件被禁用时停止它。 | Runtime/Internal/PrimeTweenManager.cs:870-880；Runtime/PrimeTweenConfig.cs:56-87 |
| 6 | 支持 await tween 和 ToYieldInstruction()，但异步状态机和协程都会产生分配。对于对分配敏感的动画流程，优先使用 Sequence。 | Runtime/Internal/AsyncAwaitSupport.cs；Runtime/Internal/CoroutinesSupport.cs；readme.md “Async/await” |
| 7 | TweenSettings 和 TweenSettings<T> 是可序列化的配置载体，用于通过 Inspector 编写补间值；请使用它们，而不是另行创建动画设置组件。 | Runtime/TweenSettings.cs:25-54；readme.md “Inspector integration” |
| 8 | PrimeTweenConfig 是静态运行时配置。它包含容量、默认缓动/更新类型、警告控制和手动更新 API，但它不是 Resources 设置资源。 | Runtime/PrimeTweenConfig.cs:25-101 |
转至其他模块
- 异步控制流或取消策略 → 加载 async 和 unitask-design。
- 通过 Inspector 编写的
TweenSettings字段 → 加载 inspector。 - 补间密集型性能分析 → 加载 performance。
- 通过 Addressables 加载的目标或场景生命周期 → 加载 addressables-design。
版本适用范围
此模块针对 PrimeTween 1.4.6。其 UPM 包支持 Unity 2018.4 及更高版本，但 Unity Skills 本身以 Unity 2022.3 及更高版本为基准。依赖较新的工厂重载或 PrimeTween Pro 功能前，请先检查已安装的包版本。
评论
支持 Markdown