HIDDevice: свойство collections

Свойство collections только для чтения интерфейса HIDDevice возвращает массив форматов отчетов

Массив форматов отчетов. Каждая запись содержит следующее:

usagePage

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

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

usage

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

type

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

0x00

Физический (группа осей)

0x01

Прикладной (мышь, клавиатура)

0x02

Логический (взаимосвязанные данные)

0x03

Отчет

0x04

Именованный массив

0x05

Переключатель использования

0x06

Измененное использование

0x07 до 0x7F

Зарезервировано для будущего использования

0x80 до 0xFF

Определяемое производителем

Дополнительную информацию об этих типах можно найти в документе Device Class Definition.

children

Массив поднаборов, который принимает тот же формат, что и набор верхнего уровня.

inputReports

Массив элементов inputReport, представляющих отдельные отчеты об вводе, описанные в этом наборе.

outputReports

Массив элементов outputReport, представляющих отдельные отчеты об выводе, описанные в этом наборе.

featureReports

Массив элементов featureReport, представляющих отдельные отчеты об функции, описанные в этом наборе.

Следующий пример демонстрирует, как получить доступ к различным элементам после возвращения свойства collections. Вы можете увидеть больше примеров и живых демо-версий в статье Подключение к необычным HID-устройствам.

for (const collection of device.collections) {
  // A HID collection includes usage, usage page, reports, and subcollections.
  console.log(`Usage: ${collection.usage}`);
  console.log(`Usage page: ${collection.usagePage}`);

  for (const inputReport of collection.inputReports) {
    console.log(`Input report: ${inputReport.reportId}`);
    // Loop through inputReport.items
  }

  for (const outputReport of collection.outputReports) {
    console.log(`Output report: ${outputReport.reportId}`);
    // Loop through outputReport.items
  }

  for (const featureReport of collection.featureReports) {
    console.log(`Feature report: ${featureReport.reportId}`);
    // Loop through featureReport.items
  }

  // Loop through subcollections with collection.children
}