Unity中如何检测VR手柄左摇杆的按压与释放？

问题回顾 #

在Unity开发VR游戏时，需要通过左摇杆按压（按下摇杆）触发奔跑，释放摇杆恢复行走。尝试直接读取primary2DAxisClick的代码无法进入奔跑状态，同时使用Action Maps时不知道如何检测摇杆释放动作。

一、修复直接读取设备特征值的代码 #

你的原代码失效大概率是因为设备未正确获取，或者未处理设备断开重连的情况，以下是修正后的代码：

using UnityEngine.XR;

private InputDevice leftDevice;
public float walkSpeed = 2f;
public float runSpeed = 5f;
public MoveProvider moveProvider; // 确保已在Inspector中赋值

void Start()
{
    // 初始化获取左控制器设备
    leftDevice = InputDevices.GetDeviceAtXRNode(XRNode.LeftHand);
}

void Update()
{
    // 检查设备有效性，断开重连时重新获取
    if (!leftDevice.isValid)
    {
        leftDevice = InputDevices.GetDeviceAtXRNode(XRNode.LeftHand);
        return;
    }

    bool isJoystickPressed;
    // 尝试获取摇杆按压状态
    if (leftDevice.TryGetFeatureValue(CommonUsages.primary2DAxisClick, out isJoystickPressed))
    {
        // 根据按压状态切换移动速度
        moveProvider.moveSpeed = isJoystickPressed ? runSpeed : walkSpeed;
    }
    else
    {
        // 无法获取输入时默认走步速度
        moveProvider.moveSpeed = walkSpeed;
    }
}

关键排查点 #

• 确保moveProvider已在Inspector面板中正确引用，且moveSpeed是可访问的公共变量。
• 在Unity编辑器的Window > Analysis > Input Debugger中，查看左控制器的primary2DAxisClick值是否随摇杆按压/释放正确变化，确认硬件输入被Unity识别。

二、使用Input System Action Maps实现（更推荐） #

Action Maps可以通过回调精准捕获按压和释放事件，无需在Update中轮询，步骤如下：

1. 在Unity中创建Input Action资源（右键 > Input Actions），新建一个名为JoystickPress的Boolean类型Action，绑定到左控制器的Primary 2D Axis Click输入。
2. 在脚本中订阅动作的回调：

using UnityEngine.InputSystem;

public InputAction joystickPressAction; // 在Inspector中绑定创建的JoystickPress Action
public float walkSpeed = 2f;
public float runSpeed = 5f;
public MoveProvider moveProvider;

void OnEnable()
{
    // 订阅按压和释放事件
    joystickPressAction.performed += _ => moveProvider.moveSpeed = runSpeed;
    joystickPressAction.canceled += _ => moveProvider.moveSpeed = walkSpeed;
    joystickPressAction.Enable();
}

void OnDisable()
{
    // 取消订阅避免内存泄漏
    joystickPressAction.performed -= _ => moveProvider.moveSpeed = runSpeed;
    joystickPressAction.canceled -= _ => moveProvider.moveSpeed = walkSpeed;
    joystickPressAction.Disable();
}

说明 #

• performed回调会在摇杆按压触发时调用，canceled回调会在摇杆释放时调用，完美对应奔跑/行走的切换逻辑。
• 这种方式更高效，且能自动处理设备连接状态变化。

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