C++ অ্যাপে Firebase ক্লাউড মেসেজিং শুরু করুন

এই নির্দেশিকাটি বর্ণনা করে যে কীভাবে আপনার C++ ক্লায়েন্ট অ্যাপগুলিতে Firebase Cloud Messaging শুরু করবেন যাতে আপনি নির্ভরযোগ্যভাবে বার্তা পাঠাতে পারেন।

C++ দিয়ে আপনার ক্রস-প্ল্যাটফর্ম Firebase Cloud Messaging ক্লায়েন্ট অ্যাপটি লেখার জন্য, Firebase Cloud Messaging API ব্যবহার করুন। C++ SDK Android এবং Apple উভয় প্ল্যাটফর্মের জন্যই কাজ করে, প্রতিটি প্ল্যাটফর্মের জন্য কিছু অতিরিক্ত সেটআপ প্রয়োজন। iOS এবং Android এর জন্য C++ SDK FCM সাথে কীভাবে কাজ করে সে সম্পর্কে আরও জানতে, Understand Firebase for C++ দেখুন।

Firebase এবং FCM SDK সেট আপ করুন

FCM রেজিস্ট্রেশন টোকেন অ্যাক্সেস করুন

Firebase ক্লাউড মেসেজিং লাইব্রেরি শুরু করার পরে, ক্লায়েন্ট অ্যাপ ইনস্ট্যান্সের জন্য একটি নিবন্ধন টোকেন অনুরোধ করা হয়। অ্যাপটি OnTokenReceived কলব্যাকের মাধ্যমে টোকেনটি গ্রহণ করবে, যা firebase::messaging::Listener প্রয়োগকারী ক্লাসে সংজ্ঞায়িত করা উচিত।

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

অ্যান্ড্রয়েডে বার্তা বিতরণ সম্পর্কে নোট

যখন অ্যাপটি একেবারেই চালু না থাকে এবং ব্যবহারকারী কোনও বিজ্ঞপ্তিতে ট্যাপ করেন, তখন ডিফল্টরূপে বার্তাটি FCM এর অন্তর্নির্মিত কলব্যাকের মাধ্যমে রাউট করা হয় না। এই ক্ষেত্রে, অ্যাপ্লিকেশনটি শুরু করার জন্য ব্যবহৃত একটি Intent এর মাধ্যমে বার্তা পেলোডগুলি গৃহীত হয়। FCM এই আগত বার্তাগুলিকে C++ লাইব্রেরি কলব্যাকে ফরোয়ার্ড করতে, আপনাকে আপনার Activity-এ onNewIntent পদ্ধতিটি ওভাররাইড করতে হবে এবং Intent টি MessageForwardingService এ পাস করতে হবে।

import com.google.firebase.messaging.MessageForwardingService;

class MyActivity extends Activity {
  private static final String TAG = "MyActvity";

  @Override
  protected void onNewIntent(Intent intent) {
    Log.d(TAG, "A message was sent to this app while it was in the background.");
    Intent message = new Intent(this, MessageForwardingService.class);
    message.setAction(MessageForwardingService.ACTION_REMOTE_INTENT);
    message.putExtras(intent);
    message.setData(intent.getData());
    // For older versions of Firebase C++ SDK (< 7.1.0), use `startService`.
    // startService(message);
    MessageForwardingService.enqueueWork(this, message);
  }
}

অ্যাপটি ব্যাকগ্রাউন্ডে থাকাকালীন প্রাপ্ত বার্তাগুলির বিজ্ঞপ্তি ক্ষেত্রের বিষয়বস্তু সিস্টেম ট্রে বিজ্ঞপ্তি পূরণ করার জন্য ব্যবহৃত হয়, কিন্তু সেই বিজ্ঞপ্তি সামগ্রী FCM এ জানানো হবে না। অর্থাৎ, Message::notification একটি শূন্য হবে।

সংক্ষেপে:

অ্যান্ড্রয়েডে কাস্টম বার্তা পরিচালনা

ডিফল্টরূপে, অ্যাপে প্রেরিত বিজ্ঞপ্তিগুলি ::firebase::messaging::Listener::OnMessageReceived এ পাঠানো হয়, তবে কিছু ক্ষেত্রে আপনি ডিফল্ট আচরণটি ওভাররাইড করতে চাইতে পারেন। অ্যান্ড্রয়েডে এটি করার জন্য আপনাকে কাস্টম ক্লাস লিখতে হবে যা com.google.firebase.messaging.cpp.ListenerService প্রসারিত করে এবং আপনার প্রকল্পের AndroidManifest.xml আপডেট করতে হবে।

