chrome.printerProvider

คำอธิบาย

chrome.printerProvider API จะแสดงเหตุการณ์ที่ผู้จัดการการพิมพ์ใช้เพื่อค้นหาเครื่องพิมพ์ที่ควบคุมโดยส่วนขยายเพื่อค้นหาความสามารถของอุปกรณ์และส่งงานพิมพ์ไปยังเครื่องพิมพ์เหล่านี้

สิทธิ์

printerProvider

ความพร้อมใช้งาน

Chrome 44 ขึ้นไป

ประเภท

PrinterInfo

พร็อพเพอร์ตี้

  • คำอธิบาย

    string ไม่บังคับ

    คำอธิบายที่มนุษย์อ่านได้ของเครื่องพิมพ์

  • id

    สตริง

    รหัสเครื่องพิมพ์ที่ไม่ซ้ำกัน

  • ชื่อ

    สตริง

    ชื่อที่มนุษย์อ่านได้ของเครื่องพิมพ์

PrintError

แสดงรหัสข้อผิดพลาดในเหตุการณ์ onPrintRequested

ค่าแจกแจง

"ตกลง"
ระบุว่าการดำเนินการเสร็จสมบูรณ์แล้ว

"ล้มเหลว"
ระบุว่าการทำงานล้มเหลวโดยทั่วไป

"INVALID_TICKET"
ระบุว่าตั๋วการพิมพ์ไม่ถูกต้อง เช่น คำขอแจ้งปัญหาไม่สอดคล้องกับความสามารถบางอย่าง หรือส่วนขยายจัดการการตั้งค่าทั้งหมดจากตั๋วไม่ได้

"INVALID_DATA"
ระบุว่าเอกสารไม่ถูกต้อง เช่น ข้อมูลอาจเสียหายหรือรูปแบบใช้ไม่ได้กับส่วนขยาย

PrintJob

พร็อพเพอร์ตี้

  • contentType

    สตริง

    ประเภทเนื้อหาเอกสาร รูปแบบที่รองรับคือ "application/pdf" และ "image/pwg-raster"

  • เอกสาร

    Blob

    Blob ที่มีข้อมูลเอกสารที่จะพิมพ์ รูปแบบต้องตรงกับ contentType

  • printerId

    สตริง

    รหัสของเครื่องพิมพ์ที่ควรจัดการงาน

  • คำขอแจ้งปัญหา

    ออบเจ็กต์

    พิมพ์ตั๋วในรูปแบบ CJT

    มีการทำเครื่องหมายการอ้างอิง CJT ว่าเลิกใช้งานแล้ว โดยจะเลิกใช้งานสำหรับ Google Cloud Print เท่านั้น ไม่ได้เลิกใช้งานสำหรับการพิมพ์ของ ChromeOS

  • title

    สตริง

    ชื่องานพิมพ์

กิจกรรม

onGetCapabilityRequested

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

เหตุการณ์เริ่มทำงานเมื่อผู้จัดการการพิมพ์ขอความสามารถของเครื่องพิมพ์

พารามิเตอร์

  • Callback

    ฟังก์ชัน

    พารามิเตอร์ callback มีลักษณะดังนี้ 

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

    • printerId

      สตริง

    • resultCallback

      ฟังก์ชัน

      พารามิเตอร์ resultCallback มีลักษณะดังนี้ 

      (capabilities: object) => void

      • ความสามารถ

        ออบเจ็กต์

        ความสามารถของอุปกรณ์ในรูปแบบ CDD

onGetPrintersRequested

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

เหตุการณ์เริ่มทำงานเมื่อผู้จัดการการพิมพ์ขอเครื่องพิมพ์ที่ส่วนขยายมีให้

พารามิเตอร์

  • Callback

    ฟังก์ชัน

    พารามิเตอร์ callback มีลักษณะดังนี้ 

    (resultCallback: function) => void

    • resultCallback

      ฟังก์ชัน

      พารามิเตอร์ resultCallback มีลักษณะดังนี้ 

      (printerInfo: PrinterInfo[]) => void

onGetUsbPrinterInfoRequested

Chrome 45 ขึ้นไป 
chrome.printerProvider.onGetUsbPrinterInfoRequested.addListener(
  callback: function,
)

เหตุการณ์เริ่มทำงานเมื่อผู้จัดการการพิมพ์ขอข้อมูลเกี่ยวกับอุปกรณ์ USB อาจเป็นเครื่องพิมพ์

หมายเหตุ: แอปพลิเคชันไม่ควรอาศัยเหตุการณ์นี้ในการเริ่มทำงานมากกว่า 1 ครั้งต่ออุปกรณ์ หากอุปกรณ์ที่เชื่อมต่อได้รับการรองรับ อุปกรณ์ดังกล่าวควรส่งคืนในเหตุการณ์ onGetPrintersRequested

พารามิเตอร์

  • Callback

    ฟังก์ชัน

    พารามิเตอร์ callback มีลักษณะดังนี้ 

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

    • อุปกรณ์

      usb.Device

    • resultCallback

      ฟังก์ชัน

      พารามิเตอร์ resultCallback มีลักษณะดังนี้ 

      (printerInfo?: PrinterInfo) => void

onPrintRequested

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

เหตุการณ์เริ่มทำงานเมื่อผู้จัดการการพิมพ์ขอพิมพ์

พารามิเตอร์

  • Callback

    ฟังก์ชัน

    พารามิเตอร์ callback มีลักษณะดังนี้ 

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

    • printJob

      PrintJob

    • resultCallback

      ฟังก์ชัน

      พารามิเตอร์ resultCallback มีลักษณะดังนี้ 

      (result: PrintError) => void