Android uygulamalarında ileti alma

Mesaj almak için FirebaseMessagingService'i genişleten bir hizmet kullanabilirsiniz. Hizmetiniz onMessageReceived ve onDeletedMessages geri çağırmalarını geçersiz kılmalıdır. Tam bir örnek için Firebase Cloud Messaging hızlı başlangıç örneğine bakın.

onMessageReceived, aşağıdaki istisnalar dışında çoğu mesaj türü için sağlanır:

• Uygulamanız arka plandayken teslim edilen bildirim mesajları. Bu durumda bildirim, cihazın sistem tepsisine gönderilir. Kullanıcı bir bildirime dokunduğunda varsayılan olarak uygulama başlatıcı açılır.

• Arka planda alındığında hem bildirim hem de veri yükü içeren mesajlar. Bu durumda bildirim, cihazın sistem tepsisine, veri yükü ise başlatıcı etkinliğinizin intent'inin ekstralarına gönderilir.

Özet olarak:

Mesaj türleri hakkında daha fazla bilgi için Bildirimler ve veri mesajları başlıklı makaleyi inceleyin.

onMessageReceived geri çağırma işlevinin kısa bir yürütme süresi vardır. İşletim sistemi gecikmeleri, uygulamanın başlatılma süresi, ana iş parçacığının diğer işlemler tarafından engellenmesi veya önceki onMessageReceived çağrılarının çok uzun sürmesi gibi birçok faktör bu sürenin uzunluğunu etkileyebilir.

Bu nedenle, onMessageReceived içinde uzun süren görevlerden (ör. bildirimde göstermek için sunucudan resim getirme) kaçınmalı ve bunun yerine, tamamlanması birkaç saniyeden uzun sürebilecek görevleri işlemek için WorkManager kullanarak bir görev planlamalısınız. Mesaj önceliği ve bunun işlemeyi nasıl etkilediği hakkında daha fazla bilgi için Yüksek ve normal öncelikli mesajlar için mesaj işleme başlıklı makaleyi inceleyin.

Uygulama manifestini düzenleme

FirebaseMessagingService özelliğini kullanmak için uygulama manifestinize aşağıdakileri eklemeniz gerekir:

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

Bildirimlerin görünümünü özelleştirmek için varsayılan değerleri ayarlamanız önerilir. Bildirim yükünde eşdeğer değerler ayarlanmadığında uygulanacak özel bir varsayılan simge ve özel bir varsayılan renk belirtebilirsiniz.

Özel varsayılan simgeyi ve özel rengi ayarlamak için application etiketinin içine şu satırları ekleyin:

<!-- 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, özel varsayılan simgeyi görüntüler ve kullanır.

• Firebase konsolundaki Bildirim oluşturucu'dan gönderilen tüm bildirim iletileri.

• Bildirim yükünde simgeyi açıkça ayarlamayan tüm bildirim mesajları.

Özel bir varsayılan simge ayarlanmamışsa ve bildirim yükünde bir simge ayarlanmamışsa Android, uygulama simgesini beyaz renkte gösterir.

Geçersiz kılma onMessageReceived

FirebaseMessagingService.onMessageReceived yöntemini geçersiz kılarak, alınan RemoteMessage nesnesine göre işlem yapabilir ve mesaj verilerini alabilirsiniz:

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

@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

Geçersiz kılma onDeletedMessages

Bazı durumlarda FCM mesaj göndermeyebilir. Bu durum, cihazın bağlandığı sırada uygulamanız için belirli bir cihazda bekleyen çok fazla mesaj (>100) varsa veya cihaz bir aydan uzun süredir FCM hizmetine bağlanmadıysa ortaya çıkar. Bu durumlarda FirebaseMessagingService.onDeletedMessages() numarasına geri arama alabilirsiniz. Uygulama örneği bu geri çağırmayı aldığında uygulama sunucunuzla tam senkronizasyon gerçekleştirmelidir. Son 4 hafta içinde o cihazdaki uygulamaya mesaj göndermediyseniz FCM, onDeletedMessages() adlı kişiyi aramaz.

Arka plandaki bir uygulamada bildirim mesajlarını işleme

Uygulamanız arka plandayken Android, bildirim mesajlarını sistem tepsisine yönlendirir. Kullanıcı bildirime dokunduğunda varsayılan olarak uygulama başlatıcı açılır.

Hem bildirim hem de veri yükü içeren mesajlar (ve Firebase konsolundaki Bildirim Oluşturucu'dan gönderilen tüm mesajlar) buna dahildir. Bu durumlarda bildirim, cihazın sistem tepsisine teslim edilir ve veri yükü, başlatıcı etkinliğinizin intent eklerinde teslim edilir.

Uygulamanıza mesaj teslimiyle ilgili bilgi edinmek için Firebase konsolunda DevOps & Engagement (DevOps ve Etkileşim) > Messaging (Mesajlaşma) > Reports (Raporlar) kontrol paneline gidin. Bu kontrol panelinde, Apple ve Android cihazlarda gönderilen ve açılan mesajların sayısı ile Android uygulamaları için "gösterim" (kullanıcılar tarafından görülen bildirimler) verileri kaydedilir.