说明
chrome.printerProvider
API 提供打印管理器使用的事件,以便查询由扩展程序控制的打印机、查询其功能以及向这些打印机提交打印任务。
权限
printerProvider
可用性
类型
PrinterInfo
属性
-
说明
字符串(可选)
打印机直观易懂的说明。
-
id
string
唯一打印机 ID。
-
name
string
打印机直观易读的名称。
PrintError
为响应 onPrintRequested
事件而返回的错误代码。
枚举
"OK"
指明操作已成功完成。
"FAILED"
表示发生了常规失败。
"INVALID_TICKET"
指定打印票券无效。例如,工单与某些功能不一致,或者扩展程序无法处理工单中的所有设置。
"INVALID_DATA"
指定文档无效。例如,数据可能已损坏,或者其格式与此扩展程序不兼容。
PrintJob
属性
-
contentType
string
文档内容类型。支持的格式为
"application/pdf"
和"image/pwg-raster"
。 -
文档
Blob
包含要打印的文档数据的 Blob。格式必须与“
contentType
”一致。 -
printerId
string
应处理作业的打印机的 ID。
-
工单
对象
以 CJT 格式打印工单。
CJT 引用标记为已废弃。此选项仅针对 Google 云打印弃用,不会针对 ChromeOS 打印弃用。
-
title
string
打印任务标题。
活动
onGetCapabilityRequested
chrome.printerProvider.onGetCapabilityRequested.addListener(
callback: function,
)
打印管理器请求打印机功能时触发的事件。
参数
-
callback
功能
callback
参数如下所示:(printerId: string, resultCallback: function) => void
-
printerId
string
-
resultCallback
功能
resultCallback
参数如下所示:(capabilities: object) => void
-
capabilities
对象
设备功能,采用 CDD 格式。
-
-
onGetPrintersRequested
chrome.printerProvider.onGetPrintersRequested.addListener(
callback: function,
)
当打印管理器请求由扩展程序提供的打印机时触发的事件。
参数
-
callback
功能
callback
参数如下所示:(resultCallback: function) => void
-
resultCallback
功能
resultCallback
参数如下所示:(printerInfo: PrinterInfo[]) => void
-
printerInfo
-
-
onGetUsbPrinterInfoRequested
chrome.printerProvider.onGetUsbPrinterInfoRequested.addListener(
callback: function,
)
当打印管理器请求有关 USB 设备(可能是打印机)的信息时触发的事件。
注意:应用不得依赖于每台设备上多次触发此事件。如果已连接的设备受支持,则应在 onGetPrintersRequested
事件中返回该设备。
参数
-
callback
功能
callback
参数如下所示:(device: usb.Device, resultCallback: function) => void
-
设备
-
resultCallback
功能
resultCallback
参数如下所示:(printerInfo?: PrinterInfo) => void
-
printerInfo
PrinterInfo(可选)
-
-
onPrintRequested
chrome.printerProvider.onPrintRequested.addListener(
callback: function,
)
打印管理器请求打印时触发的事件。
参数
-
callback
功能
callback
参数如下所示:(printJob: PrintJob, resultCallback: function) => void
-
printJob
-
resultCallback
功能
resultCallback
参数如下所示:(result: PrintError) => void
-
结果
-
-