HIDDevice

Интерфейс HIDDevice API WebHID представляет собой устройство HID. Он предоставляет свойства для доступа к информации об устройстве, методы для открытия и закрытия соединения, а также отправки и получения отчётов.

Этот интерфейс также наследует свойства от EventTarget.

HIDDevice.opened Только для чтения Экспериментальная

Возвращает boolean, true, если у устройства открыто соединение.

HIDDevice.vendorId Только для чтения Экспериментальная

Возвращает vendorId устройства HID.

HIDDevice.productId Только для чтения Экспериментальная

Возвращает productId устройства HID.

HIDDevice.productName Только для чтения Экспериментальная

Возвращает строку с именем продукта устройства HID.

HIDDevice.collections Только для чтения Экспериментальная

Возвращает массив форматов отчетов для устройства HID.

inputreport Экспериментальная

Вызывается при отправке отчета с устройства.

Этот интерфейс также наследует методы от EventTarget.

HIDDevice.open() Экспериментальная

Открывает соединение с этим устройством HID и возвращает Promise, который разрешается после успешного подключения.

HIDDevice.close() Экспериментальная

Закрывает соединение с этим устройством HID и возвращает Promise, который разрешается после закрытия соединения.

HIDDevice.forget() Экспериментальная

Закрывает соединение с этим устройством HID и сбрасывает разрешения доступа, возвращает Promise, который разрешается после сброса разрешения.

HIDDevice.sendReport() Экспериментальная

Отправляет отчет вывода на это устройство HID и возвращает Promise, который разрешается после отправки отчета.

HIDDevice.sendFeatureReport() Экспериментальная

Отправляет отчет функции на это устройство HID и возвращает Promise, который разрешается после отправки отчета.

HIDDevice.receiveFeatureReport() Экспериментальная

Получает отчет функции с этого устройства HID в виде Promise, который разрешается со значением DataView. Это позволяет получить типы данных содержимого сообщения.

Следующий пример демонстрирует прослушивание события inputreport, что позволит приложению определить, какая кнопка нажата на устройстве Joy-Con Right.

device.addEventListener("inputreport", (event) => {
  const { data, device, reportId } = event;

  // Handle only the Joy-Con Right device and a specific report ID.
  if (device.productId !== 0x2007 && reportId !== 0x3f) return;

  const value = data.getUint8(0);
  if (value === 0) return;

  const someButtons = { 1: "A", 2: "X", 4: "B", 8: "Y" };
  console.log(`User pressed button ${someButtons[value]}.`);
});

В следующем примере sendFeatureReport используется для мигания устройства.

const reportId = 1;
for (let i = 0; i < 10; i++) {
  // Turn off
  await device.sendFeatureReport(reportId, Uint32Array.from([0, 0]));
  await new Promise((resolve) => setTimeout(resolve, 100));
  // Turn on
  await device.sendFeatureReport(reportId, Uint32Array.from([512, 0]));
  await new Promise((resolve) => setTimeout(resolve, 100));
}

Дополнительные примеры и демонстрации в статье Подключение к необычным устройствам HID.