chrome.gcm

রিফ্রেশ তারিখ: ২০২৬-০৯-২৫ রোবটস: নোইনডেক্স

বর্ণনা

অ্যাপ এবং এক্সটেনশনগুলিকে ফায়ারবেস ক্লাউড মেসেজিং (FCM)-এর মাধ্যমে বার্তা পাঠাতে ও গ্রহণ করতে chrome.gcm ব্যবহার করুন।

অনুমতি

gcm

বৈশিষ্ট্য

MAX_MESSAGE_SIZE

একটি মেসেজে থাকা সকল কী/ভ্যালু পেয়ারের সর্বোচ্চ আকার (বাইটে)।

মূল্য

৪০৯৬

পদ্ধতি

register()

প্রতিশ্রুতি
chrome.gcm.register(
  senderIds: string[],
  callback?: function,
): Promise<string>

অ্যাপ্লিকেশনটিকে FCM-এর সাথে রেজিস্টার করে। রেজিস্ট্রেশন আইডিটি callback মাধ্যমে ফেরত দেওয়া হবে। যদি একই senderIds তালিকা দিয়ে register আবার কল করা হয়, তাহলে একই রেজিস্ট্রেশন আইডি ফেরত দেওয়া হবে।

প্যারামিটার

  • প্রেরক আইডি

    স্ট্রিং[]

    অ্যাপ্লিকেশনটিতে বার্তা পাঠানোর অনুমতিপ্রাপ্ত সার্ভার আইডিগুলোর একটি তালিকা। এতে কমপক্ষে একটি এবং সর্বাধিক ১০০টি প্রেরক আইডি থাকতে হবে।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি দেখতে এইরকম: 

    (registrationId: string) => void

    • নিবন্ধন আইডি

      স্ট্রিং

      এফসিএম কর্তৃক অ্যাপ্লিকেশনটিকে বরাদ্দকৃত একটি রেজিস্ট্রেশন আইডি।

ফেরত

  • প্রতিশ্রুতি<string>

    ক্রোম ১১৬+

    নিবন্ধন সম্পন্ন হলে সমাধান হয়।

    প্রমিস শুধুমাত্র ম্যানিফেস্ট ভি৩ এবং এর পরবর্তী সংস্করণগুলোতে সমর্থিত, অন্যান্য প্ল্যাটফর্মে কলব্যাক ব্যবহার করতে হবে।

send()

প্রতিশ্রুতি
chrome.gcm.send(
  message: object,
  callback?: function,
): Promise<string>

এর বিষয়বস্তু অনুযায়ী বার্তা পাঠায়।

প্যারামিটার

  • বার্তা

    বস্তু

    FCM-এর মাধ্যমে অপর পক্ষের কাছে পাঠানোর জন্য একটি বার্তা।

    • ডেটা

      বস্তু

      সার্ভারে পাঠানোর জন্য বার্তার ডেটা। কেস-ইনসেনসিটিভ goog. এবং google , সেইসাথে কেস-সেনসিটিভ collapse_key কী প্রিফিক্স হিসেবে অনুমোদিত নয়। সমস্ত কী/ভ্যালু পেয়ারের যোগফল gcm.MAX_MESSAGE_SIZE বেশি হওয়া উচিত নয়।

    • গন্তব্য আইডি

      স্ট্রিং

      গুগল এপিআই কনসোল দ্বারা নির্ধারিত, বার্তাটি পাঠানোর জন্য সার্ভারের আইডি।

    • বার্তা আইডি

      স্ট্রিং

      মেসেজের আইডি। অ্যাপ্লিকেশনগুলোর আওতাধীন প্রতিটি মেসেজের জন্য এটি অবশ্যই অনন্য হতে হবে। আইডি নির্বাচন ও পরিচালনার বিষয়ে পরামর্শের জন্য ক্লাউড মেসেজিং ডকুমেন্টেশন দেখুন।

    • বেঁচে থাকার সময়

      সংখ্যা ঐচ্ছিক

      সেকেন্ডে মেসেজটির টিকে থাকার সময়কাল। যদি সেই সময়ের মধ্যে মেসেজটি পাঠানো সম্ভব না হয়, তাহলে একটি onSendError ইভেন্ট তৈরি হবে। টিকে থাকার সময়কাল ০ হলে বোঝায় যে মেসেজটি অবিলম্বে পাঠানো উচিত, অথবা পাঠানো সম্ভব না হলে তা ব্যর্থ হবে। টিকে থাকার সময়কালের ডিফল্ট মান হলো ৮৬,৪০০ সেকেন্ড (১ দিন) এবং সর্বোচ্চ মান হলো ২,৪১৯,২০০ সেকেন্ড (২৮ দিন)।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি দেখতে এইরকম: 

    (messageId: string) => void

    • বার্তা আইডি

      স্ট্রিং

      যে মেসেজটির জন্য কলব্যাকটি জারি করা হয়েছিল, তার আইডি।

