SuperAPI AI 工具集

unity-primetween-design

编程与开发

查看项目

更新于 10-15 17:25

技能介绍

用途:为编写或审查 PrimeTween 代码、诊断补间生命周期行为提供基于 PrimeTween 1.4.6 包(com.kyrylokuzyk.primetween)的设计规则。属纯文档型顾问模块,没有需要门控的 REST 技能,任意运行模式下均可加载。

主要能力与规则:PrimeTween 使用静态 Tween 工厂,Tween 句柄是结构体,已完成或已停止的句柄失效且不可复用,需新建 tween 才能重播或反向动画。序列用 Sequence.Chain 表示顺序、Group 表示与上一项并行、Insert 表示按绝对时间重叠,命名与 DOTween 的 Append/Join 不同。Sequence 在创建时自带 cycles、cycle mode、easing、update type 与 unscaled-time 设置,应在 Sequence.Create 上配置,而非使用 DOTween 风格链式设置器。回调可用 OnComplete<T> 或序列回调重载显式绑定目标,避免捕获闭包,并让目标被销毁时抑制回调。PrimeTween 能检测被销毁的 Unity 目标,并通过 PrimeTweenConfig 提供针对性警告;不存在 DOTween 的 SetLink API,需要在组件禁用时由自己持有句柄并停止。await tween 与 ToYieldInstruction() 均受支持,但异步状态机和协程都会分配内存,分配敏感的动画流程宜改用 Sequence。TweenSettings 与 TweenSettings<T> 是可序列化配置载体,用于 Inspector 编写补间值。PrimeTweenConfig 是静态运行时配置,包含容量、默认缓动与更新类型、警告控制及手动更新 API,但并非 Resources 设置资源。

使用方式:在编写或审查 Tween.Position、LocalPosition、EulerAngles、LocalEulerAngles、Scale、Alpha、Color、Custom、delay、shake 调用,以及 Sequence.Create、Chain、Group、Insert、回调、Tween.Stop、Complete、StopAll、CompleteAll、PausedAll、progress、time scale、手动更新控制、OnComplete、OnUpdate、零分配回调重载、目标销毁处理、await tween、ToYieldInstruction、序列化 TweenSettings 与容量调优前加载本模块。调用本模块技能前不要凭名称或描述猜测参数,应先阅读本文件或通过 GET /skills/recommend?includeSchema=true 获取 schema;已有参数定义可直接进入 dryRun。

适用场景与限制:涉及异步控制流或取消策略应转 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 功能前,应检查已安装包版本。其余信息暂未提供。