說明
chrome.printerProvider
API 會公開列印管理員用來查詢擴充功能控制的印表機的事件,以便查詢擴充功能的功能,以及將列印工作提交給這些印表機。
權限
printerProvider
適用國家/地區
類型
PrinterInfo
屬性
-
description
字串 選用
印表機的說明 (使用者可理解)。
-
id
字串
專屬印表機 ID。
-
名稱
字串
印表機的人類可讀名稱。
PrintError
回應 onPrintRequested
事件時傳回的錯誤代碼。
列舉
"OK"
表示作業已成功完成。
"FAILED"
表示發生一般錯誤。
"INVALID_TICKET"
表示列印票證無效。舉例來說,票券和部分功能不一致,或是擴充功能無法處理票證中的所有設定。
"INVALID_DATA"
表示文件無效。例如資料可能已損毀,或是格式與擴充功能不相容。
PrintJob
屬性
-
contentType
字串
文件內容類型。支援的格式為
"application/pdf"
和"image/pwg-raster"
。 -
文件
Blob
包含要列印的文件資料的 Blob。格式必須與
contentType
相符。 -
printerId
字串
應處理工作的印表機 ID。
-
支援單
物件
以 CJT 格式列印票券。
CJT 參照已標示為已淘汰。這個版本已淘汰,僅適用於 Google 雲端列印。並未淘汰 ChromeOS 列印服務。
-
title
字串
列印工作標題。
活動
onGetCapabilityRequested
chrome.printerProvider.onGetCapabilityRequested.addListener(
callback: function,
)
列印管理員要求印表機功能時觸發的事件。
參數
-
回呼
功能
callback
參數如下所示:(printerId: string, resultCallback: function) => void
-
printerId
字串
-
resultCallback
功能
resultCallback
參數如下所示:(capabilities: object) => void
-
capabilities
物件
採用 CDD 格式的裝置功能。
-
-
onGetPrintersRequested
chrome.printerProvider.onGetPrintersRequested.addListener(
callback: function,
)
列印管理員要求擴充功能提供的印表機時會觸發事件。
參數
-
回呼
功能
callback
參數如下所示:(resultCallback: function) => void
-
resultCallback
功能
resultCallback
參數如下所示:(printerInfo: PrinterInfo[]) => void
-
printerInfo
-
-
onGetUsbPrinterInfoRequested
chrome.printerProvider.onGetUsbPrinterInfoRequested.addListener(
callback: function,
)
列印管理員要求取得 USB 裝置 (可能是印表機) 的相關資訊時,會觸發事件。
注意:應用程式不應仰賴每部裝置重複觸發這個事件一次。如果系統支援已連結的裝置,應在 onGetPrintersRequested
事件中傳回。
參數
-
回呼
功能
callback
參數如下所示:(device: usb.Device, resultCallback: function) => void
-
裝置
-
resultCallback
功能
resultCallback
參數如下所示:(printerInfo?: PrinterInfo) => void
-
printerInfo
PrinterInfo 選用
-
-
onPrintRequested
chrome.printerProvider.onPrintRequested.addListener(
callback: function,
)
列印管理員要求列印時觸發的事件。
參數
-
回呼
功能
callback
參數如下所示:(printJob: PrintJob, resultCallback: function) => void
-
printJob
-
resultCallback
功能
resultCallback
參數如下所示:(result: PrintError) => void
-
結果
-
-