chrome.printerProvider

คำอธิบาย

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

สิทธิ์

printerProvider

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

Chrome 44 ขึ้นไป

ประเภท

PrinterInfo

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

  • คำอธิบาย

    string ไม่บังคับ

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

  • id

    string

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

  • ชื่อ

    string

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

PrintError

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

ค่าแจกแจง

"OK"
ระบุว่าการดำเนินการเสร็จสมบูรณ์

"FAILED"
ระบุว่าเกิดข้อผิดพลาดทั่วไป

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

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

PrintJob

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

  • contentType

    string

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

  • เอกสาร

    Blob

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

  • printerId

    string

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

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

    ออบเจ็กต์

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

    มีการทำเครื่องหมายการอ้างอิง CJT ว่าเลิกใช้งานแล้ว ตัวเลือกนี้เลิกใช้งานแล้วสำหรับ Google Cloud Print เท่านั้น และจะไม่เลิกใช้งานสำหรับการพิมพ์ใน 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

onGetUsbPrinterInfoRequested

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

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

หมายเหตุ: แอปพลิเคชันไม่ควรกำหนดให้เหตุการณ์นี้เริ่มทำงานมากกว่า 1 ครั้งต่ออุปกรณ์ 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