SwiftUI/Live Activity: BroadCast Push Notifications!
Zusammenfassung
Kurz
Der Artikel beschreibt, wie Live Activities über APNs-Kanäle per Broadcast-Push auf mehreren Geräten gestartet, aktualisiert und beendet werden. Der Autor empfiehlt unter anderem, die Kanalzugehörigkeit dauerhaft zu speichern und den aktuellen Zustand für später beitretende Geräte serverseitig bereitzuhalten; die Serverimplementierung selbst ist nicht Gegenstand des Berichts.
Mittel
Der Bericht zeigt, wie Live Activities mit APNs-Broadcast-Pushes auf vielen Geräten gleichzeitig aktualisiert oder beendet werden können. Der Autor erläutert das anhand einer Beispiel-App, richtet Kanäle in Apples Push Notification Console ein und testet die Pushes dort. Eine eigene Serverimplementierung ist ausdrücklich nicht enthalten.
Laut Autor bedeutet eine Activity auf einem Kanal zugleich, dass das Gerät dem Kanal beigetreten ist. Je Gerät sei nur eine nicht beendete Activity pro Kanal möglich. Da es keine eingebaute Abfrage dafür gebe, empfiehlt er, Kanal- und Activity-ID dauerhaft zu speichern. Er warnt, dass lokale Updates Broadcast-Updates verhindern können, und empfiehlt, Änderungen stattdessen über einen Server als Push auszulösen. Weil Geräte zu unterschiedlichen Zeiten beitreten, sollte der Server den aktuellen Activity-Zustand bereitstellen.
Für den Start kann die App `.channel(channelId)` verwenden oder ein Push mit `input-push-channel` senden. Kanal- und Push-Token dürfen laut Bericht nicht gleichzeitig im Start-Payload stehen. Für Broadcast-Updates und -Enden dient die Kanal-ID als Empfänger; die Beispiele verwenden die Ereignisse `update` und `end`. Beim Anlegen eines Kanals lässt sich festlegen, ob Nachrichten für offline Geräte gespeichert werden. Die technische Darstellung und Empfehlungen stammen vom Autor; unabhängige Prüfungen werden nicht berichtet.
Ausführlich lesen
Der Bericht erklärt, wie sich Apples Live Activities über APNs-Broadcast-Pushes an viele Geräte gleichzeitig aktualisieren oder beenden lassen. Der Autor beschreibt ein Beispiel rund um eine Live Activity für einen Heldenstatus. Die serverseitige Umsetzung ist ausdrücklich nicht Teil des Artikels; Kanäle werden in der Push Notification Console angelegt und Pushes dort getestet. Für die Grundlagen verweist der Autor auf einen vorherigen Beitrag und für die Serverentwicklung auf einen angekündigten Folgeartikel.
Im Zentrum steht das Konzept, dass eine Live Activity auf einem Kanal zugleich als dessen Beitritt und als Anmeldung für Aktualisierungen dient. Laut Autor gibt es keine separate Funktion zum Beitreten oder Abonnieren. Daraus folgert er: Pro Gerät kann höchstens eine nicht beendete Activity je Kanal laufen. Ein weiterer Start für denselben Kanal könne einen ActivityManagerError auslösen. Weil das System laut Bericht keinen eingebauten Weg bietet, zu prüfen, ob bereits eine Activity auf einem Kanal läuft, empfiehlt der Autor, Kanal- und Activity-ID dauerhaft miteinander zu verknüpfen, etwa in UserDefaults oder in den ActivityAttributes. Eine lokale Variable reiche nicht, da Activities auch enden können, während die App geschlossen ist.
Der Autor warnt außerdem, dass lokal in der App vorgenommene Updates an einer kanalgebundenen Activity spätere Broadcast-Updates verhindern können; Broadcast-Ende-Nachrichten funktionierten nach seiner Darstellung weiterhin. Als Ausweg empfiehlt er, direkte lokale Updates zu unterbinden oder Änderungen über einen Server auszulösen, der Push-Updates sendet. Da Geräte einem Kanal zu unterschiedlichen Zeitpunkten beitreten, sollte der Server nach seiner Empfehlung den aktuellen Zustand der laufenden Activity vorhalten und beim Beitritt an ein neues Gerät liefern.
Für die Einrichtung soll die Broadcast-Fähigkeit im Apple-Entwicklerportal beim App-Identifier aktiviert werden. Der Bericht betont, dass Broadcast-Pushes hier nur für Live Activities verfügbar seien. Beim Erstellen eines Kanals in der Push Notification Console kann man laut Text zwischen keiner Nachrichtenspeicherung und der Speicherung der jüngsten Nachricht wählen. Letztere hält Nachrichten höchstens acht Stunden; eine frühere Ablaufzeit lasse sich über den APNs-Header `apns-expiration` festlegen. Die Wahl ohne Speicherung biete ein höheres Veröffentlichungsbudget und eigne sich laut Autor eher für häufige Statusänderungen wie Sportstände.
Eine Activity kann laut Beispielcode direkt in der App mit `pushType: .channel(channelId)` gestartet werden. Alternativ lässt sie sich per Push starten: Der Payload erhält in `aps` den Schlüssel `input-push-channel` mit der Kanal-ID. Der Autor hebt hervor, dass `input-push-channel` und `input-push-token` nicht zugleich vorkommen dürfen; ein Push könne zwar als erfolgreich versandt erscheinen, ohne dass eine Activity gestartet werde. Für spätere Broadcast-Updates und -Enden wird die Kanal-ID als Empfänger verwendet. Die Beispiele zeigen Payloads mit `event: update` beziehungsweise `event: end`; für eine eigene Serverlösung nennt der Bericht außerdem einen Broadcast-Endpunkt und den Header `apns-channel-id`.
Die Aussagen beruhen auf der Darstellung und den Empfehlungen des Autors; der Artikel beschreibt weder eine serverseitige Implementierung noch unabhängige Tests oder allgemeine Einschränkungen über die genannten Punkte hinaus.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Lunas Zusammenfassungen (kurz, mittel und die unbeschriftete ausführliche Fassung) wurden gemeinsam bewertet, da das Schema nur eine Zusammenfassung vorsieht. Alle Angaben stimmen mit dem Bericht überein und es gibt keine erfundenen Fakten. Die kurze Fassung lässt mehrere zentrale Regeln aus, die die mittlere und die ausführliche Fassung enthalten. Die Abschnitte Sammelfrage und Teilfrage enthielten keine Fragen, daher gibt es keine Einordnung.
Im Bericht, aber nicht in der Zusammenfassung
- Je Gerät ist nur eine nicht beendete Activity pro Kanal möglich (fehlt in der kurzen Fassung)
- Lokale Updates verhindern den Empfang von Broadcast-Updates (fehlt in der kurzen Fassung)
- Message Storage Policy mit No Message Storage oder Most Recent Message Stored und 8 Stunden Speicherdauer (in der kurzen Fassung nur allgemein erwähnt)
- input-push-channel und input-push-token dürfen nicht gleichzeitig vorkommen (fehlt in der kurzen Fassung)
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.