使用 WebUSB
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
WebUSB API 可將非標準通用序列匯流排 (USB) 相容裝置在網路上公開。本頁說明 API 專屬功能。如需 WebUSB API 的完整詳細資訊,請參閱 MDN。
擴充功能的供應情形
Chrome 118 以上版本。
權限
應用程式不需具備資訊清單檔案權限,但 WebUSB 會觸發瀏覽器的使用者權限流程。
資訊清單
這個 API 不需要資訊清單金鑰。
輔助情境
這個 API 可用於幾乎任何情況下;WebUSB.requestDevice()
方法無法用於擴充功能服務工作站。詳情請參閱下節。
當擴充功能服務工作站使用這個 API 時,裝置連線工作階段會讓 Service Worker 保持運作。
Chrome 擴充功能差異
雖然擴充功能服務工作站可以使用 WebUSB,但 WebUSB.requestDevice()
會傳回 承諾,可與 USBDevice 執行個體解析,但無法在擴充功能服務工作站中呼叫。如要解決這個問題,請從擴充功能 Service Worker 以外的擴充功能頁面呼叫 requestDevice()
,並傳送訊息給擴充功能 Service Worker。
下列程式碼遵循一般模式,在需要使用者手勢的權限流程中呼叫 requestDevice()
。取得裝置後,系統會傳送訊息給 Service Worker,以便使用 getDevices()
擷取裝置。
popup.js:
myButton.addEventListener("click", async () => {
await navigator.usb.requestDevice({
filters: [{ vendorId: 0x1234, productId: 0x5678 }],
});
chrome.runtime.sendMessage("newDevice");
});
service-worker.js
chrome.runtime.onMessage.addListener(async (message) => {
if (message === "newDevice") {
const devices = await navigator.usb.getDevices();
for (const device of devices) {
// open device connection.
await device.open();
}
}
});
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-02-14 (世界標準時間)。
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"缺少我需要的資訊"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"過於複雜/步驟過多"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"過時"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻譯問題"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"示例/程式碼問題"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"其他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"容易理解"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"確實解決了我的問題"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"其他"
}]
{"lastModified": "\u4e0a\u6b21\u66f4\u65b0\u6642\u9593\uff1a2024-02-14 (\u4e16\u754c\u6a19\u6e96\u6642\u9593)\u3002"}
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2024-02-14 (世界標準時間)。"],[],[]]