> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# App de ejemplo: Live Activities

> Cómo la app de ejemplo Clean Beans inicia, actualiza y finaliza Live Activities de iOS desde su backend, con el código del widget y las solicitudes a la API.

Esta página forma parte de [App de ejemplo: una integración completa de OneSignal](https://documentation.onesignal.com/docs/es/example-full-integration-overview.md), 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](https://mintcdn.com/onesignal/XdN288-p34EfpfHk/images/tutorials/cleanbeans-LiveActivity-countdown.png?fit=max\&auto=format\&n=XdN288-p34EfpfHk\&q=85\&s=d3e51363076f6271d5f47cfec850e5e2)

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.

```typescript app/_layout.tsx theme={null}
// Enable Live Activities with the default attributes type
OneSignal.LiveActivities.setupDefault({
  enablePushToStart: true,
  enablePushToUpdate: true,
});
```

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.

```javascript plugins/withLiveActivityWidget.js theme={null}
const WIDGET_TARGET_NAME = "CleanBeansWidgetExtension";
const WIDGET_BUNDLE_ID_SUFFIX = ".CleanBeansWidgetExtension";
const DEPLOYMENT_TARGET = "16.2";
```

## 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.

```swift plugins/widget/CleanBeansWidgetLiveActivity.swift theme={null}
struct CleanBeansWidgetLiveActivity: Widget {
    var body: some WidgetConfiguration {
        ActivityConfiguration(for: DefaultLiveActivityAttributes.self) { context in
            // Dispatch based on activity type
            let activityType = context.attributes.data["type"]?.asString() ?? "streak-warning"

            if activityType == "cleaning-reminder" {
                CleaningReminderLockScreen(context: context)
            } else {
                StreakWarningLockScreen(context: context)
            }

        } dynamicIsland: { context in
            let activityType = context.attributes.data["type"]?.asString() ?? "streak-warning"

            if activityType == "cleaning-reminder" {
                return cleaningReminderDynamicIsland(context: context)
            } else {
                return streakWarningDynamicIsland(context: context)
            }
        }
    }
}
```

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.

```swift plugins/widget/CleanBeansWidgetLiveActivity.swift theme={null}
let title = context.attributes.data["title"]?.asString() ?? "Streak Warning"
let message = context.state.data["message"]?.asDict()?["en"]?.asString()
    ?? "Your streak is at risk!"
let streakCount = context.state.data["streakCount"]?.asInt() ?? 0
let midnightTs = context.state.data["midnightTs"]?.asInt() ?? 0
let midnightDate = Date(timeIntervalSince1970: Double(midnightTs))
```

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.

```typescript supabase/functions/streak-warning/index.ts theme={null}
const payload = {
  event: 'start',
  activity_id: activityId,
  include_aliases: {
    external_id: [user.id],
  },
  target_channel: 'push',
  event_attributes: {
    data: {
      title: 'Streak Warning',
    },
  },
  event_updates: {
    data: {
      message: {
        en: `Your ${user.streakCount}-day streak ends at midnight!`,
      },
      streakCount: user.streakCount,
      midnightTs: user.midnightTs,
      userName: user.name,
    },
  },
  name: 'Streak Warning',
  contents: {
    en: `Your ${user.streakCount}-day streak ends at midnight!`,
  },
  headings: {
    en: 'Streak at risk!',
  },
  priority: 10,
};

const res = await fetch(
  `https://api.onesignal.com/apps/${ONESIGNAL_APP_ID}/activities/activity/DefaultLiveActivityAttributes`,
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      Authorization: `Key ${ONESIGNAL_REST_API_KEY}`,
    },
    body: JSON.stringify(payload),
  }
);
```

![Una Live Activity de aviso de racha en cuenta atrás hasta la medianoche](https://mintcdn.com/onesignal/XdN288-p34EfpfHk/images/tutorials/cleanbeans-LA-warning.png?fit=max\&auto=format\&n=XdN288-p34EfpfHk\&q=85\&s=586ca54b6a57f7d1647d5e9bb5aa874f)

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.

| Fase | Cuándo | Solicitud | Lo que muestra el widget |
| - | - | - | - |
| Cuenta atrás | Una hora antes de la franja | `start` | Un temporizador en cuenta atrás hasta la hora de inicio |
| Activa | Se abre la franja | `update` | "It's your scheduled cleaning time, jump to it!" |
| Finalizada | Se cierra la franja | `end` | Se descarta a los cinco segundos |

La función calcula en qué fase debería estar cada usuario.

```typescript supabase/functions/cleaning-activity/index.ts theme={null}
function getDesiredPhase(
  currentHour: number,
  window: CleaningWindow,
): 'countdown' | 'active' | null {
  const reminderHour = (window.start - 1 + 24) % 24;

  // Active: inside the cleaning window
  if (isHourInRange(currentHour, window.start, window.end)) return 'active';

  // Countdown: the single hour before the window starts
  if (currentHour === reminderHour) return 'countdown';

  return null;
}
```

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.

```typescript supabase/functions/cleaning-activity/index.ts theme={null}
async function updateCleaningActivity(activityId: string): Promise<boolean> {
  const payload = {
    event: 'update',
    event_updates: {
      data: {
        message: { en: "It's your scheduled cleaning time, jump to it!" },
        phase: 'active',
        targetTs: 0,
      },
    },
    name: 'Cleaning Active',
    contents: { en: "It's your scheduled cleaning time!" },
    priority: 10,
  };

  // ...
}

async function endCleaningActivity(activityId: string): Promise<boolean> {
  const payload = {
    event: 'end',
    event_updates: {
      data: {
        message: { en: 'Cleaning window ended' },
        phase: 'ended',
      },
    },
    name: 'Cleaning Ended',
    dismissal_date: Math.floor(Date.now() / 1000) + 5, // dismiss after 5s
    priority: 10,
  };

  // ...
}
```

> [!NOTE]
>
> 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`.

> [!WARNING]
>
> 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".

> [!NOTE]
>
> 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.

> [card] [Configuración multiplataforma](https://documentation.onesignal.com/docs/es/cross-platform-live-activity-setup.md)
>
> `setupDefault` y la extensión del widget.

> [card] [Iniciar Live Activity](https://documentation.onesignal.com/reference/start-live-activity.md)
>
> La API de push-to-start.

> [card] [Actualizar Live Activity](https://documentation.onesignal.com/reference/update-live-activity-api.md)
>
> Solicitudes de actualización y finalización.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.