ব্রাউজার.প্রিন্টিং, ব্রাউজার.প্রিন্টিং

বর্ণনা

অনুমতি

প্রাপ্যতা

সমস্ত browser.printing মেথড এবং ইভেন্টের জন্য আপনাকে এক্সটেনশন ম্যানিফেস্টে "printing" পারমিশনটি ঘোষণা করতে হবে। উদাহরণস্বরূপ:

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

উদাহরণ

নিচের উদাহরণগুলোতে printing নেমস্পেসের প্রতিটি মেথডের ব্যবহার দেখানো হয়েছে। এই কোডটি extensions-samples গিটহাব রিপো-তে থাকা api-samples/printing থেকে কপি করা বা তার উপর ভিত্তি করে তৈরি।

cancelJob()

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

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

getPrinters() এবং getPrinterInfo()

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

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

submitJob()

submitJob() মেথডটির জন্য তিনটি জিনিস প্রয়োজন।

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

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

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

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'
    });
  }
};

browser.printing.submitJob(submitJobRequest, (response) => {
  if (response !== undefined) {
    console.log(response.status);
  }
  if (browser.runtime.lastError !== undefined) {
    console.log(browser.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" মানটি 'true'। টিকেটের জন্য এর উচ্চতা এবং প্রস্থের মানগুলো ব্যবহার করুন।

"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,
)

বর্ণনা

অনুমতি

প্রাপ্যতা

সমস্ত browser.printing মেথড এবং ইভেন্টের জন্য আপনাকে এক্সটেনশন ম্যানিফেস্টে "printing" পারমিশনটি ঘোষণা করতে হবে। উদাহরণস্বরূপ:

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

উদাহরণ

নিচের উদাহরণগুলোতে printing নেমস্পেসের প্রতিটি মেথডের ব্যবহার দেখানো হয়েছে। এই কোডটি extensions-samples গিটহাব রিপো-তে থাকা api-samples/printing থেকে কপি করা বা তার উপর ভিত্তি করে তৈরি।

cancelJob()

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

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

getPrinters() এবং getPrinterInfo()

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

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

submitJob()

submitJob() মেথডটির জন্য তিনটি জিনিস প্রয়োজন।

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

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

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

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'
    });
  }
};

browser.printing.submitJob(submitJobRequest, (response) => {
  if (response !== undefined) {
    console.log(response.status);
  }
  if (browser.runtime.lastError !== undefined) {
    console.log(browser.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" মানটি 'true'। টিকেটের জন্য এর উচ্চতা এবং প্রস্থের মানগুলো ব্যবহার করুন।

"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,
)