Pular para o conteúdo principal
Esta página faz parte de Aplicativo de exemplo: uma integração completa do OneSignal, que acompanha um aplicativo real do início ao fim. O aplicativo é o Clean Beans, uma escala de limpeza para casas compartilhadas, construído com Expo (React Native) e um backend Supabase. Uma Live Activity é uma pequena visualização atualizada ao vivo na tela de bloqueio do iOS e na Dynamic Island. O Clean Beans usa duas: uma contagem regressiva até a janela de limpeza do usuário e um alerta quando uma sequência está prestes a terminar.
Uma Live Activity de lembrete de limpeza na tela de bloqueio do iOS

O lembrete de limpeza em contagem regressiva na tela de bloqueio.

As Live Activities normalmente são iniciadas pelo aplicativo. O Clean Beans as inicia a partir do backend, porque elas precisam aparecer em um horário definido, com o aplicativo aberto ou não. O push-to-start do OneSignal torna isso possível.

Configurar o aplicativo \

Um aplicativo multiplataforma pode deixar o OneSignal gerenciar o ciclo de vida da Live Activity. Uma única chamada na inicialização é todo o JavaScript necessário.
app/_layout.tsx
O único código nativo que você escreve é o layout do widget, em SwiftUI. O Clean Beans adiciona a extensão do widget ao projeto iOS com um pequeno plugin de configuração do Expo, para que o projeto continue podendo ser gerado do zero a cada compilação.
plugins/withLiveActivityWidget.js

Desenhar o widget \

O widget usa o DefaultLiveActivityAttributes do OneSignal, que carrega dados livres. Um único widget atende as duas atividades lendo um valor type e escolhendo um layout.
plugins/widget/CleanBeansWidgetLiveActivity.swift
Cada layout lê seus valores dos dados que o backend enviou. Os attributes são fixados quando a atividade começa. O state pode mudar a cada atualização.
plugins/widget/CleanBeansWidgetLiveActivity.swift
Uma contagem regressiva é desenhada com o estilo de timer do SwiftUI, que avança no dispositivo sem mais atualizações do servidor.

Alerta de sequência: iniciar uma atividade a partir do backend \

Às 19h no horário local, quem tem uma sequência e ainda não limpou nada no dia recebe uma contagem regressiva até a meia-noite. A função horária encontra essas pessoas usando a mesma correspondência de fuso horário dos lembretes push e depois inicia uma atividade para cada uma.
supabase/functions/streak-warning/index.ts
Uma Live Activity de alerta de sequência em contagem regressiva até a meia-noite

O alerta de sequência em contagem regressiva até a meia-noite.

Lembrete de limpeza: iniciar, atualizar, encerrar \

O lembrete de limpeza passa por três fases. Cada uma é uma solicitação separada para a mesma atividade. A função calcula em qual fase cada usuário deve estar.
supabase/functions/cleaning-activity/index.ts
Ela armazena a fase atual no perfil do usuário e só envia uma solicitação quando a fase desejada é diferente. Isso torna seguro executar o job horário repetidamente. Atualizar e encerrar usam um endpoint diferente do de início. A atividade é indicada na URL, então essas solicitações não têm segmentação.
supabase/functions/cleaning-activity/index.ts
Essas solicitações usam priority: 10 porque cada uma é uma mudança de fase que deve aparecer imediatamente, e uma pessoa recebe no máximo algumas por dia. A prioridade 10 conta para o orçamento que a Apple permite a cada dispositivo para atualizações de Live Activity. Para qualquer coisa que seja atualizada com frequência, como um placar ou uma barra de progresso, comece com 5.
Envie atualizações e encerramentos para /apps/{app_id}/live_activities/{activity_id}/notifications, e não para o endpoint de início. O Clean Beans enviava originalmente as três para o endpoint de início, e toda atualização e todo encerramento eram rejeitados com “Missing required parameter - event_attributes”.
Dê a cada atividade seu próprio activity_id e armazene-o quando a atividade começar. O OneSignal não aceita mais atualizações para um activity_id depois que a atividade termina, então um ID fixo por usuário pararia de funcionar após o primeiro dia.

Configuração multiplataforma

setupDefault e a extensão do widget.

Iniciar Live Activity

A API de push-to-start.

Atualizar Live Activity

Solicitações de atualização e encerramento.