Firebase Cloud Messaging を使用してメッセージを受信する

このガイドでは、メッセージを確実に受信できるように、モバイルクライアントアプリとウェブクライアントアプリで Firebase Cloud Messaging を設定する方法について説明します。

メッセージを受信するには、FirebaseMessagingService を拡張したサービスを使用します。このサービスは onMessageReceived コールバックと onDeletedMessages コールバックをオーバーライドする必要があります。完全な例については、Firebase Cloud Messaging クイックスタートサンプルをご覧ください。

onMessageReceived は次の例外を除いて、ほとんどのメッセージタイプに提供されます。

アプリがバックグラウンドで動作しているときに配信された通知メッセージ。この場合、通知はデバイスのシステムトレイに配信されます。ユーザーが通知をタップすると、デフォルトでアプリランチャーが開きます。
バックグラウンドで受信されたときに通知とデータペイロードの両方を持つメッセージ。この場合、通知はデバイスのシステムトレイに配信され、データペイロードはランチャーアクティビティのインテントの追加部分に配信されます。

まとめると、次のとおりです。

アプリの状態	通知	データ	両方
フォアグラウンド	`onMessageReceived`	`onMessageReceived`	`onMessageReceived`
バックグラウンド	システムトレイ	`onMessageReceived`	通知: システムトレイデータ: インテントの追加部分内

メッセージタイプの詳細については、通知とデータメッセージをご覧ください。

onMessageReceived コールバックの実行ウィンドウは短いです。この時間枠の長さは、OS の遅延、アプリの起動時間、他のオペレーションによってブロックされているメインスレッド、または onMessageReceived の呼び出し時間がかかりすぎるなど、さまざまな要因によって影響を受ける可能性があります。

そのため、onMessageReceived で長時間実行されるタスク（通知に表示する画像をサーバーから取得するなど）は避け、代わりに WorkManager を使用してタスクをスケジュールし、完了に数秒以上かかる可能性のあるタスクを処理する必要があります。メッセージの優先度と処理への影響について詳しくは、高い優先度と標準の優先度のメッセージのメッセージ処理をご覧ください。

アプリマニフェストの編集

FirebaseMessagingService を使用するには、アプリマニフェストに次の設定を追加する必要があります。

<service
    android:name=".java.MyFirebaseMessagingService"
    android:exported="false">
    <intent-filter>
        <action android:name="com.google.firebase.MESSAGING_EVENT" />
    </intent-filter>
</service>AndroidManifest.xml

通知のデザインをカスタマイズするためのデフォルト値を設定することをおすすめします。通知ペイロード内にアイコンやカラーの値が設定されていない場合に適用される、カスタムデフォルトアイコンとカスタムデフォルトカラーを指定できます。

カスタムデフォルトアイコンとカスタムカラーを設定するには、次の行を application タグに追加します。

<!-- Set custom default icon. This is used when no icon is set for incoming notification messages.
     See README(https://goo.gl/l4GJaQ) for more. -->
<meta-data
    android:name="com.google.firebase.messaging.default_notification_icon"
    android:resource="@drawable/ic_stat_ic_notification" />
<!-- Set color used with incoming notification messages. This is used when no color is set for the incoming
     notification message. See README(https://goo.gl/6BKBk7) for more. -->
<meta-data
    android:name="com.google.firebase.messaging.default_notification_color"
    android:resource="@color/colorAccent" />AndroidManifest.xml

Android では、以下に対してカスタムデフォルトアイコンが表示され、使用されます。

Notifications Composer から送信されたすべての通知メッセージ。
通知ペイロード内にアイコンが明示的に設定されていない通知メッセージ。

カスタムデフォルトアイコンが設定されず、通知ペイロード内にもアイコンが設定されていない場合は、Android では白色でレンダリングされたアプリケーションアイコンが表示されます。

`onMessageReceived` のオーバーライド

FirebaseMessagingService.onMessageReceived メソッドをオーバーライドすると、受信した RemoteMessage オブジェクトに基づいて操作を行い、メッセージデータを取得できます。

Kotlin

override fun onMessageReceived(remoteMessage: RemoteMessage) {
    // TODO(developer): Handle FCM messages here.
    // Not getting messages here? See why this may be: https://goo.gl/39bRNJ
    Log.d(TAG, "From: ${remoteMessage.from}")

    // Check if message contains a data payload.
    if (remoteMessage.data.isNotEmpty()) {
        Log.d(TAG, "Message data payload: ${remoteMessage.data}")

        // Check if data needs to be processed by long running job
        if (needsToBeScheduled()) {
            // For long-running tasks (10 seconds or more) use WorkManager.
            scheduleJob()
        } else {
            // Handle message within 10 seconds
            handleNow()
        }
    }

    // Check if message contains a notification payload.
    remoteMessage.notification?.let {
        Log.d(TAG, "Message Notification Body: ${it.body}")
    }

    // Also if you intend on generating your own notifications as a result of a received FCM
    // message, here is where that should be initiated. See sendNotification method below.
}MyFirebaseMessagingService.kt

Java

@Override
public void onMessageReceived(RemoteMessage remoteMessage) {
    // TODO(developer): Handle FCM messages here.
    // Not getting messages here? See why this may be: https://goo.gl/39bRNJ
    Log.d(TAG, "From: " + remoteMessage.getFrom());

    // Check if message contains a data payload.
    if (remoteMessage.getData().size() > 0) {
        Log.d(TAG, "Message data payload: " + remoteMessage.getData());

        if (/* Check if data needs to be processed by long running job */ true) {
            // For long-running tasks (10 seconds or more) use WorkManager.
            scheduleJob();
        } else {
            // Handle message within 10 seconds
            handleNow();
        }

    }

    // Check if message contains a notification payload.
    if (remoteMessage.getNotification() != null) {
        Log.d(TAG, "Message Notification Body: " + remoteMessage.getNotification().getBody());
    }

    // Also if you intend on generating your own notifications as a result of a received FCM
    // message, here is where that should be initiated. See sendNotification method below.
}MyFirebaseMessagingService.java

`onDeletedMessages` のオーバーライド

状況によっては、FCM からメッセージが配信されないことがあります。これは、特定のデバイスが接続されたときにそのデバイスにまだ配信されていないアプリのメッセージが多すぎる（100 件を超えている）場合や、デバイスが 1 か月以上 FCM に接続されていない場合に発生します。このような場合、FirebaseMessagingService.onDeletedMessages() へのコールバックを受け取る可能性があります。アプリインスタンスがこのコールバックを受け取った場合は、アプリサーバーとの完全な同期を実行する必要があります。過去 4 週間以内にそのデバイスのアプリにメッセージを送信していない場合、FCM はonDeletedMessages()を呼び出しません。

バックグラウンドアプリの通知メッセージの処理

アプリがバックグラウンドで動作しているとき、Android ではシステムトレイに通知メッセージが送られます。ユーザーが通知をタップすると、デフォルトでアプリランチャーが開きます。

通知とデータペイロードの両方を含むメッセージ（および Notifications コンソールから送信されたすべてのメッセージ）がここに含まれます。この場合、通知はデバイスのシステムトレイに配信され、データペイロードはランチャーアクティビティのインテントの追加部分に配信されます。

アプリへのメッセージ配信については、FCM レポートダッシュボードをご覧ください。このダッシュボードには、Android アプリの「インプレッション」（ユーザーが表示した通知）のデータとともに、Apple と Android のデバイスで送信および開封されたメッセージの数が記録されています。

Firebase Cloud Messaging を使用してメッセージを受信する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

アプリ マニフェストの編集

onMessageReceived のオーバーライド