ফেরত

  • প্রতিশ্রুতি<string>

    ক্রোম ১১৬+

    বার্তাটি প্রেরণের জন্য সফলভাবে সারিবদ্ধ হওয়ার পর এটি সমাধান হয়। কোনো ত্রুটি ঘটলে, প্রমিসটি প্রত্যাখ্যাত হবে।

    প্রমিস শুধুমাত্র ম্যানিফেস্ট ভি৩ এবং এর পরবর্তী সংস্করণগুলোতে সমর্থিত, অন্যান্য প্ল্যাটফর্মে কলব্যাক ব্যবহার করতে হবে।

unregister()

প্রতিশ্রুতি
chrome.gcm.unregister(
  callback?: function,
): Promise<void>

FCM থেকে অ্যাপ্লিকেশনটির নিবন্ধন বাতিল করে।

প্যারামিটার

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি দেখতে এইরকম: 

    () => void

ফেরত

  • প্রতিশ্রুতি<শূন্য>

    ক্রোম ১১৬+

    নিবন্ধন বাতিল সম্পন্ন হওয়ার পর এটি সমাধান হয়। যদি প্রমিসটি প্রত্যাখ্যাত না হয়, তবে নিবন্ধন বাতিল সফল হয়েছে বলে ধরা হয়।

    প্রমিস শুধুমাত্র ম্যানিফেস্ট ভি৩ এবং এর পরবর্তী সংস্করণগুলোতে সমর্থিত, অন্যান্য প্ল্যাটফর্মে কলব্যাক ব্যবহার করতে হবে।

ইভেন্টগুলি

onMessage

chrome.gcm.onMessage.addListener(
  callback: function,
)

FCM-এর মাধ্যমে কোনো বার্তা পেলে এটি সক্রিয় হয়।

প্যারামিটার

  • কলব্যাক

    ফাংশন

    callback প্যারামিটারটি দেখতে এইরকম: 

    (message: object) => void

    • বার্তা

      বস্তু

      • কলাপসকি

        স্ট্রিং ঐচ্ছিক

        একটি বার্তা সংকুচিত করার কী। বিস্তারিত জানতে অসংকুচিত এবং সংকুচিতযোগ্য বার্তাগুলো দেখুন।

      • ডেটা

        বস্তু

        বার্তার তথ্য।

      • থেকে

        স্ট্রিং ঐচ্ছিক

        প্রেরক যিনি বার্তাটি জারি করেছেন।

onMessagesDeleted

chrome.gcm.onMessagesDeleted.addListener(
  callback: function,
)

যখন কোনো অ্যাপ সার্ভার থেকে অ্যাপ্লিকেশনে পাঠানো মেসেজ FCM সার্ভারকে মুছে ফেলতে হয়, তখন এই ইভেন্টটি ট্রিগার হয়। এই ইভেন্টটি কীভাবে পরিচালনা করতে হয়, সে সম্পর্কে বিস্তারিত জানতে 'মেসেজের জীবনকাল' দেখুন।

প্যারামিটার

  • কলব্যাক

    ফাংশন

    callback প্যারামিটারটি দেখতে এইরকম: 

    () => void

onSendError

chrome.gcm.onSendError.addListener(
  callback: function,
)

FCM সার্ভারে বার্তা পাঠানো সম্ভব না হলে এটি ট্রিগার হয়।

প্যারামিটার

  • কলব্যাক

    ফাংশন

    callback প্যারামিটারটি দেখতে এইরকম: 

    (error: object) => void

    • ত্রুটি

      বস্তু

      • বিস্তারিত

        বস্তু

        ত্রুটি সম্পর্কিত অতিরিক্ত বিবরণ, যখন পাওয়া যাবে।

      • ত্রুটির বার্তা

        স্ট্রিং

        সমস্যাটি বর্ণনা করে এমন ত্রুটি বার্তা।

      • বার্তা আইডি

        স্ট্রিং ঐচ্ছিক

        এই ত্রুটিযুক্ত বার্তাটির আইডি, যদি ত্রুটিটি কোনো নির্দিষ্ট বার্তার সাথে সম্পর্কিত হয়।