Live Activities

Live Activities permitem que seus aplicativos iOS e iPadOS entreguem atualizações em tempo real para a Tela de Bloqueio e Dynamic Island, mantendo os usuários informados sem precisar abrir o aplicativo. Introduzido no iOS 16.1 e expandido para o iOS 17, Live Activities são perfeitos para informações sensíveis ao tempo como rastreamento de entregas, placares de jogos ou atualizações de trânsito.

---

​

Por que usar Live Activities?

Live Activities são ótimos para atualizações em tempo real, transacionais ou limitadas no tempo.

• Visível por até 8 horas
• Provisório — nenhuma permissão é necessária para mostrar a primeira Live Activity
• Altamente envolvente e visível em superfícies premium do dispositivo como a Tela de Bloqueio e Dynamic Island

---

​

Por que usar OneSignal?

OneSignal simplifica Live Activities ao lidar com:

• Gerenciamento de token de push temporário
• Escalonamento para milhões de dispositivos com uma única chamada de API
• Análises em tempo real e insights de desempenho
• Orquestração multicanal com Push, Email, SMS e Mensagens In-App

---

​

Começando com Live Activities

​

Requisitos

• iOS 16.1+ ou iPadOS 17+
• OneSignal SDK Mobile integrado
• Configuração completa conforme nosso Guia de Desenvolvedor de Live Activities

​

Como Live Activities funcionam

• Duração Visível: Ativo por até 8 horas (pode ser removido usando o parâmetro dismissal_date na API Update Live Activity).
• Nenhuma Permissão Necessária: Primeira atividade é provisória; futuras dependem das configurações do usuário.
• Limite: Máximo de 5 Live Activities por aplicativo simultaneamente.
• Início Remoto: Suportado a partir do iOS 17.2+ via push.
• Uso Não Promocional: Deve fornecer valor ao usuário—não projetado para anúncios.

​

Criando e Atualizando uma Live Activity

---

​

Melhores práticas e diretrizes

​

Funcionalidade

• Use Live Activities para atualizações transacionais ou contextuais (por exemplo, ETA, placar, cronômetro).
  • Em vez de usuários constantemente entrarem em seu aplicativo para verificar status ou mudanças, eles podem obter atualizações com uma olhada em seu telefone.
  • Eventos ou tarefas com um início e fim definidos. Não use uma Live Activity para exibir anúncios ou servir propósitos puramente promocionais. Que valor você está fornecendo?
• Evite atualizações excessivas para preservar a bateria do dispositivo.
• Garanta que uma Live Activity seja para um evento ou tarefa que não dure mais de 8 horas, e que ela mostre apenas enquanto for útil ao usuário.

​

UI/UX

• Suporte todas as apresentações de Live Activity: Compacta, Mínima, Expandida, Tela de Bloqueio.
• Use marca, espaçamento e temas escuro/claro corretamente.
• Priorize clareza e alvos de toque. Não tente chamar atenção para a Dynamic Island.
• Evite exibir informações sensíveis em uma Live Activity.

​

Direcionamento e envio em escala

Garanta que uma Live Activity apareça quando esperado, geralmente quando um usuário realiza uma ação (por exemplo, para seguir um evento) ou abre o aplicativo para verificar atualizações (por exemplo, tempo de entrega atualizado).

• Direcione segmentos de usuários para eventos como jogos esportivos, shows ou outros eventos ao vivo.
• Direcione usuários individuais para eventos pessoais ou transacionais.

Ao atualizar Live Activities, você tem a opção de definir uma “prioridade” que a Apple usa para determinar quão urgente é a atualização. A Apple tem limites internos nos quais eles limitarão requisições que usam a flag de alta prioridade com muita frequência. Devido a este limite interno, a Apple recomenda escolher uma mistura de prioridade normal e alta para evitar limitação. Detalhes sobre como definir prioridade podem ser encontrados em nossa referência da API Update Live Activity. Se seu caso de uso depende de atualizações de alta prioridade mais frequentes, você pode adicionar a chave NSSupportsLiveActivitiesFrequentUpdates ao seu Info.plist como um tipo Boolean definido para YES conforme instruído na Documentação de Desenvolvedor da Apple. Os usuários verão um diálogo quando a Live Activity exceder seu orçamento de push, e se eles permitirem que a Live Activity continue, o orçamento será automaticamente aumentado para uma experiência do usuário sem problemas.

---

​

FAQ

​

Tenho acesso a Live Activities no meu plano?

Live Activities estão disponíveis em todos os planos exceto planos Gratuitos com mais de 10.000 assinantes que optaram por participar. Se você tiver mais de 10.000 assinantes que optaram por participar em um Plano Gratuito, você pode fazer upgrade para usar Live Activities. Veja os preços ou entre em contato com support@onesignal.com para assistência.

​

Qual é o orçamento para atualizações de alta prioridade?

A Apple não fornece um limite fixo para atualizações de alta prioridade (priority: 10), mas eles aplicam um orçamento dinâmico no nível do sistema. Enviar muitas atualizações de alta prioridade em um curto período pode resultar em limitação, onde atualizações são atrasadas ou descartadas. Para reduzir o risco de limitação:

• Use uma mistura de níveis de prioridade: A Apple recomenda usar tanto priority: 5 (padrão) quanto priority: 10 (alta) para equilíbrio.
• Reserve priority: 10 apenas para atualizações sensíveis ao tempo ou críticas (por exemplo, mudanças de status de pedido, placares de jogos).

Se seu caso de uso requer atualizações frequentes:

• Adicione a chave NSSupportsLiveActivitiesFrequentUpdates ao arquivo Info.plist do seu aplicativo, definida como Boolean YES.
• Quando este orçamento é excedido, o iOS pode solicitar ao usuário que permita atualizações adicionais. Se o usuário concordar, a Apple expandirá automaticamente o limite de atualização permitido para manter uma experiência sem problemas.

Para mais detalhes, consulte a Documentação de Desenvolvedor da Apple.

​

Onde posso ver Live Activities no Painel do OneSignal?

Live Activities podem ser enviados apenas através de nossas APIs de Live Activities. No entanto, você pode visualizar Live Activities enviados historicamente (até 30 dias) no painel em Mensagens Enviadas, após filtrar por Live Activities. Aqui você poderá ver quais Live Activities foram enviados, quais informações atualizadas foram enviadas e o tamanho do público que recebeu a atualização.

​

Quais dispositivos funcionam com Live Activities?

A Apple mantém um guia de compatibilidade atualizado com todos os dispositivos que funcionam com iOS 16+ e iPadOS 17+.

---

---