Эта страница была переведа с помощью Cloud Translation API.
Switch to English

Получать сообщения в приложении для Android

Уведомления Firebase ведут себя по-разному в зависимости от состояния переднего или заднего плана принимающего приложения. Если вы хотите, чтобы передовые приложения получали уведомления или сообщения с данными, вам необходимо написать код для обработки обратного вызова onMessageReceived . Для объяснения разницы между уведомлениями и сообщениями с данными см. Типы сообщений .

Обработка сообщений

Для получения сообщений используйте службу, расширяющую FirebaseMessagingService . Ваша служба должна переопределить onMessageReceived вызовы onMessageReceived и onDeletedMessages . Он должен обрабатывать любое сообщение в течение 20 секунд после получения (10 секунд на Android Marshmallow). onMessageReceived окно может быть короче в зависимости от задержек ОС перед вызовом onMessageReceived . По истечении этого времени различное поведение ОС, например, ограничения фонового выполнения Android O, могут помешать вашей способности завершить работу. Для получения дополнительной информации см. Наш обзор приоритета сообщений .

onMessageReceived предоставляется для большинства типов сообщений, за следующими исключениями:

  • Уведомления доставляются, когда ваше приложение работает в фоновом режиме . В этом случае уведомление доставляется на панель задач устройства. При нажатии пользователем на уведомление по умолчанию открывается панель запуска приложений.

  • Сообщения с уведомлением и полезными данными при получении в фоновом режиме . В этом случае уведомление доставляется в системный трей устройства, а полезные данные доставляются в дополнениях к намерению вашей активности запуска.

В итоге:

Состояние приложения Уведомление Данные Обе
Передний план onMessageReceived onMessageReceived onMessageReceived
Задний план Системный трей onMessageReceived Уведомление: системный трей
Данные: в статистике намерения.
Дополнительные сведения о типах сообщений см. В разделе Уведомления и сообщения с данными .

Отредактируйте манифест приложения

Чтобы использовать FirebaseMessagingService , вам необходимо добавить в манифест приложения следующее:

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

Также рекомендуется установить значения по умолчанию, чтобы настроить внешний вид уведомлений. Вы можете указать настраиваемый значок по умолчанию и настраиваемый цвет по умолчанию, которые применяются всякий раз, когда эквивалентные значения не установлены в полезных данных уведомления.

Добавьте эти строки в тег 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" />

Android отображает собственный значок по умолчанию для

  • Все сообщения с уведомлениями, отправленные композитором уведомлений .
  • Любое уведомление, в котором явно не установлен значок в полезных данных уведомления.

Android использует собственный цвет по умолчанию для

  • Все сообщения с уведомлениями, отправленные композитором уведомлений .
  • Любое уведомление, в котором явно не установлен цвет в полезных данных уведомления.

Если пользовательский значок по умолчанию не установлен и в полезных данных уведомления не задан значок, Android отображает значок приложения в белом цвете.

Переопределить onMessageReceived

Переопределив метод FirebaseMessagingService.onMessageReceived , вы можете выполнять действия на основе полученного объекта RemoteMessage и получать данные сообщения:

Ява

@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.
}

Котлин + KTX

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}")

        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.
    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.
}

Переопределить onDeletedMessages

В некоторых ситуациях FCM может не доставить сообщение. Это происходит, когда для вашего приложения на определенном устройстве на момент подключения слишком много сообщений (> 100), или если устройство не подключалось к FCM более одного месяца. В этих случаях вы можете получить обратный вызов FirebaseMessagingService.onDeletedMessages() Когда экземпляр приложения получает этот обратный вызов, он должен выполнить полную синхронизацию с вашим сервером приложений. Если вы не отправляли сообщение в приложение на этом устройстве в течение последних 4 недель, FCM не будет вызывать onDeletedMessages() .

Обработка уведомлений в фоновом приложении

Когда ваше приложение работает в фоновом режиме, Android направляет уведомления на панель задач. При нажатии на уведомление пользователем по умолчанию открывается панель запуска приложений.

