রিফ্রেশ তারিখ: ২০২৬-০৯-২৫ রোবটস: নোইনডেক্স
বর্ণনা
টেমপ্লেট ব্যবহার করে রিচ নোটিফিকেশন তৈরি করতে chrome.notifications API ব্যবহার করুন এবং এই নোটিফিকেশনগুলো ব্যবহারকারীদের সিস্টেম ট্রে-তে দেখান।
অনুমতি
notificationsপ্রকারভেদ
NotificationBitmap
NotificationButton
বৈশিষ্ট্য
- আইকনইউআরএল
স্ট্রিং ঐচ্ছিক
ক্রোম ৫৯ থেকে বাতিল করা হয়েছেMac OS X ব্যবহারকারীদের জন্য বাটন আইকনগুলো দৃশ্যমান নয়।
- শিরোনাম
স্ট্রিং
NotificationItem
বৈশিষ্ট্য
- বার্তা
স্ট্রিং
এই আইটেমটি সম্পর্কে অতিরিক্ত বিবরণ।
- শিরোনাম
স্ট্রিং
তালিকা বিজ্ঞপ্তির একটি আইটেমের শিরোনাম।
NotificationOptions
বৈশিষ্ট্য
- অ্যাপআইকনমাস্কইউআরএল
স্ট্রিং ঐচ্ছিক
ক্রোম ৫৯ থেকে বাতিল করা হয়েছেMac OS X ব্যবহারকারীদের জন্য অ্যাপ আইকন মাস্কটি দৃশ্যমান নয়।
অ্যাপ আইকন মাস্কের একটি ইউআরএল। ইউআরএল-এর ক্ষেত্রেও iconUrl-এর মতোই একই সীমাবদ্ধতা প্রযোজ্য।
অ্যাপ আইকন মাস্কটি অবশ্যই আলফা চ্যানেলে থাকতে হবে, কারণ ছবিটির শুধুমাত্র আলফা চ্যানেলটিই বিবেচনা করা হবে।
- বোতাম
নোটিফিকেশন বাটন [] ঐচ্ছিক
সর্বোচ্চ দুটি নোটিফিকেশন অ্যাকশন বাটনের জন্য টেক্সট এবং আইকন।
- প্রসঙ্গ বার্তা
স্ট্রিং ঐচ্ছিক
কম ওজনের ফন্ট ব্যবহার করে নোটিফিকেশনের বিষয়বস্তু পরিবর্তন করুন।
- ইভেন্টের সময়
সংখ্যা ঐচ্ছিক
নোটিফিকেশনের সাথে যুক্ত একটি টাইমস্ট্যাম্প, যা ইপকের পরের মিলিসেকেন্ডে পরিমাপ করা হয় (যেমন
Date.now() + n)। - আইকনইউআরএল
স্ট্রিং ঐচ্ছিক
প্রেরকের অ্যাভাটার, অ্যাপ আইকন, অথবা ইমেজ নোটিফিকেশনের জন্য একটি থাম্বনেইলের ইউআরএল।
ইউআরএলগুলো ডেটা ইউআরএল, ব্লব ইউআরএল, অথবা এই এক্সটেনশনের .crx ফাইলের মধ্যে থাকা কোনো রিসোর্সের সাপেক্ষে একটি ইউআরএল হতে পারে।
দ্রষ্টব্য:
notifications.create()মেথডটির জন্য এই মানটি আবশ্যক। - ছবির ইউআরএল
স্ট্রিং ঐচ্ছিক
ক্রোম ৫৯ থেকে বাতিল করা হয়েছেম্যাক ওএস এক্স ব্যবহারকারীরা ছবিটি দেখতে পাচ্ছেন না।
ইমেজ-টাইপ নোটিফিকেশনের জন্য ইমেজ থাম্বনেইলের একটি ইউআরএল। ইউআরএল-এর ক্ষেত্রেও আইকনইউআরএল-এর মতোই একই সীমাবদ্ধতা প্রযোজ্য।
- ক্লিকযোগ্য
বুলিয়ান ঐচ্ছিক
ক্রোম ৬৭ থেকে বাতিল করা হয়েছেক্রোম ৬৭ থেকে এই UI ইঙ্গিতটি উপেক্ষা করা হয়।
- আইটেম
বিজ্ঞপ্তি আইটেম [] ঐচ্ছিক
একাধিক আইটেমযুক্ত নোটিফিকেশনের জন্য আইটেমসমূহ। Mac OS X ব্যবহারকারীরা শুধুমাত্র প্রথম আইটেমটি দেখতে পান।
- বার্তা
স্ট্রিং ঐচ্ছিক
বিজ্ঞপ্তির মূল বিষয়বস্তু।
দ্রষ্টব্য:
notifications.create()মেথডটির জন্য এই মানটি আবশ্যক। - অগ্রাধিকার
সংখ্যা ঐচ্ছিক
অগ্রাধিকারের সীমা -২ থেকে ২ পর্যন্ত। -২ হলো সর্বনিম্ন অগ্রাধিকার। ২ হলো সর্বোচ্চ। শূন্য হলো ডিফল্ট। যেসব প্ল্যাটফর্মে নোটিফিকেশন সেন্টার নেই (যেমন উইন্ডোজ, লিনাক্স ও ম্যাক), সেখানে -২ এবং -১ ব্যবহার করলে একটি ত্রুটি দেখা দেয়, কারণ এই অগ্রাধিকারের নোটিফিকেশনগুলো একেবারেই দেখানো হয় না।
- অগ্রগতি
সংখ্যা ঐচ্ছিক
বর্তমান অগ্রগতির সীমা ০ থেকে ১০০ পর্যন্ত।
- মিথস্ক্রিয়া প্রয়োজন
বুলিয়ান ঐচ্ছিক
ক্রোম ৫০+এটি নির্দেশ করে যে, ব্যবহারকারী নোটিফিকেশনটি সক্রিয় বা বাতিল না করা পর্যন্ত তা স্ক্রিনে দৃশ্যমান থাকবে। এর ডিফল্ট মান হলো 'ফলস'।
- নীরব
বুলিয়ান ঐচ্ছিক
ক্রোম ৭০+এটি নির্দেশ করে যে নোটিফিকেশনটি দেখানোর সময় কোনো শব্দ বা কম্পন হবে না। এর ডিফল্ট মান হলো ফলস।
- শিরোনাম
স্ট্রিং ঐচ্ছিক
বিজ্ঞপ্তির শিরোনাম (যেমন ইমেইলের ক্ষেত্রে প্রেরকের নাম)।
দ্রষ্টব্য:
notifications.create()মেথডটির জন্য এই মানটি আবশ্যক। - প্রকার
টেমপ্লেটটাইপ ঐচ্ছিক
কোন ধরনের নোটিফিকেশন প্রদর্শন করতে হবে।
notifications.createমেথডের জন্য এটি আবশ্যক ।
PermissionLevel
এনাম
মঞ্জুর করা হয়েছে "অস্বীকৃত"
এটি নির্দেশ করে যে ব্যবহারকারী অ্যাপ বা এক্সটেনশন থেকে নোটিফিকেশন দেখানোর জন্য নির্বাচন করেছেন। ইনস্টল করার সময় এটিই ডিফল্ট হিসেবে থাকে।
এটি নির্দেশ করে যে ব্যবহারকারী অ্যাপ বা এক্সটেনশন থেকে নোটিফিকেশন না দেখানোর সিদ্ধান্ত নিয়েছেন।
TemplateType
এনাম
"মৌলিক" "ছবি" "তালিকা" "অগ্রগতি"
এতে একটি আইকন, শিরোনাম, বার্তা, বিস্তারিত বার্তা এবং সর্বোচ্চ দুটি বাটন থাকে।
এতে একটি আইকন, শিরোনাম, বার্তা, বিস্তারিত বার্তা, ছবি এবং সর্বোচ্চ দুটি বাটন থাকে।
এতে একটি আইকন, শিরোনাম, বার্তা, আইটেম এবং সর্বোচ্চ দুটি বাটন থাকে। Mac OS X ব্যবহারকারীরা শুধুমাত্র প্রথম আইটেমটি দেখতে পান।
এতে একটি আইকন, শিরোনাম, বার্তা, অগ্রগতি এবং সর্বোচ্চ দুটি বাটন রয়েছে।
পদ্ধতি
clear()
chrome.notifications.clear(
notificationId: string,
callback?: function,
): Promise<boolean>
নির্দিষ্ট বিজ্ঞপ্তিটি মুছে ফেলে।
প্যারামিটার
- বিজ্ঞপ্তি আইডি
স্ট্রিং
যে নোটিফিকেশনটি মুছে ফেলতে হবে তার আইডি। এটি
notifications.createমেথড দ্বারা ফেরত দেওয়া হয়। - কলব্যাক
ফাংশন ঐচ্ছিক
callbackপ্যারামিটারটি দেখতে এইরকম:(wasCleared: boolean) => void
- পরিষ্কার করা হয়েছিল
বুলিয়ান
ফেরত
প্রতিশ্রুতি<বুলিয়ান>
ক্রোম ১১৬+একটি প্রমিস রিটার্ন করে, যা রিজলভ হয়ে একটি মিলে যাওয়া নোটিফিকেশন বিদ্যমান ছিল কিনা তা নির্দেশ করে।
প্রমিস শুধুমাত্র ম্যানিফেস্ট ভি৩ এবং এর পরবর্তী সংস্করণগুলোতে সমর্থিত, অন্যান্য প্ল্যাটফর্মে কলব্যাক ব্যবহার করতে হবে।
create()
chrome.notifications.create(
notificationId?: string,
options: NotificationOptions,
callback?: function,
): Promise<string>
একটি নোটিফিকেশন তৈরি করে এবং প্রদর্শন করে।
প্যারামিটার
- বিজ্ঞপ্তি আইডি
স্ট্রিং ঐচ্ছিক
নোটিফিকেশনের শনাক্তকারী। যদি সেট করা না থাকে বা খালি থাকে, তাহলে স্বয়ংক্রিয়ভাবে একটি আইডি তৈরি হবে। যদি এটি বিদ্যমান কোনো নোটিফিকেশনের সাথে মিলে যায়, তবে এই পদ্ধতিটি তৈরির কাজটি শুরু করার আগে প্রথমে সেই নোটিফিকেশনটি মুছে ফেলে। শনাক্তকারীটি ৫০০ অক্ষরের বেশি হতে পারবে না।
ক্রোম ৪২-এর আগে
notificationIdপ্যারামিটারটি আবশ্যক। - বিকল্পগুলি
বিজ্ঞপ্তির বিষয়বস্তু।
- কলব্যাক
ফাংশন ঐচ্ছিক
callbackপ্যারামিটারটি দেখতে এইরকম:(notificationId: string) => void
- বিজ্ঞপ্তি আইডি
স্ট্রিং
ফেরত
প্রতিশ্রুতি<string>
ক্রোম ১১৬+একটি প্রমিজ রিটার্ন করে যা তৈরি হওয়া নোটিফিকেশনটির আইডি (প্রদত্ত বা জেনারেট করা) দিয়ে রিজলভ হয়।
প্রমিস শুধুমাত্র ম্যানিফেস্ট ভি৩ এবং এর পরবর্তী সংস্করণগুলোতে সমর্থিত, অন্যান্য প্ল্যাটফর্মে কলব্যাক ব্যবহার করতে হবে।
getAll()
chrome.notifications.getAll(
callback?: function,
): Promise<object>
এই অ্যাপ বা এক্সটেনশনের সমস্ত নোটিফিকেশন পুনরুদ্ধার করে।
প্যারামিটার
- কলব্যাক
ফাংশন ঐচ্ছিক
callbackপ্যারামিটারটি দেখতে এইরকম:(notifications: object) => void
- বিজ্ঞপ্তি
বস্তু
ফেরত
প্রতিশ্রুতি<object>
ক্রোম ১১৬+একটি প্রমিজ রিটার্ন করে যা সিস্টেমে বর্তমানে থাকা notification_id-গুলোর সেট দিয়ে রিজলভ হয়।
প্রমিস শুধুমাত্র ম্যানিফেস্ট ভি৩ এবং এর পরবর্তী সংস্করণগুলোতে সমর্থিত, অন্যান্য প্ল্যাটফর্মে কলব্যাক ব্যবহার করতে হবে।
getPermissionLevel()
chrome.notifications.getPermissionLevel(
callback?: function,
): Promise<PermissionLevel>
ব্যবহারকারী এই অ্যাপ বা এক্সটেনশন থেকে নোটিফিকেশন চালু করেছেন কিনা তা যাচাই করে।
প্যারামিটার
- কলব্যাক
ফাংশন ঐচ্ছিক
callbackপ্যারামিটারটি দেখতে এইরকম:(level: PermissionLevel) => void
- স্তর
ফেরত
প্রতিশ্রুতি< অনুমতির স্তর >
ক্রোম ১১৬+একটি প্রমিজ রিটার্ন করে যা বর্তমান পারমিশন লেভেল অনুযায়ী রিজলভ হয়।
প্রমিস শুধুমাত্র ম্যানিফেস্ট ভি৩ এবং এর পরবর্তী সংস্করণগুলোতে সমর্থিত, অন্যান্য প্ল্যাটফর্মে কলব্যাক ব্যবহার করতে হবে।
update()
chrome.notifications.update(
notificationId: string,
options: NotificationOptions,
callback?: function,
): Promise<boolean>
বিদ্যমান একটি নোটিফিকেশন আপডেট করে।
প্যারামিটার
- বিজ্ঞপ্তি আইডি
স্ট্রিং
যে নোটিফিকেশনটি আপডেট করা হবে তার আইডি। এটি
notifications.createমেথড দ্বারা রিটার্ন করা হয়। - বিকল্পগুলি
আপডেট করার জন্য বিজ্ঞপ্তির বিষয়বস্তু।
- কলব্যাক
ফাংশন ঐচ্ছিক
callbackপ্যারামিটারটি দেখতে এইরকম:(wasUpdated: boolean) => void
- আপডেট করা হয়েছিল
বুলিয়ান
ফেরত
প্রতিশ্রুতি<বুলিয়ান>
ক্রোম ১১৬+একটি প্রমিস রিটার্ন করে, যা রিজলভ হয়ে একটি মিলে যাওয়া নোটিফিকেশন বিদ্যমান ছিল কিনা তা নির্দেশ করে।
প্রমিস শুধুমাত্র ম্যানিফেস্ট ভি৩ এবং এর পরবর্তী সংস্করণগুলোতে সমর্থিত, অন্যান্য প্ল্যাটফর্মে কলব্যাক ব্যবহার করতে হবে।
ইভেন্টগুলি
onButtonClicked
chrome.notifications.onButtonClicked.addListener(
callback: function,
)
ব্যবহারকারী নোটিফিকেশনে থাকা একটি বাটন চাপলেন।
প্যারামিটার
- কলব্যাক
ফাংশন
callbackপ্যারামিটারটি দেখতে এইরকম:(notificationId: string, buttonIndex: number) => void
- বিজ্ঞপ্তি আইডি
স্ট্রিং
- বোতাম সূচক
সংখ্যা
onClicked
chrome.notifications.onClicked.addListener(
callback: function,
)
ব্যবহারকারী নোটিফিকেশনের বাটন নয় এমন একটি অংশে ক্লিক করেছেন।
প্যারামিটার
- কলব্যাক
ফাংশন
callbackপ্যারামিটারটি দেখতে এইরকম:(notificationId: string) => void
- বিজ্ঞপ্তি আইডি
স্ট্রিং
onClosed
chrome.notifications.onClosed.addListener(
callback: function,
)
সিস্টেম অথবা ব্যবহারকারীর পদক্ষেপের মাধ্যমে নোটিফিকেশনটি বন্ধ করা হয়েছে।
প্যারামিটার
- কলব্যাক
ফাংশন
callbackপ্যারামিটারটি দেখতে এইরকম:(notificationId: string, byUser: boolean) => void
- বিজ্ঞপ্তি আইডি
স্ট্রিং
- ব্যবহারকারী দ্বারা
বুলিয়ান
onPermissionLevelChanged
chrome.notifications.onPermissionLevelChanged.addListener(
callback: function,
)
ব্যবহারকারী অনুমতির স্তর পরিবর্তন করেন। ক্রোম ৪৭ থেকে, শুধুমাত্র ক্রোমওএস-এরই এমন একটি ইউআই (UI) আছে যা এই ইভেন্টটি প্রেরণ করে।
প্যারামিটার
- কলব্যাক
ফাংশন
callbackপ্যারামিটারটি দেখতে এইরকম:(level: PermissionLevel) => void
- স্তর
onShowSettings
chrome.notifications.onShowSettings.addListener(
callback: function,
)
কাস্টম নোটিফিকেশন সেটিংস বাটনটি এখন আর সমর্থিত নয়।
ব্যবহারকারী অ্যাপটির নোটিফিকেশন সেটিংসের লিঙ্কে ক্লিক করেছেন। ক্রোম ৪৭ অনুযায়ী, শুধুমাত্র ক্রোমওএস-এরই এমন একটি ইউআই ছিল যা এই ইভেন্টটি প্রেরণ করত। ক্রোম ৬৫ অনুযায়ী, সেই ইউআইটি ক্রোমওএস থেকেও সরিয়ে ফেলা হয়েছে।
প্যারামিটার
- কলব্যাক
ফাংশন
callbackপ্যারামিটারটি দেখতে এইরকম:() => void