HIDDevice: метод sendReport()

Метод sendReport() интерфейса HIDDevice отправляет отчет об выводе устройству HID.

reportId для каждого из форматов отчётов, поддерживаемых этим устройством, можно получить из HIDDevice.collections.

reportId

8-битный идентификатор отчета. Если устройство HID не использует идентификаторы отчетов, отправьте 0.

data

Байты в виде ArrayBuffer, TypedArray или DataView.

Promise, который разрешается со значением undefined после отправки отчета.

NotAllowedError DOMException

Выбрасывается, если отправка отчета по какой-либо причине завершается неудачно.

В примере ниже показано, как заставить устройство Joy-Con вибрировать с помощью отчетов вывода. Дополнительные примеры и демонстрационные приложения см. в статье Подключение к нестандартным устройствам HID.

// First, send a command to enable vibration.
// Magical bytes come from https://github.com/mzyy94/joycon-toolweb
const enableVibrationData = [1, 0, 1, 64, 64, 0, 1, 64, 64, 0x48, 0x01];
await device.sendReport(0x01, new Uint8Array(enableVibrationData));

// Then, send a command to make the Joy-Con device rumble.
// Actual bytes are available in the sample.
const rumbleData = [
  /* … */
];
await device.sendReport(0x10, new Uint8Array(rumbleData));