HIDDevice: phương thức sendReport()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
Note: This feature is available in Web Workers, except for Shared Web Workers.
Phương thức sendReport() của giao diện HIDDevice gửi báo cáo đầu ra đến thiết bị HID.
reportId cho mỗi định dạng báo cáo mà thiết bị này hỗ trợ có thể được lấy từ HIDDevice.collections.
Cú pháp
sendReport(reportId, data)
Tham số
reportId-
Một ID báo cáo 8-bit. Nếu thiết bị HID không sử dụng ID báo cáo, truyền
0. data-
Các byte dưới dạng
ArrayBuffer,TypedArray, hoặcDataView.
Giá trị trả về
Một Promise được giải quyết với giá trị undefined khi báo cáo đã được gửi.
Ngoại lệ
NotAllowedErrorDOMException-
Được ném nếu việc gửi báo cáo thất bại vì bất kỳ lý do nào.
Ví dụ
Ví dụ dưới đây minh họa cách làm thiết bị Joy-Con rung bằng báo cáo đầu ra. Bạn có thể xem thêm ví dụ và bản demo trực tiếp trong bài viết Kết nối với các thiết bị HID không phổ biến.
// 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));
Thông số kỹ thuật
| Specification |
|---|
| WebHID API # dom-hiddevice-sendreport |