chrome.printerProvider

Mô tả

API chrome.printerProvider hiển thị những sự kiện mà trình quản lý máy in dùng để truy vấn máy in do các tiện ích kiểm soát, để truy vấn chức năng của các tiện ích đó và gửi các lệnh in đến những máy in này.

Quyền

printerProvider

Phạm vi cung cấp

Chrome 44 trở lên

Loại

PrinterInfo

Thuộc tính

• description

  chuỗi không bắt buộc

  Nội dung mô tả mà con người có thể đọc được.

• id

  string

  Mã nhận dạng máy in duy nhất.

• tên

  string

  Tên máy in dễ đọc.

PrintError

Mã lỗi được trả về để phản hồi sự kiện onPrintRequested.

Enum

"OK"
Chỉ định rằng thao tác đã được hoàn tất thành công.

"FAILED"
Chỉ định rằng đã xảy ra lỗi chung.

"INVALID_TICKET"
Chỉ định rằng phiếu yêu cầu hỗ trợ in không hợp lệ. Ví dụ: phiếu yêu cầu hỗ trợ không nhất quán với một số chức năng hoặc tiện ích không thể xử lý tất cả chế độ cài đặt của phiếu yêu cầu hỗ trợ.

"INVALID_DATA"
Chỉ định rằng tài liệu không hợp lệ. Ví dụ: dữ liệu có thể bị hỏng hoặc định dạng không tương thích với tiện ích.

PrintJob

Thuộc tính

• contentType

  string

  Loại nội dung tài liệu. Các định dạng được hỗ trợ là "application/pdf" và "image/pwg-raster".

• tài liệu

  Blob

  Blob chứa dữ liệu tài liệu cần in. Định dạng phải khớp với contentType.

• printerId

  string

  Mã nhận dạng của máy in sẽ xử lý lệnh.

• phiếu yêu cầu hỗ trợ

  đối tượng

  In phiếu yêu cầu hỗ trợ ở định dạng CJT.

  Tệp tham chiếu CJT được đánh dấu là không dùng nữa. Tính năng này chỉ không dùng được cho Google Cloud Print. vẫn được sử dụng cho tính năng in trên ChromeOS.

• tiêu đề

  string

  Tên lệnh in.

Sự kiện

onGetCapabilityRequested

chrome.printerProvider.onGetCapabilityRequested.addListener(
  callback: function,
)

Sự kiện được kích hoạt khi trình quản lý in yêu cầu các tính năng của máy in.

Tham số

• số gọi lại

  hàm

  Tham số callback sẽ có dạng như sau:

  (printerId: string, resultCallback: function) => void

  • printerId

    string

  • resultCallback

    hàm

    Tham số resultCallback sẽ có dạng như sau:

    (capabilities: object) => void

    • chức năng

      đối tượng

      Khả năng của thiết bị ở định dạng CDD.

onGetPrintersRequested

chrome.printerProvider.onGetPrintersRequested.addListener(
  callback: function,
)

Sự kiện được kích hoạt khi trình quản lý máy in yêu cầu máy in do tiện ích cung cấp.

Tham số

• số gọi lại

  hàm

  Tham số callback sẽ có dạng như sau:

  (resultCallback: function) => void

  • resultCallback

    hàm

    Tham số resultCallback sẽ có dạng như sau:

    (printerInfo: PrinterInfo[]) => void

    • printerInfo

      PrinterInfo[]

onGetUsbPrinterInfoRequested

Chrome 45 trở lên

chrome.printerProvider.onGetUsbPrinterInfoRequested.addListener(
  callback: function,
)

Sự kiện được kích hoạt khi trình quản lý máy in yêu cầu thông tin về thiết bị USB có thể là máy in.

Lưu ý: Ứng dụng không nên dựa vào việc sự kiện này được kích hoạt nhiều lần cho mỗi thiết bị. Nếu một thiết bị đã kết nối được hỗ trợ, thì thiết bị đó sẽ được trả về trong sự kiện onGetPrintersRequested.

Tham số

• số gọi lại

  hàm

  Tham số callback sẽ có dạng như sau:

  (device: usb.Device, resultCallback: function) => void

  • thiết bị

    usb.Device

  • resultCallback

    hàm

    Tham số resultCallback sẽ có dạng như sau:

    (printerInfo?: PrinterInfo) => void

    • printerInfo

      PrinterInfo không bắt buộc

onPrintRequested

chrome.printerProvider.onPrintRequested.addListener(
  callback: function,
)

Sự kiện được kích hoạt khi trình quản lý in yêu cầu in.

Tham số

• số gọi lại

  hàm

  Tham số callback sẽ có dạng như sau:

  (printJob: PrintJob, resultCallback: function) => void

  • printJob

    PrintJob

  • resultCallback

    hàm

    Tham số resultCallback sẽ có dạng như sau:

    (result: PrintError) => void

    • kết quả

      PrintError