refresh date: 2026-09-25 robots: noindex
বিবরণ
Chromebook-এ ইনস্টল করা প্রিন্টারে প্রিন্ট জব পাঠাতে chrome.printing API ব্যবহার করুন।
অনুমতি
printingউপলভ্যতা
ম্যানিফেস্ট
সব chrome.printing পদ্ধতি ও ইভেন্টের জন্য আপনাকে এক্সটেনশন ম্যানিফেস্টে "printing" অনুমতি ঘোষণা করতে হবে। যেমন:
{
"name": "My extension",
...
"permissions": [
"printing"
],
...
}
উদাহরণ
নিচের উদাহরণগুলি প্রিন্টিং নেমস্পেসে প্রতিটি পদ্ধতি ব্যবহার করে দেখায়। এই কোডটি extensions-samples GitHub রেপোতে api-samples/printing থেকে কপি করা হয়েছে বা তার উপর ভিত্তি করে তৈরি করা হয়েছে।
cancelJob()
এই উদাহরণে 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() and 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()
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'
});
}
};
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
},
...
]
}
ধরন
GetPrinterInfoResponse
প্রপার্টি
-
কেপেবিলিটি
অবজেক্ট ঐচ্ছিক
CDD ফর্ম্যাটে প্রিন্টারের ক্ষমতা। প্রপার্টিটি হয়ত নেই।
-
স্ট্যাটাস
প্রিন্টারের স্ট্যাটাস।
JobStatus
প্রিন্ট করার কাজের স্ট্যাটাস।
Enum
"বাকি আছে"
Chrome-এর তরফ থেকে প্রিন্ট করার অনুরোধ পাওয়া গেছে কিন্তু এখনও প্রসেস করা হয়নি।
"IN_PROGRESS"
প্রিন্ট করার জন্য প্রিন্ট জব পাঠানো হয়েছে।
"ব্যর্থ হয়েছে"
কোনও সমস্যার কারণে প্রিন্ট জব বাধাগ্রস্ত হয়েছে।
"বাতিল করা হয়েছে"
ব্যবহারকারী বা API-এর মাধ্যমে প্রিন্ট জব বাতিল করা হয়েছে।
"প্রিন্ট করা হয়েছে"
কোনও সমস্যা ছাড়াই প্রিন্টের কাজ সম্পূর্ণ হয়েছে।
Printer
প্রপার্টি
-
বর্ণনা
স্ট্রিং
প্রিন্টারের মানুষের-পঠনযোগ্য বিবরণ।
-
id
স্ট্রিং
প্রিন্টারের শনাক্তকারী; ডিভাইসে থাকা প্রিন্টারগুলির মধ্যে অনন্য হওয়ার গ্যারান্টিযুক্ত।
-
isDefault
বুলিয়ান
প্রিন্টারটি DefaultPrinterSelection নিয়ম মেনে চলে কিনা তা দেখানোর ফ্ল্যাগ। মনে রাখবেন, একাধিক প্রিন্টার ফ্ল্যাগ করা হতে পারে।
-
নাম
স্ট্রিং
প্রিন্টারের নাম।
-
recentlyUsedRank
নম্বর ঐচ্ছিক
Chrome থেকে প্রিন্ট করার জন্য প্রিন্টারটি কত সম্প্রতি ব্যবহার করা হয়েছে তা দেখানো মান। ভ্যালু যত কম হবে, প্রিন্টারটি তত সাম্প্রতিককালে ব্যবহার করা হয়েছে। ন্যূনতম মান হল ০। ভ্যালু না থাকার অর্থ হল, প্রিন্টারটি সম্প্রতি ব্যবহার করা হয়নি। এই ভ্যালু প্রিন্টারগুলির মধ্যে অনন্য হওয়ার গ্যারান্টিযুক্ত।
-
সোর্স
প্রিন্টারের সোর্স (ব্যবহারকারী বা নীতি কনফিগার করা)।
-
uri
স্ট্রিং
প্রিন্টার URI। ব্যবহারকারীর জন্য প্রিন্টার বেছে নিতে এক্সটেনশন এটি ব্যবহার করতে পারে।
PrinterSource
প্রিন্টারের সোর্স।
Enum
"USER"
ব্যবহারকারী প্রিন্টার যোগ করেছেন।
"নীতি"
নীতির মাধ্যমে প্রিন্টার যোগ করা হয়েছে।
PrinterStatus
প্রিন্টারের স্ট্যাটাস।
Enum
"DOOR_OPEN"
প্রিন্টারের দরজা খোলা আছে। প্রিন্টার এখনও প্রিন্টের কাজ গ্রহণ করে।
"TRAY_MISSING"
প্রিন্টারের ট্রে নেই। প্রিন্টার এখনও প্রিন্টের কাজ গ্রহণ করে।
"OUT_OF_INK"
প্রিন্টারে কালি শেষ হয়ে গেছে। প্রিন্টার এখনও প্রিন্টের কাজ গ্রহণ করে।
"OUT_OF_PAPER"
প্রিন্টারে কাগজ নেই। প্রিন্টার এখনও প্রিন্টের কাজ গ্রহণ করে।
"OUTPUT_FULL"
প্রিন্টারের আউটপুট এরিয়া (যেমন, ট্রে) ভর্তি হয়ে গেছে। প্রিন্টার এখনও প্রিন্টের কাজ গ্রহণ করে।
"PAPER_JAM"
প্রিন্টারে কাগজ আটকে গেছে। প্রিন্টার এখনও প্রিন্টের কাজ গ্রহণ করে।
"GENERIC_ISSUE"
কিছু সাধারণ সমস্যা। প্রিন্টার এখনও প্রিন্টের কাজ গ্রহণ করে।
"বন্ধ হয়ে গেছে"
প্রিন্টার বন্ধ হয়ে গেছে এবং প্রিন্ট করছে না, তবে এখনও প্রিন্ট করার কাজ গ্রহণ করছে।
"অ্যাক্সেস করা যাচ্ছে না"
প্রিন্টার অ্যাক্সেস করা যাচ্ছে না এবং প্রিন্ট করার কাজ গ্রহণ করছে না।
"EXPIRED_CERTIFICATE"
SSL সার্টিফিকেটের মেয়াদ শেষ হয়ে গেছে। প্রিন্টার কাজ গ্রহণ করে কিন্তু তা সম্পূর্ণ হয় না।
"উপলভ্য"
প্রিন্টার উপলভ্য আছে।
SubmitJobRequest
প্রপার্টি
-
কাজ
প্রিন্ট করার কাজ জমা দিতে হবে। "application/pdf" এবং "image/png" ধরনের কন্টেন্ট কাজ করে। ক্লাউড জব টিকিট-এ
FitToPageTicketItem,PageRangeTicketItemএবংReverseOrderTicketItemফিল্ড অন্তর্ভুক্ত করা উচিত নয় কারণ নেটিভ প্রিন্টিংয়ের জন্য এগুলি অপ্রাসঙ্গিক।VendorTicketItemঐচ্ছিক। অন্য সব ফিল্ড অবশ্যই থাকতে হবে।
SubmitJobResponse
প্রপার্টি
-
jobId
স্ট্রিং ঐচ্ছিক
তৈরি করা প্রিন্ট জবের আইডি। ডিভাইসে সব প্রিন্ট জবের মধ্যে এটি হল অনন্য শনাক্তকারী। স্ট্যাটাস OK না হলে, jobId ফাঁকা থাকবে।
-
স্ট্যাটাস
অনুরোধের স্ট্যাটাস।
SubmitJobStatus
submitJob অনুরোধের স্ট্যাটাস।
Enum
"ঠিক আছে"
প্রিন্ট জব অনুরোধ পাঠানো হয়েছে।
"USER_REJECTED"
প্রিন্ট করার অনুরোধ ব্যবহারকারী বাতিল করেছেন।
প্রপার্টি
MAX_GET_PRINTER_INFO_CALLS_PER_MINUTE
প্রতি মিনিটে getPrinterInfo যতবার কল করা যেতে পারে তার সর্বাধিক সংখ্যা।
ভ্যালু
২০
MAX_SUBMIT_JOB_CALLS_PER_MINUTE
প্রতি মিনিটে submitJob যতবার কল করা যেতে পারে তার সর্বাধিক সংখ্যা।
ভ্যালু
৪০
পদ্ধতি
cancelJob()
chrome.printing.cancelJob(
jobId: string,
callback?: function,
): Promise<void>
আগে জমা দেওয়া কাজ বাতিল করে।
প্যারামিটারগুলি
-
jobId
স্ট্রিং
প্রিন্ট জব বাতিল করার আইডি। এটি
SubmitJobResponse-এ পাওয়া আইডির সাথে একই হতে হবে। -
কলব্যাক
ফাংশন ঐচ্ছিক
callbackপ্যারামিটারটি দেখতে এইরকম:() => void
রিটার্ন
-
<void> প্রমিস
Chrome 100+Manifest V3 এবং তার পরবর্তী ভার্সনের জন্য শুধু প্রমিস কাজ করে, অন্যান্য প্ল্যাটফর্মের ক্ষেত্রে কলব্যাক ব্যবহার করতে হবে।
getJobStatus()
chrome.printing.getJobStatus(
jobId: string,
callback?: function,
): Promise<JobStatus>
প্রিন্ট জবের স্ট্যাটাস দেখায়। প্রদত্ত jobId সহ প্রিন্ট জব না থাকলে, এই কল রানটাইম সমস্যার কারণে ব্যর্থ হবে। jobId: প্রিন্ট জবের আইডি যার স্ট্যাটাস রিটার্ন করতে হবে। এটি SubmitJobResponse-এ পাওয়া আইডির সাথে একই হতে হবে।
প্যারামিটারগুলি
-
jobId
স্ট্রিং
-
কলব্যাক
ফাংশন ঐচ্ছিক
callbackপ্যারামিটারটি দেখতে এইরকম:(status: JobStatus) => void
-
স্ট্যাটাস
-
রিটার্ন
-
Promise<JobStatus>
Manifest V3 এবং তার পরবর্তী ভার্সনের জন্য শুধু প্রমিস কাজ করে, অন্যান্য প্ল্যাটফর্মের ক্ষেত্রে কলব্যাক ব্যবহার করতে হবে।
getPrinterInfo()
chrome.printing.getPrinterInfo(
printerId: string,
callback?: function,
): Promise<GetPrinterInfoResponse>
CDD ফর্ম্যাটে প্রিন্টারের স্ট্যাটাস ও ক্ষমতা সম্পর্কে তথ্য প্রদান করে। প্রদত্ত আইডি সহ কোনও প্রিন্টার ইনস্টল করা না থাকলে, এই কলটি রানটাইম সমস্যার কারণে ব্যর্থ হবে।
প্যারামিটারগুলি
-
printerId
স্ট্রিং
-
কলব্যাক
ফাংশন ঐচ্ছিক
callbackপ্যারামিটারটি দেখতে এইরকম:(response: GetPrinterInfoResponse) => void
-
উত্তর
-
রিটার্ন
-
Promise<GetPrinterInfoResponse>
Chrome 100+Manifest V3 এবং তার পরবর্তী ভার্সনের জন্য শুধু প্রমিস কাজ করে, অন্যান্য প্ল্যাটফর্মের ক্ষেত্রে কলব্যাক ব্যবহার করতে হবে।
getPrinters()
chrome.printing.getPrinters(
callback?: function,
): Promise<Printer[]>
ডিভাইসে উপলভ্য প্রিন্টারের তালিকা দেখায়। এর মধ্যে ম্যানুয়ালি যোগ করা, এন্টারপ্রাইজ ও খুঁজে পাওয়া প্রিন্টার অন্তর্ভুক্ত।
প্যারামিটারগুলি
-
কলব্যাক
ফাংশন ঐচ্ছিক
callbackপ্যারামিটারটি দেখতে এইরকম:(printers: Printer[]) => void
-
প্রিন্টার
-
রিটার্ন
-
<Printer[]>প্রমিস
Chrome 100+Manifest V3 এবং তার পরবর্তী ভার্সনের জন্য শুধু প্রমিস কাজ করে, অন্যান্য প্ল্যাটফর্মের ক্ষেত্রে কলব্যাক ব্যবহার করতে হবে।
submitJob()
chrome.printing.submitJob(
request: SubmitJobRequest,
callback?: function,
): Promise<SubmitJobResponse>
প্রিন্ট করার জন্য জব জমা দেয়। PrintingAPIExtensionsAllowlist নীতিতে এক্সটেনশনটি তালিকাভুক্ত না থাকলে, ব্যবহারকারীকে প্রিন্ট জব গ্রহণ করার জন্য প্রম্পট করা হয়।
Chrome 120-এর আগে, এই ফাংশন কোনও প্রমিস রিটার্ন করেনি।
প্যারামিটারগুলি
-
অনুরোধ
-
কলব্যাক
ফাংশন ঐচ্ছিক
callbackপ্যারামিটারটি দেখতে এইরকম:(response: SubmitJobResponse) => void
-
উত্তর
-
রিটার্ন
-
Promise<SubmitJobResponse>
Chrome 100+Manifest V3 এবং তার পরবর্তী ভার্সনের জন্য শুধু প্রমিস কাজ করে, অন্যান্য প্ল্যাটফর্মের ক্ষেত্রে কলব্যাক ব্যবহার করতে হবে।
ইভেন্ট
onJobStatusChanged
chrome.printing.onJobStatusChanged.addListener(
callback: function,
)
জবের স্ট্যাটাস পরিবর্তন করা হলে ইভেন্ট ফায়ার করা হয়। এটি শুধুমাত্র এই এক্সটেনশনের মাধ্যমে তৈরি করা কাজের জন্য ফায়ার করা হয়।