browser.printerProvider

الوصف

تعرض واجهة برمجة التطبيقات chrome.printerProvider الأحداث التي يستخدمها مدير الطباعة للاستعلام عن الطابعات التي تتحكّم فيها الإضافات، والاستعلام عن إمكاناتها وإرسال مهام الطباعة إلى هذه الطابعات.

الأذونات

printerProvider

مدى التوفّر

الإصدار 44 من Chrome والإصدارات الأحدث browser.* ‎ منذ الإصدار 148 من Chrome

الأنواع

PrinterInfo

الخصائص

• الوصف

  string اختياري

  وصف الطابعة الذي يمكن لشخص عادي قراءته

• id

  سلسلة

  المعرّف الفريد للطابعة

• الاسم

  سلسلة

  اسم الطابعة الذي يمكن لشخص عادي قراءته

PrintError

رموز الخطأ التي تم عرضها استجابةً للحدث onPrintRequested.

Enum

"OK"
تشير إلى أنّ العملية اكتملت بنجاح.

"FAILED"
تشير إلى حدوث خطأ عام.

"INVALID_TICKET"
تشير إلى أنّ طلب الطباعة غير صالح. على سبيل المثال، قد لا يتوافق الطلب مع بعض الإمكانات، أو قد لا تتمكّن الإضافة من معالجة جميع الإعدادات من الطلب.

"INVALID_DATA"
تشير إلى أنّ المستند غير صالح. على سبيل المثال، قد تكون البيانات تالفة أو التنسيق غير متوافق مع الإضافة.

PrintJob

الخصائص

• contentType

  سلسلة

  نوع محتوى المستند التنسيقات المتوافقة هي "application/pdf" و"image/pwg-raster".

• مستند

  بلوب

  يشير هذا المصطلح إلى كائن ثنائي كبير يحتوي على بيانات المستند المطلوب طباعته. يجب أن يتطابق التنسيق مع contentType.

• printerId

  سلسلة

  رقم تعريف الطابعة التي يجب أن تعالج المهمة

• طلب دعم

  عنصر

  تذكرة الطباعة بتنسيق CJT

  تم وضع علامة على مرجع CJT على أنّه متوقف نهائيًا. تم إيقافها نهائيًا لخدمة "الطباعة السحابية من Google" فقط، ولم يتم إيقافها نهائيًا للطباعة على نظام التشغيل ChromeOS.

• title

  سلسلة

  عنوان مهمة الطباعة

الفعاليات

onGetCapabilityRequested

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

يتم تشغيل الحدث عندما يطلب مدير الطباعة إمكانات الطابعة.

المعلمات

• callback

  دالة

  تظهر المَعلمة callback على النحو التالي:

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

  • printerId

    سلسلة

  • resultCallback

    دالة

    تظهر المَعلمة resultCallback على النحو التالي:

    (capabilities: object) => void

    • الإمكانات

      عنصر

      إمكانات الجهاز بتنسيق CDD

onGetPrintersRequested

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

يتم تنشيط الحدث عندما يطلب مدير الطباعة الطابعات التي توفّرها الإضافات.

المعلمات

• callback

  دالة

  تظهر المَعلمة callback على النحو التالي:

  (resultCallback: function) => void

  • resultCallback

    دالة

    تظهر المَعلمة resultCallback على النحو التالي:

    (printerInfo: PrinterInfo[]) => void

    • printerInfo

      PrinterInfo[]

onGetUsbPrinterInfoRequested

الإصدار 45 من Chrome والإصدارات الأحدث browser.* ‎ منذ الإصدار 148 من Chrome

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

يتم تشغيل الحدث عندما يطلب مدير الطباعة معلومات عن جهاز USB قد يكون طابعة.

ملاحظة: يجب ألا يعتمد التطبيق على بدء هذا الحدث أكثر من مرة لكل جهاز. إذا كان الجهاز المتصل متوافقًا، يجب عرضه في حدث onGetPrintersRequested.

المعلمات

• callback

  دالة

  تظهر المَعلمة callback على النحو التالي:

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

  • جهاز

    usb.Device

  • resultCallback

    دالة

    تظهر المَعلمة resultCallback على النحو التالي:

    (printerInfo?: PrinterInfo) => void

    • printerInfo

      PrinterInfo اختياري

onPrintRequested

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

يتم تشغيل الحدث عندما يطلب مدير الطباعة الطباعة.

المعلمات

• callback

  دالة

  تظهر المَعلمة callback على النحو التالي:

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

  • printJob

    PrintJob

  • resultCallback

    دالة

    تظهر المَعلمة resultCallback على النحو التالي:

    (result: PrintError) => void

    • نتيجة

      PrintError