# OBOX Controller ViGEm Driver：蜗牛 OBox 手柄的 Windows 客户端

> OBOX Controller ViGEm Driver 根据仓库记录的蓝牙 HID 协议，为蜗牛 OBox 手柄实现 Windows 客户端。Rust 驱动经 ViGEmBus 映射按键、摇杆和扳机，并用 HID 输出报告控制振动与指示灯；仓库还提供 Python 原型。

- 类型：案例
- 目标：协议
- 类别：独立重建案例
- 关联：独立重建项目
- 来源复核于：2026-11-06
- 收录于：2026-11-08
- 原始资源：<https://github.com/ffexis/obox-controller-vigem>
- 一手来源：<https://github.com/ffexis/obox-controller-vigem/blob/a8d54f32fa9a8f6a32bd142de27c11492a7ad85e/docs/HID_PROTOCOL.md>
- 目录页面：<https://awesomerea.org/zh/resources/obox-controller-vigem-case/>
- 记录 JSON：<https://awesomerea.org/resources/obox-controller-vigem-case/record.json>
- 英文版：[English](https://awesomerea.org/resources/obox-controller-vigem-case/index.md)

## 使用条件与局限

- **前提条件：**需要蜗牛 OBox 蓝牙手柄和 Windows。
- **前提条件：**需要 ViGEmBus 驱动；HidHide 可选。
- **局限：**同一时间仅支持一个手柄。
- **许可：**采用 MIT 许可证。

## 一手来源

1. <https://github.com/ffexis/obox-controller-vigem/blob/a8d54f32fa9a8f6a32bd142de27c11492a7ad85e/docs/HID_PROTOCOL.md>
2. <https://github.com/ffexis/obox-controller-vigem/blob/a8d54f32fa9a8f6a32bd142de27c11492a7ad85e/README.md>

## 同分区更多条目：协议

- [OsmoFresh Quella Pro：硬件与 UART 协议调查](https://awesomerea.org/zh/resources/osmofresh-quella-pro-hardware-case/index.md) · 案例
- [Colorful 2F4C:1018：重建主板 ARGB HID 接口](https://awesomerea.org/zh/resources/colorful-2f4c-openrgb-case/index.md) · 案例
- [Deli XiangYinBao X1：重建蓝牙标签打印协议](https://awesomerea.org/zh/resources/deli-xiangyinbao-x1-protocol-case/index.md) · 案例
- [KardiaMobile 6L Unlocked：直连 BLE 的心电数据客户端](https://awesomerea.org/zh/resources/kardiamobile-6l-unlocked-case/index.md) · 案例
- [Elan 04f3:0903：复原指纹传感器的 Linux 接口](https://awesomerea.org/zh/resources/elan-0903-fingerprint-linux-case/index.md) · 案例
- [FIIL 耳机控制：基于 BLE 命令的 Windows 客户端](https://awesomerea.org/zh/resources/fiil-headphone-control-case/index.md) · 案例

## 关于此条目

说明已依据一手来源复核。
原创说明采用 MIT 许可；外部项目、论文与素材保留各自的权利和许可。