ListenerService পদ্ধতিগুলি ওভাররাইড করুন

ListenerService হল জাভা ক্লাস যা অ্যাপে প্রেরিত ইনকামিং মেসেজগুলিকে আটকে রাখে এবং C++ লাইব্রেরিতে পাঠায়। যখন অ্যাপটি ফোরগ্রাউন্ডে থাকে (অথবা যখন অ্যাপটি ব্যাকগ্রাউন্ডে থাকে এবং এটি একটি ডেটা-অনলি পেলোড গ্রহণ করে), তখন বার্তাগুলি এই ক্লাসে প্রদত্ত কলব্যাকগুলির একটির মধ্য দিয়ে যাবে। মেসেজ হ্যান্ডলিংয়ে কাস্টম আচরণ যোগ করতে, আপনাকে FCM এর ডিফল্ট ListenerService প্রসারিত করতে হবে:

import com.google.firebase.messaging.cpp.ListenerService;

class MyListenerService extends ListenerService {

ListenerService.onMessageReceived পদ্ধতিটি ওভাররাইড করে, আপনি প্রাপ্ত RemoteMessage অবজেক্টের উপর ভিত্তি করে ক্রিয়া সম্পাদন করতে পারেন এবং বার্তার ডেটা পেতে পারেন:

@Override
public void onMessageReceived(RemoteMessage message) {
  Log.d(TAG, "A message has been received.");
  // Do additional logic...
  super.onMessageReceived(message);
}

ListenerService আরও কিছু পদ্ধতি আছে যেগুলো কম ব্যবহৃত হয়। এগুলোও ওভাররাইড করা যেতে পারে, আরও তথ্যের জন্য FirebaseMessagingService রেফারেন্স দেখুন।

@Override
public void onDeletedMessages() {
  Log.d(TAG, "Messages have been deleted on the server.");
  // Do additional logic...
  super.onDeletedMessages();
}

@Override
public void onMessageSent(String messageId) {
  Log.d(TAG, "An outgoing message has been sent.");
  // Do additional logic...
  super.onMessageSent(messageId);
}

@Override
public void onSendError(String messageId, Exception exception) {
  Log.d(TAG, "An outgoing message encountered an error.");
  // Do additional logic...
  super.onSendError(messageId, exception);
}

AndroidManifest.xml আপডেট করুন

আপনার কাস্টম ক্লাসগুলি লেখা হয়ে গেলে, কার্যকর হওয়ার জন্য সেগুলিকে AndroidManifest.xml এ অন্তর্ভুক্ত করতে হবে। <manifest> ট্যাগের ভিতরে উপযুক্ত বৈশিষ্ট্য ঘোষণা করে নিশ্চিত করুন যে ম্যানিফেস্টে মার্জ টুলগুলি অন্তর্ভুক্ত রয়েছে, যেমন:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.google.firebase.messaging.cpp.samples"
    xmlns:tools="http://schemas.android.com/tools">

firebase_messaging_cpp.aar আর্কাইভে একটি AndroidManifest.xml ফাইল আছে যা FCM এর ডিফল্ট ListenerService ঘোষণা করে। এই ম্যানিফেস্টটি সাধারণত প্রকল্প নির্দিষ্ট ম্যানিফেস্টের সাথে একত্রিত হয় যার ফলে ListenerService চালানো সম্ভব হয়। এই ListenerService কাস্টম লিসেনার পরিষেবা দিয়ে প্রতিস্থাপন করতে হবে। এটি ডিফল্ট ListenerService অপসারণ করে এবং কাস্টম পরিষেবা যোগ করে সম্পন্ন করা হয়, যা আপনার প্রকল্পের AndroidManifest.xml ফাইলের নিম্নলিখিত লাইন দিয়ে করা যেতে পারে:

<service android:name="com.google.firebase.messaging.cpp.ListenerService"
         tools:node="remove" />

<service android:name="com.google.firebase.messaging.cpp.samples.MyListenerService"
         android:exported="false">
  <intent-filter>
    <action android:name="com.google.firebase.MESSAGING_EVENT"/>
  </intent-filter>
</service>

Firebase C++ SDK (7.1.0 এর পর থেকে) এর নতুন সংস্করণগুলি JobIntentService ব্যবহার করে যার জন্য AndroidManifest.xml ফাইলে অতিরিক্ত পরিবর্তন প্রয়োজন।

<service android:name="com.google.firebase.messaging.MessageForwardingService"
     android:permission="android.permission.BIND_JOB_SERVICE"
     android:exported="false" >
</service>

স্বয়ংক্রিয় আরম্ভ রোধ করুন

FCM অ্যাপ ইনস্ট্যান্স টার্গেটিং এর জন্য একটি রেজিস্ট্রেশন টোকেন তৈরি করে। যখন একটি টোকেন তৈরি করা হয়, তখন লাইব্রেরি Firebase-এ শনাক্তকারী এবং কনফিগারেশন ডেটা আপলোড করে। টোকেন ব্যবহার করার আগে যদি আপনি একটি স্পষ্ট অপ্ট-ইন পেতে চান, তাহলে আপনি FCM (এবং Android, Analytics-এ) অক্ষম করে কনফিগারেশনের সময় জেনারেশন প্রতিরোধ করতে পারেন। এটি করার জন্য, Apple প্ল্যাটফর্মে আপনার Info.plist (আপনার GoogleService-Info.plist নয়) অথবা Android-এ আপনার AndroidManifest.xml এ একটি মেটাডেটা মান যোগ করুন:

<?xml version="1.0" encoding="utf-8"?>
<application>
  <meta-data android:name="firebase_messaging_auto_init_enabled"
             android:value="false" />
  <meta-data android:name="firebase_analytics_collection_enabled"
             android:value="false" />
</application>

FirebaseMessagingAutoInitEnabled = NO

FCM পুনরায় সক্ষম করতে, আপনি একটি রানটাইম কল করতে পারেন:

::firebase::messaging::SetTokenRegistrationOnInitEnabled(true);

একবার সেট করা হলে অ্যাপ রিস্টার্ট জুড়ে এই মানটি বজায় থাকে।

অ্যান্ড্রয়েডে ডিপ লিঙ্ক সহ মেসেজ

FCM আপনার অ্যাপে একটি ডিপ লিঙ্ক সম্বলিত বার্তা পাঠানোর অনুমতি দেয়। ডিপ লিঙ্ক সম্বলিত বার্তা গ্রহণ করতে, আপনার অ্যাপের ডিপ লিঙ্ক পরিচালনা করে এমন কার্যকলাপে একটি নতুন ইন্টেন্ট ফিল্টার যোগ করতে হবে। ইন্টেন্ট ফিল্টারটি আপনার ডোমেনের ডিপ লিঙ্কগুলি ধরবে। যদি আপনার বার্তাগুলিতে ডিপ লিঙ্ক না থাকে, তাহলে এই কনফিগারেশনটি প্রয়োজনীয় নয়। AndroidManifest.xml-এ:

<intent-filter>
  <action android:name="android.intent.action.VIEW"/>
  <category android:name="android.intent.category.DEFAULT"/>
  <category android:name="android.intent.category.BROWSABLE"/>
  <data android:host="CHANGE_THIS_DOMAIN.example.com" android:scheme="http"/>
  <data android:host="CHANGE_THIS_DOMAIN.example.com" android:scheme="https"/>
</intent-filter>

ইন্টেন্ট ফিল্টারকে আরও নমনীয় করার জন্য একটি ওয়াইল্ডকার্ড নির্দিষ্ট করাও সম্ভব। উদাহরণস্বরূপ:

<intent-filter>
  <action android:name="android.intent.action.VIEW"/>
  <category android:name="android.intent.category.DEFAULT"/>
  <category android:name="android.intent.category.BROWSABLE"/>
  <data android:host="*.example.com" android:scheme="http"/>
  <data android:host="*.example.com" android:scheme="https"/>
</intent-filter>

যখন ব্যবহারকারীরা আপনার নির্দিষ্ট স্কিম এবং হোস্টের লিঙ্ক সম্বলিত একটি বিজ্ঞপ্তিতে ট্যাপ করবেন, তখন আপনার অ্যাপটি লিঙ্কটি পরিচালনা করার জন্য এই ইন্টেন্ট ফিল্টার দিয়ে কার্যকলাপ শুরু করবে।

পরবর্তী পদক্ষেপ

সেটআপ ধাপগুলি সম্পন্ন করার পরে, C++ এর জন্য FCM ব্যবহার করার জন্য এখানে কয়েকটি বিকল্প রয়েছে:

• ডিভাইসগুলিতে বার্তা পাঠান
• একটি C++ অ্যাপে বার্তা গ্রহণ করুন
• বিষয়গুলিতে বার্তা পাঠান