chrome.printing

বর্ণনা

অনুমতি

প্রাপ্যতা

সমস্ত chrome.printing পদ্ধতি এবং ইভেন্টের জন্য আপনাকে এক্সটেনশন ম্যানিফেস্টে "printing" অনুমতি ঘোষণা করতে হবে৷ যেমন:

{
  "name": "My extension",
  ...
  "permissions": [
    "printing"
  ],
  ...
}

উদাহরণ

নীচের উদাহরণগুলি প্রিন্টিং নামস্থানে প্রতিটি পদ্ধতি ব্যবহার করে দেখায়। এই কোডটি এক্সটেনশন-নমুনা গিথুব রেপোতে এপিআই-নমুনা/মুদ্রণের উপর ভিত্তি করে অনুলিপি করা হয়েছে।

চাকরি বাতিল ()

এই উদাহরণটি একটি 'বাতিল' বোতাম লুকানোর জন্য onJobStatusChanged হ্যান্ডলার ব্যবহার করে যখন jobStatus PENDING বা IN_PROGRESS নয়। নোট করুন যে কিছু নেটওয়ার্কে বা যখন একটি Chromebook সরাসরি প্রিন্টারের সাথে সংযুক্ত থাকে, তখন বাতিল বোতামটি কল করার জন্য যথেষ্ট দীর্ঘ দৃশ্যমান হওয়ার জন্য এই অবস্থাগুলি খুব দ্রুত পাস হতে পারে৷ এটি ব্যাপকভাবে সরলীকৃত মুদ্রণ উদাহরণ.

