HIDDevice: метод sendFeatureReport()
Ограниченная доступность
Эта функция не относится к Baseline, так как она не работает в некоторых из наиболее широко используемых браузеров.
Безопасный контекст: Эта функция доступна только в безопасных контекстах (HTTPS) в некоторых или всех поддерживающих браузерах.
Экспериментальная: Это экспериментальная технология
Перед использованием в производстве внимательно ознакомьтесь с таблицей совместимости браузеров.
Примечание: Эта функция доступна в Web Workers, за исключением Shared Web Workers.
Метод sendFeatureReport() интерфейса HIDDevice отправляет отчет о функции устройству HID. Отчеты о функциях — это способ обмена нестандартизированными данными HID между устройствами HID и приложениями.
reportId для каждого из форматов отчетов, поддерживаемых этим устройством, можно получить из HIDDevice.collections.
Синтаксис
sendFeatureReport(reportId, data)
Параметры
reportId-
Идентификатор отчета размером 8 бит. Если устройство HID не использует идентификаторы отчетов, отправьте
0. data-
Байты в виде
ArrayBuffer,TypedArrayилиDataView.
Возвращаемое значение
A Promise, который разрешается значением undefined после отправки отчета.
Исключения
-
NotAllowedErrorDOMException -
Выбрасывается, если отправка отчета не удалась по какой-либо причине.
Примеры
В приведенном ниже примере sendFeatureReport() заставляет устройство мигать. Дополнительные примеры и демонстрации в режиме реального времени можно найти в статье Подключение к необычным устройствам HID.
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));
}
Спецификации
| Спецификация |
|---|
| API WebHID # dom-hiddevice-sendfeaturereport |
Совместимость браузеров
| Рабочий стол | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox for Android | Opera Android | Safari на iOS | Samsung Internet | WebView Android | |
sendFeatureReport |
89 | 89 | Нет | 75 | Нет | Нет | Нет | Нет | Нет | Нет | Нет |
© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/HIDDevice/sendFeatureReport