Receive messages reliably
Stay organized with collections
Save and categorize content based on your preferences.
Receiving messages reliably is the most critical feature of any Android
messaging experience. It's also important to implement messaging with an eye on
system health and battery life. This document guides you through the key
strategies and tools to ensure your Android app receives messages consistently,
efficiently, and reliably.
Message delivery mechanisms
The best approach for reliable messaging depends on your app's specific
requirements. Consider factors like:
- Current real-time needs
- Message frequency
- Battery constraints
Foreground real-time messaging
When your app is in the foreground, the user typically expects a reasonably high
volume of information, and wants to know things like:
- Is the person being messaged present on their device?
- Are they typing?
- Have they read the message?
The typical way to support this sort of real-time data exchange is to use a
client-server protocol, such as WebSockets. WebSockets enable
persistent, full-duplex communication between your app and a server. The OKHTTP
library includes an implementation of the WebSocket
protocol that you can use in your Android client.
The Firebase Realtime Database provides a prebuilt backend and
client frontend that can handle this sort of communication on your behalf. It
uses WebSockets internally for real-time communication between its client and
server.
Background real-time messaging
When your app is no longer in the foreground, it's critical to avoid doing
things that adversely impact system health and battery life. Since it's still
important to deliver message notifications reliably, we recommend making use of
Firebase Cloud Messaging (FCM).
FCM is a cross-platform messaging solution that efficiently sends notifications
and data messages to Android (and other) devices. It leverages the Android
Transport Layer (ATL) for devices that have Google services, so that your app
can be notified of changes when it is no longer running. The timeliness of
message delivery depends on the state of the device, the priority of the
message, and whether your app is subject to restrictions because of doze or
app standby.
Enhance message delivery reliability
To make your message delivery even more robust, consider these strategies:
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2024-05-14 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-05-14 UTC."],[],[],null,["# Receive messages reliably\n\nReceiving messages reliably is the most critical feature of any Android\nmessaging experience. It's also important to implement messaging with an eye on\nsystem health and battery life. This document guides you through the key\nstrategies and tools to ensure your Android app receives messages consistently,\nefficiently, and reliably.\n\nMessage delivery mechanisms\n---------------------------\n\nThe best approach for reliable messaging depends on your app's specific\nrequirements. Consider factors like:\n\n- Current real-time needs\n- Message frequency\n- Battery constraints\n\n### Foreground real-time messaging\n\nWhen your app is in the foreground, the user typically expects a reasonably high\nvolume of information, and wants to know things like:\n\n- Is the person being messaged present on their device?\n- Are they typing?\n- Have they read the message?\n\nThe typical way to support this sort of real-time data exchange is to use a\nclient-server protocol, such as [WebSockets](https://en.wikipedia.org/wiki/WebSocket). WebSockets enable\npersistent, full-duplex communication between your app and a server. The [OKHTTP\nlibrary](https://square.github.io/okhttp/) includes an [implementation of the WebSocket\nprotocol](https://square.github.io/okhttp/3.x/okhttp/okhttp3/WebSocket.html) that you can use in your Android client.\n\nThe [Firebase Realtime Database](https://firebase.google.com/docs/database) provides a prebuilt backend and\nclient frontend that can handle this sort of communication on your behalf. It\nuses WebSockets internally for real-time communication between its client and\nserver.\n\n### Background real-time messaging\n\nWhen your app is no longer in the foreground, it's critical to avoid doing\nthings that adversely impact system health and battery life. Since it's still\nimportant to deliver message notifications reliably, we recommend making use of\n[Firebase Cloud Messaging (FCM)](https://firebase.google.com/products/cloud-messaging).\n\nFCM is a cross-platform messaging solution that efficiently sends notifications\nand data messages to Android (and other) devices. It leverages the Android\nTransport Layer (ATL) for devices that have Google services, so that your app\ncan be notified of changes when it is no longer running. The timeliness of\nmessage delivery depends on the state of the device, the priority of the\nmessage, and whether your app is subject to restrictions because of [doze](/training/monitoring-device-state/doze-standby#understand_doze) or\n[app standby](/training/monitoring-device-state/doze-standby#understand_app_standby).\n\n- [Learn how to integrate FCM into your Android project](https://firebase.google.com/docs/android/setup)\n- [Explore the FCM (server) API and its capabilities](https://firebase.google.com/docs/reference/fcm/rest/v1/projects.messages)\n\nEnhance message delivery reliability\n------------------------------------\n\nTo make your message delivery even more robust, consider these strategies:\n\n- Use [`WorkManager`](/develop/background-work/background-tasks/persistent/getting-started) to [periodically wake up your app](/develop/background-work/background-tasks/persistent/getting-started/define-work#schedule_periodic_work) to check for new messages when the device has [network connectivity](/develop/background-work/background-tasks/persistent/getting-started/define-work#work-constraints), and (ideally) when the device is connected to a charger.\n- Get [insight into FCM delivery](https://firebase.google.com/docs/cloud-messaging/understand-delivery?platform=android) with tools such as the [Firebase console](https://firebase.google.com/console) and [Android SDK delivery\n metrics](https://firebase.google.com/docs/reference/fcmdata/rest/v1beta1/projects.androidApps.deliveryData) from the [FCM Data API](https://firebase.google.com/docs/reference/fcmdata/rest).\n- Use logging mechanisms and tools like [Firebase Crashlytics](https://firebase.google.com/docs/crashlytics) to monitor and troubleshoot message delivery issues."]]
