mirror of
https://github.com/Genymobile/scrcpy.git
synced 2024-09-19 05:31:21 +02:00
befc0fac5b
UHID may not work on old Android versions due to permission errors. Mention it in UHID mouse and gamepad documentation (it was already mentioned for UHID keyboard). Refs #4473 comment <https://github.com/Genymobile/scrcpy/pull/4473#issuecomment-1975133226> PR #5270 <https://github.com/Genymobile/scrcpy/pull/5270>
55 lines
1.4 KiB
Markdown
55 lines
1.4 KiB
Markdown
# Gamepad
|
|
|
|
Several gamepad input modes are available:
|
|
|
|
- `--gamepad=disabled` (default)
|
|
- `--gamepad=uhid` (or `-G`): simulates physical HID gamepads using the UHID
|
|
kernel module on the device
|
|
- `--gamepad=aoa`: simulates physical HID gamepads using the AOAv2 protocol
|
|
|
|
|
|
## Physical gamepad simulation
|
|
|
|
Two modes allow to simulate physical HID gamepads on the device, one for each
|
|
physical gamepad plugged into the computer.
|
|
|
|
|
|
### UHID
|
|
|
|
This mode simulates physical HID gamepads using the [UHID] kernel module on the
|
|
device.
|
|
|
|
[UHID]: https://kernel.org/doc/Documentation/hid/uhid.txt
|
|
|
|
To enable UHID gamepads, use:
|
|
|
|
```bash
|
|
scrcpy --gamepad=uhid
|
|
scrcpy -G # short version
|
|
```
|
|
|
|
Note: UHID may not work on old Android versions due to permission errors.
|
|
|
|
|
|
### AOA
|
|
|
|
This mode simulates physical HID gamepads using the [AOAv2] protocol.
|
|
|
|
[AOAv2]: https://source.android.com/devices/accessories/aoa2#hid-support
|
|
|
|
To enable AOA gamepads, use:
|
|
|
|
```bash
|
|
scrcpy --gamepad=aoa
|
|
```
|
|
|
|
Contrary to the other mode, it works at the USB level directly (so it only works
|
|
over USB).
|
|
|
|
It does not use the scrcpy server, and does not require `adb` (USB debugging).
|
|
Therefore, it is possible to control the device (but not mirror) even with USB
|
|
debugging disabled (see [OTG](otg.md)).
|
|
|
|
Note: On Windows, it may only work in [OTG mode](otg.md), not while mirroring
|
|
(it is not possible to open a USB device if it is already open by another
|
|
process like the _adb daemon_).
|