HID: метод requestDevice()

Метод requestDevice() интерфейса HID запрашивает доступ к устройству HID.

Пользовательский агент отобразит диалоговое окно с разрешением, включающее список подключённых устройств, и попросит пользователя выбрать и предоставить разрешение на одно из этих устройств.

options

Объект, содержащий массив объектов фильтра для возможных устройств для сопряжения. Каждый объект фильтра может иметь следующие свойства:

vendorId Необязательно

Целое число, представляющее vendorId запрошенного устройства HID

productId Необязательно

Целое число, представляющее productId запрошенного устройства HID.

usagePage Необязательно

Целое число, представляющее компонент страницы использования HID запрошенного устройства. Использование для коллекции верхнего уровня используется для идентификации типа устройства.

Стандартные значения использования HID можно найти в документе HID Usage Tables

usage Необязательно

Целое число, представляющее компонент идентификатора использования HID запрошенного устройства.

А Promise, который разрешается массивом подключённых объектов HIDDevice, соответствующих переданным фильтрам.

SecurityError DOMException

Выбрасывается, если страница не разрешает доступ к функции HID.

Временная активация пользователя требуется. Пользователь должен взаимодействовать со страницей или элементом интерфейса пользователя, чтобы эта функция работала.

В следующем примере запрашивается устройство HID с vendor ID 0xABCD, product ID 0x1234, page usage 0x0C и usage ID 0x01. Будут показаны только устройства, соответствующие всем этим правилам.

let requestButton = document.getElementById("request-hid-device");
requestButton.addEventListener("click", async () => {
  let device;
  try {
    const devices = await navigator.hid.requestDevice({
      filters: [
        {
          vendorId: 0xabcd,
          productId: 0x1234,
          usagePage: 0x0c,
          usage: 0x01,
        },
      ],
    });
    device = devices[0];
  } catch (error) {
    console.log("An error occurred.");
  }

  if (!device) {
    console.log("No device was selected.");
  } else {
    console.log(`HID: ${device.productName}`);
  }
});

В этом примере используются два фильтра. Устройства будут показаны, если они соответствуют любому из этих фильтров.

// Filter on devices with the Nintendo Switch Joy-Con USB Vendor/Product IDs.
const filters = [
  {
    vendorId: 0x057e, // Nintendo Co., Ltd
    productId: 0x2006, // Joy-Con Left
  },
  {
    vendorId: 0x057e, // Nintendo Co., Ltd
    productId: 0x2007, // Joy-Con Right
  },
];

// Prompt user to select a Joy-Con device.
const [device] = await navigator.hid.requestDevice({ filters });