Saltar al contenido principal
Esta página forma parte de App de ejemplo: una integración completa de OneSignal, que sigue una app real de principio a fin. La app es Clean Beans, un turno de limpieza para hogares compartidos, creada con Expo (React Native) y un backend de Supabase. Una Live Activity es una pequeña vista que se actualiza en directo en la pantalla de bloqueo de iOS y en la Dynamic Island. Clean Beans usa dos: una cuenta atrás hasta la franja de limpieza del usuario y un aviso cuando una racha está a punto de terminar.
Una Live Activity de recordatorio de limpieza en la pantalla de bloqueo de iOS

El recordatorio de limpieza en cuenta atrás en la pantalla de bloqueo.

Normalmente, las Live Activities las inicia la app. Clean Beans las inicia desde el backend, porque tienen que aparecer a una hora determinada tanto si la app está abierta como si no. El push-to-start de OneSignal lo hace posible.

Configurar la app \

Una app multiplataforma puede dejar que OneSignal gestione el ciclo de vida de la Live Activity. Una sola llamada al inicio es todo el JavaScript necesario.
app/_layout.tsx
El único código nativo que escribes es el diseño del widget, en SwiftUI. Clean Beans añade la extensión del widget al proyecto de iOS con un pequeño plugin de configuración de Expo, de modo que el proyecto se puede seguir generando desde cero en cada compilación.
plugins/withLiveActivityWidget.js

Dibujar el widget \

El widget usa DefaultLiveActivityAttributes de OneSignal, que contiene datos de formato libre. Un solo widget sirve para ambas actividades: lee un valor type y elige un diseño.
plugins/widget/CleanBeansWidgetLiveActivity.swift
Cada diseño lee sus valores de los datos que envió el backend. Los attributes se fijan cuando empieza la actividad. El state puede cambiar con cada actualización.
plugins/widget/CleanBeansWidgetLiveActivity.swift
Una cuenta atrás se dibuja con el estilo de temporizador de SwiftUI, que avanza en el dispositivo sin más actualizaciones del servidor.

Aviso de racha: iniciar una actividad desde el backend \

A las 19:00 hora local, quien tenga una racha y no haya limpiado hoy recibe una cuenta atrás hasta la medianoche. La función horaria los encuentra con la misma coincidencia de zona horaria que los recordatorios push y luego inicia una actividad para cada uno.
supabase/functions/streak-warning/index.ts
Una Live Activity de aviso de racha en cuenta atrás hasta la medianoche

El aviso de racha en cuenta atrás hasta la medianoche.

Recordatorio de limpieza: iniciar, actualizar, finalizar \

El recordatorio de limpieza pasa por tres fases. Cada una es una solicitud independiente para la misma actividad. La función calcula en qué fase debería estar cada usuario.
supabase/functions/cleaning-activity/index.ts
Guarda la fase actual en el perfil del usuario y solo envía una solicitud cuando la fase deseada es diferente. Eso hace que el trabajo horario se pueda ejecutar repetidamente sin riesgo. Actualizar y finalizar usan un endpoint distinto del de inicio. La actividad se indica en la URL, así que estas solicitudes no llevan segmentación.
supabase/functions/cleaning-activity/index.ts
Estas solicitudes usan priority: 10 porque cada una es un cambio de fase que debe aparecer de inmediato, y una persona recibe como mucho unas pocas al día. La prioridad 10 cuenta para el presupuesto que Apple permite a cada dispositivo para las actualizaciones de Live Activity. Para cualquier cosa que se actualice a menudo, como un marcador o una barra de progreso, empieza con 5.
Envía las actualizaciones y finalizaciones a /apps/{app_id}/live_activities/{activity_id}/notifications, no al endpoint de inicio. Al principio, Clean Beans enviaba las tres al endpoint de inicio, y todas las actualizaciones y finalizaciones se rechazaban con “Missing required parameter - event_attributes”.
Da a cada actividad su propio activity_id y guárdalo cuando empiece la actividad. OneSignal no acepta más actualizaciones de un activity_id una vez finalizada esa actividad, así que un ID fijo por usuario dejaría de funcionar después del primer día.

Configuración multiplataforma

setupDefault y la extensión del widget.

Iniciar Live Activity

La API de push-to-start.

Actualizar Live Activity

Solicitudes de actualización y finalización.