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

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

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

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