Сюда входят сообщения, содержащие как уведомление, так и полезные данные (и все сообщения, отправленные с консоли уведомлений). В этих случаях уведомление доставляется на панель задач устройства, а полезные данные доставляются в дополнениях к намерению вашей активности запуска.

Чтобы получить представление о доставке сообщений в ваше приложение, см. Панель отчетности FCM , на которой записывается количество сообщений, отправленных и открытых на устройствах iOS и Android, а также данные о «показах» (уведомлениях, увиденных пользователями) для приложений Android.

Фоновые приложения с ограниченным доступом (Android P или новее)

FCM может не доставлять сообщения в приложения, которые были заблокированы пользователем в фоновом режиме (например, через: Настройки -> Приложения и уведомления -> [имя приложения] -> Батарея). Как только ваше приложение будет удалено из-под фонового ограничения, новые сообщения в приложение будут доставляться, как и раньше. Чтобы предотвратить потерю сообщений и другие последствия ограничения фона, избегайте плохого поведения, указанного в работе Android Vitals . Такое поведение может привести к тому, что устройство Android порекомендует пользователю ограничить ваше приложение в фоновом режиме. Ваше приложение может проверить, ограничено ли оно в фоновом режиме, используя: isBackgroundRestricted () .

Получать сообщения FCM в режиме прямой загрузки

Разработчики, которые хотят отправлять сообщения FCM приложениям еще до того, как устройство разблокировано, могут разрешить приложению Android получать сообщения, когда устройство находится в режиме прямой загрузки. Например, вы можете захотеть, чтобы пользователи вашего приложения получали уведомления о тревоге даже на заблокированном устройстве.

При построении этого варианта использования соблюдайте общие рекомендации и ограничения для режима прямой загрузки . Особенно важно учитывать видимость сообщений о прямой загрузке; любой пользователь, имеющий доступ к устройству, может просматривать эти сообщения без ввода учетных данных.

Предпосылки

  • Устройство должно быть настроено для режима прямой загрузки.
  • На устройстве должна быть установлена ​​последняя версия сервисов Google Play (19.0.54 или новее).
  • Для получения сообщений FCM приложение должно использовать FCM SDK ( com.google.firebase:firebase-messaging ).

Включите в приложении обработку сообщений в режиме прямой загрузки

  1. В файле Gradle уровня приложения добавьте зависимость от библиотеки поддержки прямой загрузки FCM:

    implementation 'com.google.firebase:firebase-messaging-directboot:20.2.0'
    
  2. Сделайте приложение FirebaseMessagingService осведомленным о прямой загрузке, добавив android:directBootAware="true" в манифест приложения:

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

Важно убедиться, что эта FirebaseMessagingService может работать в режиме прямой загрузки. Проверьте следующие требования:

  • Служба не должна обращаться к хранилищу, защищенному учетными данными, при работе в режиме прямой загрузки.
  • Служба не должна пытаться использовать компоненты, такие как Activities , BroadcastReceivers или другие Services , которые не помечены как поддерживающие прямую загрузку при работе в режиме прямой загрузки.
  • Любые библиотеки, которые использует служба, также не должны обращаться к хранилищу, защищенному учетными данными, или вызывать компоненты non-directBootAware во время работы в режиме прямой загрузки. Это означает, что любые библиотеки, которые использует приложение и которые вызываются из службы, либо должны поддерживать прямую загрузку, либо приложению необходимо будет проверять, работает ли оно в режиме прямой загрузки, а не вызывать их в этом режиме. Например, SDK Firebase работают с прямой загрузкой (их можно включить в приложение без сбоев в режиме прямой загрузки), но многие API Firebase не поддерживают вызов в режиме прямой загрузки.
  • Если приложение использует пользовательские Application , то Application также должно быть прямой загрузкой в курсе (нет доступа к верительному защищенному хранилищу в прямом режиме загрузки).

Инструкции по отправке сообщений на устройства в режиме прямой загрузки см. В разделе Отправка сообщений с включенной прямой загрузкой .