C ++でFirebaseCloudMessagingクライアントアプリを設定する

クロスプラットフォームの Firebase Cloud Messaging クライアント アプリを C++ で作成するには、 Firebase Cloud Messaging API を使用します。 C++ SDK は、Android と Apple の両方のプラットフォームで動作しますが、プラットフォームごとに追加のセットアップが必要です。

Firebase と FCM SDK をセットアップする

デバイス登録トークンにアクセスする

Firebase Cloud Messaging ライブラリを初期化すると、クライアント アプリ インスタンスの登録トークンが要求されます。アプリは、 firebase firebase::messaging::Listenerを実装するクラスで定義する必要があるOnTokenReceivedコールバックでトークンを受け取ります。

その特定のデバイスをターゲットにする場合は、このトークンにアクセスする必要があります。

Android でのメッセージ配信に関する注意事項

アプリがまったく実行されていないときにユーザーが通知をタップすると、デフォルトでは、メッセージは 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は null になります。

要約すれば：

Android でのカスタム メッセージ処理

デフォルトでは、アプリに送信される通知は::firebase::messaging::Listener::OnMessageReceivedに渡されますが、場合によってはデフォルトの動作をオーバーライドしたい場合があります。 Android でこれを行うには、 com.google.firebase.messaging.cpp.ListenerServiceを拡張するカスタム クラスを記述し、プロジェクトのAndroidManifest.xmlを更新する必要があります。

ListenerServiceメソッドをオーバーライドします。

ListenerServiceは、アプリに送信された着信メッセージをインターセプトして C++ ライブラリにルーティングする Java クラスです。アプリがフォアグラウンドにある場合 (またはアプリがバックグラウンドにあり、データのみのペイロードを受信した場合)、メッセージはこのクラスで提供されるコールバックの 1 つを通過します。メッセージ処理にカスタム動作を追加するには、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アーカイブには、FCM のデフォルトのListenerServiceを宣言するAndroidManifest.xmlファイルがあります。このマニフェストは、通常、 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 以降) は、 AndroidManifest.xmlファイルに追加の変更を加える必要があるJobIntentServiceを使用します。

<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);

この値は、一度設定するとアプリを再起動しても保持されます。

Android でのディープ リンクを使用したメッセージの処理

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>

指定したスキームとホストへのリンクを含む通知をユーザーがタップすると、アプリはこのインテント フィルターを使用してアクティビティを開始し、リンクを処理します。

次のステップ

クライアント アプリを設定したら、Firebase を使用してダウンストリーム メッセージとトピック メッセージを送信する準備が整います。詳細については、ダウンロード、実行、および確認できるクイックスタート サンプルで示されているこの機能を参照してください。

アプリにその他のより高度な動作を追加するには、アプリ サーバーからメッセージを送信するためのガイドを参照してください。

• トピック メッセージを送信する
• デバイス グループに送信

これらの機能を利用するには、サーバーの実装が必要になることに注意してください。