用途:该模块提供 Unity 2022.3+ 的共享 SRP Volume 框架技能,通过 SRP Core 同时适用于 URP 和 HDRP,用于 Volume 容器与 VolumeProfile 的增删改查。
主要能力:包含 volume_profile_create(创建 VolumeProfile 资产)、volume_create(创建全局或局部 Volume GameObject)、volume_set_profile(为已有 Volume 指定或替换 profile)、volume_list_component_types(列出当前 SRP 管线显式支持的 VolumeComponent 类型)、volume_add_component、volume_remove_component、volume_get_component、volume_set_parameter、volume_set_parameter_batch。
使用方式:查询类技能(volume_list_component_types、volume_get_component)为 SemiAuto,三种模式下无需授权即可运行;变更类技能(volume_profile_create、volume_create、volume_set_profile、volume_add_component、volume_set_parameter、volume_set_parameter_batch)为 FullAuto,Approval 模式下需用户授权,Auto/Bypass 下直接执行;volume_remove_component 带 Delete 操作,在 Approval/Auto 下自动禁止,仅 Bypass 或用户管理的 Allowlist 可运行。调用前应先读取 schema 或通过 GET /skills/recommend?includeSchema=true 获取参数定义,避免凭名称猜测参数。运行时优先规则:先调用 volume_list_component_types 确认组件类型存在,添加或创建后用 volume_get_component 查看实际参数名再写值,优先使用实时组件数据返回的精确参数名;volume_set_parameter_batch 的 items 需为 JSON 数组字符串。
限制:若项目未安装 URP 或 HDRP(无 SRP Core),所有技能返回 stub 错误提示 SRP Core 未安装,此时应先检查 project_get_render_pipeline。Volume 容器/profile 的 CRUD 使用本模块;Bloom/DOF/Tonemapping 等高层现代后处理效果建议使用 postprocess。精确签名、参数、默认值与返回值以 GET /skills/schema 或 unity_skills.get_skill_schema() 为准。