Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Beim FCM-Themenmessaging können Sie basierend auf dem Publish/Subscribe-Modell eine Nachricht an mehrere Geräte senden, die sich für ein bestimmtes Thema angemeldet haben. Sie verfassen Themennachrichten nach Bedarf und FCM kümmert sich um das Routing und die zuverlässige Zustellung der Nachricht an die richtigen Geräte.
Nutzer einer lokalen App zur Vorhersage von Gezeiten könnten sich beispielsweise für das Thema „Benachrichtigungen zu Gezeitenströmungen“ anmelden und Benachrichtigungen über optimale Bedingungen für das Salzwasserfischen in bestimmten Gebieten erhalten. Nutzer einer Sport-App könnten automatische Updates zu Live-Spielständen ihrer Lieblingsteams abonnieren.
Wichtige Hinweise zu Themen:
Themenbezogene Nachrichten eignen sich am besten für Inhalte wie Wetter oder andere öffentlich verfügbare Informationen.
Themennachrichten sind für den Durchsatz optimiert, nicht für die Latenz. Für die schnelle und sichere Zustellung an einzelne Geräte oder kleine Gruppen von Geräten sollten Sie Nachrichten auf Registrierungstokens ausrichten und nicht auf Themen.
Wenn Sie Nachrichten an mehrere Geräte pro Nutzer senden müssen, sollten Sie für diese Anwendungsfälle Nachrichten an Gerätegruppen in Betracht ziehen.
Bei Themennachrichten werden unbegrenzte Abos für jedes Thema unterstützt. FCM erzwingt jedoch Limits in den folgenden Bereichen:
Eine App-Instanz kann maximal 2.000 Themen abonnieren.
Wenn Sie Batch-Import verwenden, um App-Instanzen zu abonnieren, ist jede Anfrage auf 1.000 App-Instanzen beschränkt.
Die Häufigkeit neuer Abos ist pro Projekt begrenzt. Wenn Sie innerhalb kurzer Zeit zu viele Aboanfragen senden, antworten die FCM-Server mit einer 429 RESOURCE_EXHAUSTED-Antwort („Kontingent überschritten“). Wiederholen Sie den Vorgang mit exponentiellem Backoff.
Client-App für ein Thema abonnieren
Client-Apps können jedes vorhandene Thema abonnieren oder ein neues Thema erstellen. Wenn eine Client-App einen neuen Themennamen abonniert, der noch nicht für Ihr Firebase-Projekt vorhanden ist, wird in FCM ein neues Thema mit diesem Namen erstellt und jeder Client kann es anschließend abonnieren.
Rufen Sie subscribeToTopic() mit dem Namen des Themas auf, um ein Thema zu abonnieren. Diese Methode gibt ein Future zurück, das aufgelöst wird, wenn das Abo erfolgreich war:
Wenn Sie das Abo beenden möchten, rufen Sie unsubscribeFromTopic() mit dem Namen des Themas auf.
subscribeToTopic() und unsubscribeFromTopic() werden für Webclients nicht unterstützt. Informationen zum Verwalten von Abos für Webnutzer finden Sie unter Nachrichten an Themen im Web/JavaScript senden.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-09-05 (UTC)."],[],[],null,["\u003cbr /\u003e\n\nBased on the publish/subscribe model, FCM topic messaging allows you to send a message\nto multiple devices that have opted in to a particular topic. You compose topic messages as\nneeded, and FCM handles routing and delivering the message reliably to the right\ndevices.\n\nFor example, users of a local tide\nforecasting app could opt in to a \"tidal currents alerts\" topic and receive\nnotifications of optimal saltwater fishing conditions in specified areas. Users of a sports app\ncould subscribe to automatic updates in live game scores for their favorite\nteams.\n\nSome things to keep in mind about topics:\n\n- Topic messaging is best suited for content such as weather, or other publicly\n available information.\n\n- Topic messages are **optimized for throughput rather than latency** . For fast,\n secure delivery to single devices or small groups of devices,\n [target messages to registration tokens](/docs/cloud-messaging/send-message#send_messages_to_specific_devices),\n not topics.\n\n- If you need to send messages to multiple devices *per user* , consider\n [device group messaging](/docs/cloud-messaging/send-message#send_messages_to_device_groups)\n for those use cases.\n\n- Topic messaging supports unlimited subscriptions for each topic. However, FCM\n enforces limits in these areas:\n\n - One app instance can be subscribed to no more than 2000 topics.\n - If you are using [batch import](https://developers.google.com/instance-id/reference/server#manage_relationship_maps_for_multiple_app_instances) to subscribe app instances, each request is limited to 1000 app instances.\n - The frequency of new subscriptions is rate-limited per project. If you send too many subscription requests in a short period of time, FCM servers will respond with a `429 RESOURCE_EXHAUSTED` (\"quota exceeded\") response. Retry with exponential backoff.\n\nSubscribe the client app to a topic\n\nClient apps can subscribe to any existing topic, or they can create a new\ntopic. When a client app subscribes to a new topic name (one that does\nnot already exist for your Firebase project), a new topic of that name is\ncreated in FCM and any client can subsequently subscribe to it.\n\nTo subscribe to a topic, call `subscribeToTopic()` with the topic name. This method\nreturns a `Future`, which resolves when the subscription succeeded: \n\n await FirebaseMessaging.instance.subscribeToTopic(\"topic\");\n\nTo unsubscribe, call `unsubscribeFromTopic()` with the topic name.\n\n`subscribeToTopic()` and `unsubscribeFromTopic()` are not supported for web\nclients. To learn how to manage subscriptions for web users, see\n[Send messages to topics on Web/JavaScript](https://firebase.google.com/docs/cloud-messaging/js/topic-messaging).\n\nNext steps\n\n- Learn how to [send topic messages](/docs/cloud-messaging/send-message#send-messages-to-topics).\n- Learn how to [Manage topic subscriptions on the server](/docs/cloud-messaging/manage-topics)."]]
