unity-volume

このモジュールのスキルを呼び出す前に必ず確認してください： 名前や説明から推測したパラメーターでスキルを呼び出そうとしている場合は、いったん停止し、このファイルを読むか、GET /skills/recommend?includeSchema=true でスキーマを取得してください。recommend/schema からパラメーター定義をすでに取得している場合は、そのまま dryRun に進めます。

トリガー

• ボリュームの設定
• VolumeProfile の作成または読み込み
• グローバル／ローカルボリュームの追加
• Volume のセットアップ、VolumeProfile の作成または読み込み、シーンへのグローバル／ローカル Volume の追加

Volume スキル

Unity 2022.3 以降向けの共通 SRP Volume フレームワークスキルです。SRP Core を介して URP と HDRP の両方で動作します。

動作モード

• クエリスキル（volume_list_component_types、volume_get_component）は SkillMode.SemiAuto です。許可を得ずに 3 つすべてのモードで実行されます。
• 変更スキル（volume_profile_create、volume_create、volume_set_profile、volume_add_component、volume_set_parameter、volume_set_parameter_batch）は SkillMode.FullAuto です。Approval ではユーザーの許可が必要です（許可を得ると、サーバー側で 1 回実行され、結果が返されます）。Auto／Bypass では直接実行されます。
• volume_remove_component は SkillOperation.Delete を持ち、Approval／Auto モードでは自動的に禁止されます（NeverInSemi）。実行できるのは Bypass またはユーザー管理の Allowlist のみです。

SRP パッケージスタブ

このモジュールは com.unity.render-pipelines.core（SRP_CORE）に対してコンパイルされています。URP と HDRP のどちらもインストールされていない場合（SRP Core がない場合）、すべてのスキルはスタブ { error: "Scriptable Render Pipeline Core package … is not installed." }（RenderPipelineSkillsCommon.NoSRP()）を返します。このスタブは診断用ペイロードであり、権限拒否ではありません。許可は不要で、NeverInSemi としても扱われません。このエラーが表示された場合は、まず project_get_render_pipeline を確認してください。

ガードレール

ルーティング：

• Volume コンテナー／プロファイルの CRUD には、このモジュールを使用します
• Bloom／DOF／トーンマッピングなどの最新の高レベルなポストプロセッシングエフェクトには、postprocess を優先します

ランタイム優先のルール：

• アクティブなパイプラインにコンポーネントタイプが存在すると決めつける前に、必ず volume_list_component_types を呼び出します
• コンポーネントを追加／作成した後は volume_get_component を使用して、値を設定する前に実際のパラメーター名を確認します
• 記憶から推測するのではなく、実際のコンポーネントデータから返された正確なパラメーター名を優先します
• volume_set_parameter_batch では、items に JSON 配列文字列を指定する必要があります

スキル

volume_profile_create

VolumeProfile アセットを作成します。

volume_create

グローバルまたはローカルの Volume GameObject を作成します。

volume_set_profile

既存の Volume にプロファイルを割り当てるか、置き換えます。

volume_list_component_types

アクティブな SRP パイプラインで明示的にサポートされている VolumeComponent タイプを一覧表示します。

volume_add_component

VolumeComponent オーバーライドを VolumeProfile に追加します。

volume_remove_component

VolumeComponent オーバーライドを VolumeProfile から削除します。

volume_get_component

VolumeComponent オーバーライドとそのパラメーターを確認します。

volume_set_parameter

VolumeComponent のオーバーライドパラメーターを 1 つ設定します。

volume_set_parameter_batch

1 つの VolumeComponent のオーバーライドパラメーターを複数設定します。

---

正確なシグネチャ

正確な名前、パラメーター、デフォルト値、戻り値は、このファイルではなく GET /skills/schema または unity_skills.get_skill_schema() で定義されています。