USBDevice: controlTransferIn() 方法

可用性有限

此特性不是基線特性，因為它在一些最廣泛使用的瀏覽器中不起作用。

實驗性： 這是一項實驗性技術
在生產中使用此技術之前，請仔細檢查瀏覽器相容性表格。

安全上下文： 此功能僅在安全上下文（HTTPS）中可用，且支援此功能的瀏覽器數量有限。

注意：此功能在 Web Workers 中可用。

USBDevice 介面的 controlTransferIn() 方法會返回一個 Promise。當命令或狀態請求已傳送（已由）USB 裝置接收後，該 Promise 會解析為一個 USBInTransferResult。

語法

controlTransferIn(setup, length)

一個用於設定選項的物件。可用的選項有：

requestType: 必須是以下三個值之一，用於指定傳輸是 "standard"（所有 USB 裝置通用）、"class"（某個行業標準裝置類通用）還是 "vendor"（特定廠商）。
recipient: 指定裝置上傳輸的目標，可以是 "device"、"interface"、"endpoint" 或 "other" 之一。
請求: 特定廠商的命令。
value: 特定廠商請求引數。
index: 接收者的介面編號。

要從裝置讀取的最大位元組數。實際資料在已解析 Promise 的 USBInTransferResult 中。

規範
WebUSB API # dom-usbdevice-controltransferin

此頁面最後修改時間為 2025年6月23日，由 MDN 貢獻者貢獻。