Xbox无线控制器：如何修改HID报告结构分离左右扳机轴？

Xbox无线控制器支持切换输入报告模式，你可以通过发送特定的HID输出报告，将合并的rudder轴拆分为独立的左右扳机输入，无需依赖DirectInput。

步骤1：发送模式切换的HID输出报告 #

控制器默认发送简化报告（合并扳机为rudder），你需要发送配置命令切换到扩展报告模式。使用hidapi执行以下操作：

// 假设已通过hid_open系列函数获取到hid_device*类型的控制器句柄
unsigned char mode_switch_cmd[] = {0x03, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};
int result = hid_write(dev, mode_switch_cmd, sizeof(mode_switch_cmd));
if (result < 0) {
    // 处理发送失败，可调用hid_error(dev)获取具体错误信息
}

该命令只需发送一次，控制器会保持扩展报告模式直到断电或重新连接。

步骤2：更新输入报告结构体 #

切换到扩展模式后，控制器会发送包含独立左右扳机的输入报告，你需要更新结构体匹配新格式：

#pragma pack(1)
struct xbox_wireless_extended_report {
    // 按钮位定义保持不变
    static const u8 a = 1;
    static const u8 b = 2;
    static const u8 x = 4;
    static const u8 y = 8;
    static const u8 lb = 16;
    static const u8 rb = 32;
    static const u8 select = 64;
    static const u8 start = 128;

    static const u8 l3 = 1;
    static const u8 r3 = 2;

    u16 left_stick_x;
    u16 left_stick_y;
    u16 right_stick_x;
    u16 right_stick_y;

    u8 left_trigger;  // 取值0-255，对应扳机按压深度
    u8 right_trigger; // 取值0-255，对应扳机按压深度
    
    u8 buttons;
    u8 l3r3;
    u8 dpad;
    u8 unknown[2];
};

static_assert(sizeof(xbox_wireless_extended_report) == 16);

注意事项 #

• 不同型号Xbox控制器（如Xbox One、Series X/S）可能存在微小格式差异，但上述命令和结构体适用于绝大多数无线型号。
• 若发送命令后报告格式未变化，可尝试将命令的第二个字节改为0x01，部分旧型号控制器需要此调整。
• 读取报告时，确保读取字节数与新结构体大小一致（16字节）。

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