Unity Cinemachine FreeLook右键旋转的组件类型声明问题

现有代码的核心问题 #

• 变量类型声明错误：不存在名为Cinemachine的组件类型，Cinemachine是插件的根命名空间，CinemachineFreeLook才是可用于声明引用的组件类。你代码中引入的Cinemachine.Utility是插件内部工具类命名空间，实现该功能不需要引用。
• 输入判断逻辑错误：Input.GetMouseButtonDown(1)仅在鼠标右键按下的第一帧返回true，配合else分支会导致除了按下瞬间的其余所有帧组件都被禁用，相机会直接复位到初始角度，完全无法实现拖动旋转效果。
• 实现思路错误：反复开关CinemachineFreeLook组件会触发相机参数重置、视角跳变，甚至触发自动归位逻辑，正确做法是控制组件的输入接收权限，而非直接开关组件。

修正后的可直接运行代码 #

using UnityEngine;
using Cinemachine; // 引入Cinemachine主命名空间

public class LookOnDrag : MonoBehaviour
{
    // 正确声明FreeLook组件类型引用
    private CinemachineFreeLook _freeLookCam;

    void Start()
    {
        _freeLookCam = GetComponent<CinemachineFreeLook>();
        // 初始化时清空默认输入绑定，禁止相机自动响应鼠标移动
        _freeLookCam.m_XAxis.m_InputAxisName = "";
        _freeLookCam.m_YAxis.m_InputAxisName = "";
    }
    
    void Update()
    {
        // 用GetMouseButton判断右键按住状态，而非仅判断按下瞬间的GetMouseButtonDown
        if (Input.GetMouseButton(1))
        {
            // 按住右键时，将鼠标移动增量传给相机旋转轴
            _freeLookCam.m_XAxis.m_InputAxisValue = Input.GetAxis("Mouse X");
            _freeLookCam.m_YAxis.m_InputAxisValue = Input.GetAxis("Mouse Y");
        }
        else
        {
            // 未按住右键时输入值置0，相机保持当前角度不旋转
            _freeLookCam.m_XAxis.m_InputAxisValue = 0;
            _freeLookCam.m_YAxis.m_InputAxisValue = 0;
        }
    }
}

使用说明 #

• 将脚本挂载到场景中的CinemachineFreeLook相机对象上即可，不需要额外拖拽组件引用，脚本会自动获取同物体上的FreeLook组件
• 最终效果：松开右键时相机固定在当前视角，按住右键拖动鼠标时相机平滑跟随旋转，无视角跳变问题
• 如果项目使用新版Input System，仅需将代码中鼠标输入读取部分替换为新输入系统对应的鼠标Delta接口即可，核心控制逻辑不变

内容的提问来源于stack exchange，提问作者Isaac Heinze