Firebase Cloud Messaging মেসেজের ধরন

FCM-এর মাধ্যমে, আপনি নিজের ক্লায়েন্ট অ্যাপে দুই ধরনের মেসেজ পাঠাতে পারবেন:

  • "ডিসপ্লে মেসেজ"-এর মতো বিজ্ঞপ্তি মেসেজ FCM SDK অটোমেটিক ম্যানেজ করে।
  • ডেটা মেসেজ, যা ক্লায়েন্ট অ্যাপ ম্যানেজ করে।

বিজ্ঞপ্তি মেসেজে ব্যবহারকারীর-দৃশ্যমান কী-এর একটি পূর্বনির্ধারিত সেট থাকে এবং এতে একটি ঐচ্ছিক ডেটা পেলোড থাকতে পারে। অন্যদিকে, ডেটা মেসেজে শুধুমাত্র আপনার ব্যবহারকারী-নির্ধারিত কাস্টম কী-ভ্যালু পেয়ার থাকে। দুটি মেসেজ ধরনের ক্ষেত্রেই সর্বাধিক পেলোড হল ৪০৯৬ বাইট, তবে Firebase কনসোল থেকে মেসেজ পাঠানোর সময় ১০০০ অক্ষরের সীমা প্রয়োগ করা হয়।

পরিস্থিতি ব্যবহার করুন কীভাবে পাঠাতে হয়
বিজ্ঞপ্তি মেসেজ FCM SDK ব্যাকগ্রাউন্ডে চলার সময় ক্লায়েন্ট অ্যাপের হয়ে ব্যবহারকারীর ডিভাইসে মেসেজ দেখায়। অন্যথায়, বিজ্ঞপ্তি পাওয়ার সময় অ্যাপটি ফোরগ্রাউন্ডে চলতে থাকলে, অ্যাপের কোড আচরণ নির্ধারণ করে।
  1. Cloud Functions বা আপনার অ্যাপ সার্ভারের মতো বিশ্বস্ত পরিবেশে, Firebase Admin SDK বা HTTP v1 API ব্যবহার করুন। notification কী সেট করুন। ঐচ্ছিক ডেটা পেলোড থাকতে পারে। সবসময় আড়াল করা যায়।

    কিছু ডিসপ্লে বিজ্ঞপ্তির উদাহরণ দেখুন এবং অনুরোধ পেলোড পাঠান।

  2. বিজ্ঞপ্তি কম্পোজার ব্যবহার করুন: মেসেজের টেক্সট, শীর্ষক ইত্যাদি লিখুন এবং পাঠান। কাস্টম ডেটা প্রদান করে ঐচ্ছিক ডেটা পেলোড যোগ করুন।
ডেটা মেসেজ ডেটা মেসেজ প্রসেস করার দায়িত্ব ক্লায়েন্ট অ্যাপের। ডেটা মেসেজে রিজার্ভ করা কী-এর নাম নেই, শুধুমাত্র কাস্টম কী-ভ্যালু পেয়ার আছে (নিচে দেখুন)। Cloud Functions বা আপনার অ্যাপ সার্ভারের মতো বিশ্বস্ত এনভায়রনমেন্টে, Firebase Admin SDK বা HTTP v1 API ব্যবহার করুন। অনুরোধ পাঠানোর সময়, data কী সেট করুন।

আপনি বিজ্ঞপ্তি মেসেজ ব্যবহার করতে পারেন যখন আপনি চান যে FCM SDK অটোমেটিক বিজ্ঞপ্তি দেখানোর কাজটি ম্যানেজ করুক, যখন আপনার অ্যাপ ব্যাকগ্রাউন্ডে চলছে। FCM ঐচ্ছিক ডেটা পেলোড সহ বিজ্ঞপ্তি মেসেজ পাঠাতে পারে। এই ধরনের ক্ষেত্রে, FCM বিজ্ঞপ্তি পেলোড দেখায় এবং ক্লায়েন্ট অ্যাপ ডেটা পেলোড ম্যানেজ করে।

আপনি নিজের ক্লায়েন্ট অ্যাপ কোড দিয়ে মেসেজ প্রসেস করতে চাইলে, ডেটা মেসেজ ব্যবহার করতে পারেন।

বিজ্ঞপ্তি মেসেজ

আপনি Firebase কনসোল, Firebase Admin SDK অথবা FCM HTTP v1 API ব্যবহার করে বিজ্ঞপ্তি মেসেজ পাঠাতে পারবেন। Firebase কনসোল, অ্যানালিটিক্স-ভিত্তিক A/B টেস্টিং প্রদান করে, যা আপনাকে বিজ্ঞপ্তি মেসেজ রিফাইন ও উন্নত করতে সাহায্য করে।

