Passer au contenu principal
Cette page fait partie de Application d’exemple : une intégration OneSignal complète, qui suit une application réelle de bout en bout. L’application s’appelle Clean Beans, un planning de ménage pour les logements partagés, construite avec Expo (React Native) et un backend Supabase. Une Live Activity est une petite vue mise à jour en direct sur l’écran de verrouillage iOS et dans la Dynamic Island. Clean Beans en utilise deux : un compte à rebours jusqu’au créneau de ménage de l’utilisateur et une alerte lorsqu’une série est sur le point de s’arrêter.
Une Live Activity de rappel de ménage sur l'écran de verrouillage iOS

Le rappel de ménage en compte à rebours sur l'écran de verrouillage.

Les Live Activities sont normalement démarrées par l’application. Clean Beans les démarre depuis le backend, car elles doivent apparaître à une heure précise, que l’application soit ouverte ou non. Le push-to-start de OneSignal le rend possible.

Configurer l’application \

Une application multiplateforme peut laisser OneSignal gérer le cycle de vie de la Live Activity. Un seul appel au démarrage suffit côté JavaScript.
app/_layout.tsx
Le seul code natif à écrire est la mise en page du widget, en SwiftUI. Clean Beans ajoute l’extension de widget au projet iOS avec un petit plugin de configuration Expo, de sorte que le projet peut toujours être régénéré de zéro à chaque compilation.
plugins/withLiveActivityWidget.js

Dessiner le widget \

Le widget utilise DefaultLiveActivityAttributes de OneSignal, qui transporte des données libres. Un seul widget sert les deux activités : il lit une valeur type et choisit une mise en page.
plugins/widget/CleanBeansWidgetLiveActivity.swift
Chaque mise en page lit ses valeurs dans les données envoyées par le backend. Les attributes sont fixés au démarrage de l’activité. Le state peut changer à chaque mise à jour.
plugins/widget/CleanBeansWidgetLiveActivity.swift
Un compte à rebours est dessiné avec le style minuteur de SwiftUI, qui avance sur l’appareil sans autre mise à jour du serveur.

Alerte de série : démarrer une activité depuis le backend \

À 19 h, heure locale, toute personne ayant une série en cours et n’ayant pas fait de ménage dans la journée reçoit un compte à rebours jusqu’à minuit. La fonction horaire trouve ces personnes avec la même correspondance de fuseau horaire que les rappels push, puis démarre une activité pour chacune.
supabase/functions/streak-warning/index.ts
Une Live Activity d'alerte de série en compte à rebours jusqu'à minuit

L'alerte de série en compte à rebours jusqu'à minuit.

Rappel de ménage : démarrer, mettre à jour, terminer \

Le rappel de ménage passe par trois phases. Chacune fait l’objet d’une requête distincte pour la même activité. La fonction détermine dans quelle phase chaque utilisateur doit se trouver.
supabase/functions/cleaning-activity/index.ts
Elle enregistre la phase actuelle dans le profil de l’utilisateur et n’envoie une requête que lorsque la phase souhaitée est différente. La tâche horaire peut ainsi être exécutée plusieurs fois sans risque. La mise à jour et la fin utilisent un endpoint différent de celui du démarrage. L’activité est indiquée dans l’URL, ces requêtes ne contiennent donc aucun ciblage.
supabase/functions/cleaning-activity/index.ts
Ces requêtes utilisent priority: 10, car chacune correspond à un changement de phase qui doit apparaître immédiatement, et une personne en reçoit au plus quelques-unes par jour. La priorité 10 est décomptée du budget qu’Apple accorde à chaque appareil pour les mises à jour de Live Activity. Pour tout ce qui se met à jour souvent, comme un score ou une barre de progression, commencez par 5.
Envoyez les mises à jour et les fins à /apps/{app_id}/live_activities/{activity_id}/notifications, et non à l’endpoint de démarrage. Clean Beans envoyait au départ les trois à l’endpoint de démarrage, et chaque mise à jour et chaque fin étaient rejetées avec « Missing required parameter - event_attributes ».
Attribuez à chaque activité son propre activity_id et enregistrez-le au démarrage de l’activité. OneSignal n’accepte plus de mises à jour pour un activity_id une fois l’activité terminée, un ID fixe par utilisateur cesserait donc de fonctionner après le premier jour.

Configuration multiplateforme

setupDefault et l’extension de widget.

Démarrer une Live Activity

L’API push-to-start.

Mettre à jour une Live Activity

Requêtes de mise à jour et de fin.