mcpField
U
unity-primetween-design

unity-primetween-design

github.com/besty0728開発1.9k52 回インストール今日更新
リポジトリ

unity-primetween-design について

unity-primetween-design は、PrimeTween 1.4.6 に基づき、コードの作成とレビューを支援するガイドモジュールです。Tween と Sequence のライフサイクル、コールバック、非同期動作、シリアライズ設定、ランタイム設定を扱います。

主な機能

  1. 01Tween と Sequence のライフサイクル指針
  2. 02アニメーションの連結、グループ化、挿入ルール
  3. 03ターゲットを指定するコールバックの推奨
  4. 04非同期処理とコルーチンの割り当てに関する説明
  5. 05TweenSettings と PrimeTweenConfig の使い方

活用シーン

  1. 01PrimeTween アニメーションコードのレビュー
  2. 02順次実行や重ね合わせを行うシーケンス設計
  3. 03Unity のターゲット破棄時のコールバック処理
  4. 04非同期処理とシーケンス方式の選択

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/besty0728/unity-skills --skill unity-primetween-design

インストール後、Claude Code で/unity-primetween-designを入力して読み込まれたか確認します。

詳細

このモジュールのスキルを呼び出す前に： 名前や説明から推測したパラメーターを使ってスキルを呼び出そうとしている場合は、いったん停止し、先にこのファイルを読むか、GET /skills/recommend?includeSchema=true でスキーマを取得してください。recommend／スキーマからすでにパラメーター定義を取得済みの場合は、そのまま 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、または容量の調整。

重要ルールの要約

#ルール参照元
1PrimeTween は静的な 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
3Sequence には、作成時に独自のサイクル、サイクルモード、イージング、更新タイプ、非スケール時間の設定があります。DOTween 風の Fluent セッターではなく、Sequence.Create で設定してください。Runtime/Sequence.cs:108
4コールバックでは、OnComplete<T> またはシーケンスのコールバックオーバーロードを使って、明示的にターゲットをバインドできます。これによりキャプチャするクロージャーを避けられ、ターゲットが破棄された場合に PrimeTween がコールバックを抑止できます。Runtime/Tween.cs:365-382; Runtime/Sequence.cs:228-281
5PrimeTween は Unity の破棄済みターゲットを検出し、PrimeTweenConfig を通じて対象を指定した警告を表示します。DOTween の SetLink API が存在すると想定しないでください。意図したライフサイクルに合わせるには、ハンドルを保持し、コンポーネントが無効化されたときに停止してください。Runtime/Internal/PrimeTweenManager.cs:870-880; Runtime/PrimeTweenConfig.cs:56-87
6await tween と ToYieldInstruction() はサポートされていますが、どちらも非同期ステートマシンとコルーチンのアロケーションを発生させます。アロケーションに敏感なアニメーションのフローでは、Sequence を優先してください。Runtime/Internal/AsyncAwaitSupport.cs; Runtime/Internal/CoroutinesSupport.cs; readme.md “Async/await”
7TweenSettings と TweenSettings<T> は、Inspector で作成するトゥイーン値を保持するシリアライズ可能な設定用コンテナーです。独自のアニメーション設定コンポーネントを作るのではなく、これらを使用してください。Runtime/TweenSettings.cs:25-54; readme.md “Inspector integration”
8PrimeTweenConfig は静的なランタイム設定です。容量、デフォルトのイージング／更新タイプ、警告制御、手動更新 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 対応