chrome.printing.onJobStatusChanged.addListener((jobId, status) => {
  const cancelButton = document.getElementById("cancelButton");
  cancelButton.addEventListener('click', () => {
    chrome.printing.cancelJob(jobId).then((response) => {
      if (response !== undefined) {
        console.log(response.status);
      }
      if (chrome.runtime.lastError !== undefined) {
        console.log(chrome.runtime.lastError.message);
      }
    });
  });
  if (status !== "PENDING" && status !== "IN_PROGRESS") {
    cancelButton.style.visibility = 'hidden';
  } else {
    cancelButton.style.visibility = 'visible';
  }
}

getPrinters() এবং getPrinterInfo()

এই ফাংশনগুলির জন্য একটি একক উদাহরণ ব্যবহার করা হয় কারণ প্রিন্টার তথ্য পাওয়ার জন্য একটি প্রিন্টার আইডি প্রয়োজন, যা getPrinters() কল করে পুনরুদ্ধার করা হয়। এই উদাহরণটি কনসোলে ডিফল্ট প্রিন্টারের নাম এবং বিবরণ লগ করে। এটি প্রিন্টিং উদাহরণের একটি সরলীকৃত সংস্করণ।

​​const printers = await chrome.printing.getPrinters();
const defaultPrinter = printers.find((printer) => {
  const printerInfo = await chrome.printing.getPrinterInfo(printer.id);
  return printerInfo.isDefault;
}
console.log(`Default printer: ${defaultPrinter.name}.\n\t${defaultPrinter.description}`);

জমা দিন()

submitJob() পদ্ধতিতে তিনটি জিনিস প্রয়োজন।

• প্রিন্টারের কোন ক্ষমতা ব্যবহার করা হবে তা উল্লেখ করে একটি ticket কাঠামো। ব্যবহারকারীকে উপলব্ধ ক্ষমতা থেকে নির্বাচন করতে হলে, আপনি getPrinterInfo() ব্যবহার করে একটি নির্দিষ্ট প্রিন্টারের জন্য সেগুলি পুনরুদ্ধার করতে পারেন।
• একটি SubmitJobRequest কাঠামো, যা ব্যবহার করার জন্য প্রিন্টার এবং মুদ্রণের জন্য ফাইল বা ডেটা নির্দিষ্ট করে। এই কাঠামোতে ticket কাঠামোর একটি উল্লেখ রয়েছে।
• মুদ্রণের জন্য ফাইল বা ডেটার একটি ব্লব।

submitJob() কল করা একটি ডায়ালগ বক্স ট্রিগার করে যা ব্যবহারকারীকে মুদ্রণ নিশ্চিত করতে বলে। নিশ্চিতকরণ বাইপাস করতে PrintingAPIExtensionsAllowlist ব্যবহার করুন।

এটি প্রিন্টিং উদাহরণের একটি সরলীকৃত সংস্করণ। লক্ষ্য করুন যে ticket SubmitJobRequest কাঠামোর সাথে সংযুক্ত রয়েছে (লাইন 8) এবং মুদ্রণের ডেটা একটি ব্লব (লাইন 10) এ রূপান্তরিত হয়েছে৷ প্রিন্টারের আইডি পাওয়া (লাইন 1) এখানে দেখানোর চেয়ে নমুনায় আরও জটিল।

const defaultPrinter = getDefaultPrinter();
const ticket = getPrinterTicket(defaultPrinter);
const arrayBuffer = getPrintData();
const submitJobRequest = {
  job: {
    printerId: defaultPrinter,
    title: 'test job',
    ticket: ticket,
    contentType: 'application/pdf',
    document: new Blob([new Uint8Array(arrayBuffer)], {
      type: 'application/pdf'
    });
  }
};

chrome.printing.submitJob(submitJobRequest, (response) => {
  if (response !== undefined) {
    console.log(response.status);
  }
  if (chrome.runtime.lastError !== undefined) {
    console.log(chrome.runtime.lastError.message);
  }
});

রোল প্রিন্টিং

এই উদাহরণটি দেখায় যে কীভাবে একটানা (বা রোল) মুদ্রণের জন্য একটি প্রিন্টার টিকিট তৈরি করতে হয়, যা প্রায়শই রসিদ মুদ্রণের সাথে ব্যবহৃত হয়। রোল প্রিন্টিংয়ের জন্য submitJobRequest অবজেক্টটি submitJob() উদাহরণের জন্য দেখানো মতই।

আপনি যদি কাগজ কাটার জন্য ডিফল্ট মান পরিবর্তন করতে চান, তাহলে vendor_ticket_item কী ব্যবহার করুন। (ডিফল্ট প্রিন্টার থেকে প্রিন্টারে পরিবর্তিত হয়।) মান পরিবর্তন করতে, একজন সদস্যের সাথে একটি অ্যারে প্রদান করুন: একটি বস্তু যার id 'finishings' । মানটি হয় প্রিন্টারের জন্য 'trim' হতে পারে যেগুলি মুদ্রণের শেষে রোলটি কেটে দেয় বা 'none' এমন প্রিন্টারগুলির জন্য হতে পারে যার জন্য প্রিন্টের কাজটি ছিঁড়ে ফেলা প্রয়োজন৷

const ticket = {
  version: '1.0',
  print: {
    vendor_ticket_item: [{id: 'finishings', value: 'trim'}],
    color: {type: 'STANDARD_MONOCHROME'},
    duplex: {type: 'NO_DUPLEX'},
    page_orientation: {type: 'PORTRAIT'},
    copies: {copies: 1},
    dpi: {horizontal_dpi: 300, vertical_dpi: 300},
    media_size: {
      width_microns: 72320,
      height_microns: 100000
    },
    collate: {collate: false}
  }
};

কিছু প্রিন্টার "finishings" বিকল্পটিকে সমর্থন করে না। আপনার প্রিন্টার আছে কিনা তা নির্ধারণ করতে, getPrinterInfo() কল করুন এবং "finishings/11" এর একটি "display_name" সন্ধান করুন।

"vendor_capability": [
  {
    "display_name": "finishings/11",
    "id": "finishings/11",
    "type": "TYPED_VALUE",
    "typed_value_cap": {
      "value_type": "BOOLEAN"
    }
  },
  ...
]

একটি টিকিটের media_size কী-এর মান প্রতিটি প্রিন্টারের জন্য নির্দিষ্ট। একটি উপযুক্ত আকার নির্বাচন করতে getPrinterInfo() কল করুন। ফিরে আসা GetPrinterResponse "media_size"."option" -এ সমর্থিত মিডিয়া মাপের একটি অ্যারে রয়েছে। একটি বিকল্প বেছে নিন যার "is_continuous_feed" মান সত্য। টিকিটের জন্য এর উচ্চতা এবং প্রস্থের মান ব্যবহার করুন।

"media_size": {
  "option": [
  {
    "custom_display_name": "",
    "is_continuous_feed": true,
    "max_height_microns": 2000000,
    "min_height_microns": 25400,
    "width_microns": 50800
  },
  ...
  ]
}

chrome.printing.cancelJob(
  jobId: string,
): Promise<void>

chrome.printing.getJobStatus(
  jobId: string,
): Promise<JobStatus>

chrome.printing.getPrinterInfo(
  printerId: string,
): Promise<GetPrinterInfoResponse>

chrome.printing.getPrinters(): Promise<Printer[]>

chrome.printing.submitJob(
  request: SubmitJobRequest,
): Promise<SubmitJobResponse>

chrome.printing.onJobStatusChanged.addListener(
  callback: function,
)