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

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

• "ডিসপ্লে মেসেজ"-এর মতো বিজ্ঞপ্তি মেসেজ, FCM SDK অটোমেটিক ম্যানেজ করে। (Android-এ AndroidConfigV2-এর সাথে, ব্যবহারকারী-দৃশ্যমান বিজ্ঞপ্তি দেখায় এমন সব মেসেজের জন্য RemoteNotification ব্যবহার করুন যাতে সেগুলি কোনও ইচ্ছাকৃত বিলম্ব ছাড়াই ডেলিভার করা হয়; ক্লায়েন্ট কোডে স্পষ্টভাবে সাইলেন্ট করা না থাকলে, অ্যাপটি ফোরগ্রাউন্ডে বা ব্যাকগ্রাউন্ডে যেখানেই থাকুক না কেন, বিজ্ঞপ্তিগুলি অটোমেটিক দেখানো হয়।)
• ডেটা মেসেজ, যা ক্লায়েন্ট অ্যাপের মাধ্যমে ম্যানেজ করা হয়।

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

আপনার অ্যাপ ব্যাকগ্রাউন্ডে চলার সময় অটোমেটিক বিজ্ঞপ্তি দেখানোর জন্য 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"
    }
  }
}