chrome.printerProvider

refresh date: 2026-09-25 robots: noindex

Mô tả

API chrome.printerProvider hiển thị các sự kiện mà trình quản lý in sử dụng để truy vấn máy in do tiện ích kiểm soát, truy vấn khả năng của máy in và gửi lệnh in đến các 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

• mô tả

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

  Nội dung mô tả dễ đọc của máy in.

• id

  chuỗi

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

• tên

  chuỗi

  Tên máy in mà con người có thể đọc được.

PrintError

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

Enum

"OK"
Cho biết thao tác đã hoàn tất thành công.

"FAILED"
Cho biết đã xảy ra lỗi chung.

"INVALID_TICKET"
Chỉ định rằng phiếu in không hợp lệ. Ví dụ: phiếu yêu cầu 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 trong phiếu yêu cầu.

"INVALID_DATA"
Cho biết giấy tờ 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

  chuỗi

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

• tài liệu

  Giọt nước

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

• printerId

  chuỗi

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

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

  đối tượng

  In vé ở định dạng CJT.

  Tài liệu tham khảo về CJT được đánh dấu là không dùng nữa. Chính sách này chỉ ngừng hoạt động đối với Google Cloud Print, chứ không ngừng hoạt động đối với tính năng in trên ChromeOS.

• tiêu đề

  chuỗi

  Tên của 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 chức năng của máy in.

Thông số

• callback

  hàm

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

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

  • printerId

    chuỗi

  • resultCallback

    hàm

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

    (capabilities: object) => void

    • khả 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ý in yêu cầu máy in do tiện ích cung cấp.

Thông số

• callback

  hàm

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

  (resultCallback: function) => void

  • resultCallback

    hàm

    Tham số resultCallback 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ý in yêu cầu thông tin về một 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 trên mỗi thiết bị. Nếu thiết bị được kết nối được hỗ trợ, thì thiết bị đó sẽ được trả về trong sự kiện onGetPrintersRequested.

Thông số

• callback

  hàm

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

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

  • thiết bị

    usb.Device

  • resultCallback

    hàm

    Tham số resultCallback 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.

Thông số

• callback

  hàm

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

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

  • printJob

    PrintJob

  • resultCallback

    hàm

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

    (result: PrintError) => void

    • kết quả

      PrintError