用途:在 Unity 项目中通过技能接口创建和调校 Cinemachine 虚拟相机(VCam)与 Brain 设置,构建运镜与电影化相机行为。适用于创建/调校 Cinemachine 相机、配置跟随/注视/噪声、搭建运镜效果等场景。
主要能力:创建 VCam;深度检查 VCam 字段;设置任意属性;设置 Follow/LookAt 目标;切换 Body/Aim/Noise 管线组件;配置镜头(FOV、近远裁剪、正交尺寸、投影模式);列出可用组件;触发 Impulse;读取 Brain 信息;创建 TargetGroup 并增删成员;绑定 Spline;增删 Extension;强制激活 VCam;创建 Mixing/ClearShot/StateDriven/Sequencer/FreeLook 相机并配置权重、指令、混合与噪声;设置优先级与 Brain 混合。
使用方式:调用前若参数靠名称猜测,应先读取 schema(GET /skills/recommend?includeSchema=true)再执行。查询类技能(cinemachine_inspect_vcam、cinemachine_list_components、cinemachine_get_brain_info)可直接执行;配置/创建类需用户 grant。Delete 类技能(cinemachine_set_component、cinemachine_target_group_remove_member、cinemachine_remove_extension)仅 Bypass 模式或加入 Allowlist 可调用。
限制:必须安装 com.unity.cinemachine 包(2.x 或 3.x),否则返回未安装错误;CM2 与 CM3 API 差异大,通过反射适配,早期预览版(< 3.0.0-pre.5)可能失败;CM3 优先级建议用 Priority.Value。常见误用:不存在 cinemachine_create、cinemachine_set_target、cinemachine_add_brain 等,应使用对应正确技能。