Firebase Admin SDK বা FCM HTTP v1 API ব্যবহার করে বিজ্ঞপ্তি মেসেজ পাঠাতে, বিজ্ঞপ্তি মেসেজের আগে থেকে নির্ধারিত কী-ভ্যালু বিকল্পের সেটের সাথে notification কী সেট করুন। IM অ্যাপে বিজ্ঞপ্তি মেসেজ ফর্ম্যাট করতে আপনি নিম্নলিখিত উদাহরণ ব্যবহার করতে পারেন

{
  "message":{
    "token":"bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1...",
    "notification":{
      "title":"Portugal vs. Denmark",
      "body":"great match!"
    }
  }
}

অ্যাপ ব্যাকগ্রাউন্ডে থাকলে বিজ্ঞপ্তি মেসেজ বিজ্ঞপ্তি ট্রেতে ডেলিভার করা হয়। ফোরগ্রাউন্ডে থাকা অ্যাপের জন্য, মেসেজগুলি একটি কলব্যাক ফাংশন দ্বারা ম্যানেজ করা হয়।

বিজ্ঞপ্তি মেসেজ তৈরি করার জন্য উপলভ্য আগে থেকে নির্ধারিত কী-এর সম্পূর্ণ তালিকার জন্য আপনি FCM HTTP v1 API বিজ্ঞপ্তি অবজেক্ট রেফারেন্স ডকুমেন্টেশন ব্যবহার করতে পারেন।

ডেটা মেসেজ

আপনার পছন্দের এনক্রিপশন স্কিম প্রয়োগ করার জন্য আপনি কীভাবে FCM পেলোড data ব্যবহার করতে চান তা আপনার উপর নির্ভর করে। দেখে নেবেন যে আপনার কাস্টম কী-ভ্যালু পেয়ারে কোনও রিজার্ভ করা শব্দ ব্যবহার না করেন। রিজার্ভ করা শব্দের মধ্যে from, message_type বা google., gcm. বা gcm.notification. দিয়ে শুরু হওয়া যেকোনও শব্দ পড়ে।

নিম্নলিখিত উদাহরণে টপ-লেভেল বা সাধারণ ডেটা ফিল্ডের ব্যবহার দেখানো হয়েছে, যা মেসেজ পাওয়া সব প্ল্যাটফর্মের ক্লায়েন্টরা ব্যাখ্যা করে। প্রতিটি প্ল্যাটফর্মে, ক্লায়েন্ট অ্যাপ কলব্যাক ফাংশনে ডেটা পেলোড পায়

{
  "message":{
    "token":"bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1...",
    "data":{
      "Nick" : "Mario",
      "body" : "great match!",
      "Room" : "PortugalVSDenmark"
    }
  }
}

ঐচ্ছিক ডেটা পেলোড সহ বিজ্ঞপ্তি মেসেজ

আপনি প্রোগ্র্যামাটিক প্রসেসে বা Firebase কনসোল ব্যবহার করে কাস্টম কী-ভ্যালু পেয়ারের ঐচ্ছিক পেলোড সহ বিজ্ঞপ্তি মেসেজ পাঠাতে পারবেন। বিজ্ঞপ্তি কম্পোজার-এ, উন্নত বিকল্প-এ কাস্টম ডেটা ফিল্ড ব্যবহার করুন।

বিজ্ঞপ্তি ও ডেটা, দুটিই আছে এমন মেসেজ পেলে অ্যাপের আচরণ পেলোড নির্ভর করে অ্যাপটি ব্যাকগ্রাউন্ডে আছে নাকি ফোরগ্রাউন্ডে—মূলত, মেসেজ পাওয়ার সময় সেটি অ্যাক্টিভ আছে কিনা তার উপর।

  • ব্যাকগ্রাউন্ডে থাকাকালীন, অ্যাপ বিজ্ঞপ্তি ট্রেতে বিজ্ঞপ্তি পেলোড পায় এবং ব্যবহারকারী বিজ্ঞপ্তিতে ট্যাপ করলে তবেই ডেটা পেলোড ম্যানেজ করে।
  • ফোরগ্রাউন্ডে চলাকালীন, আপনার অ্যাপ উপলভ্য দুটি পেলোড সহ মেসেজ অবজেক্ট পায়।

এখানে JSON-ফর্ম্যাট করা মেসেজ দেওয়া হল যাতে notification কী এবং data কী, দুটিই আছে:

{
  "message":{
    "token":"bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1...",
    "notification":{
      "title":"Portugal vs. Denmark",
      "body":"great match!"
    },
    "data" : {
      "Nick" : "Mario",
      "Room" : "PortugalVSDenmark"
    }
  }
}