Começar a usar a atividade em tempo real

Com a API HTTP v1 Firebase Cloud Messaging, é possível enviar, atualizar e encerrar remotamente as notificações de atividade em tempo real em dispositivos iOS. Você precisa do iOS 16.1 para usar a atividade em tempo real e do iOS 17.2 para iniciar remotamente uma notificação de atividade em tempo real.

Antes de começar

Antes de começar a usar a atividade em tempo real no Firebase Cloud Messaging, siga as instruções em Configurar um app cliente do Firebase Cloud Messaging em plataformas da Apple para criar e adicionar Firebase Cloud Messaging ao app cliente.

Iniciar uma atividade ao vivo

Para iniciar uma atividade ao vivo remotamente usando Firebase Cloud Messaging, é necessário receber um token push-to-start da Apple. Você também vai precisar do token de registro FCM para o app de destino.

Para criar um payload que inicia uma atividade ao vivo, preencha o campo apns.payload do exemplo de código abaixo para iniciar remotamente uma atividade ao vivo usando FCM. Use o API Explorer para criar e testar seu payload.

"message":{
    "token": "<fcm_token:test>",
    "apns":{
      "live_activity_token": "<live_activity_push_to_start_token>",
      "headers":{
        "apns-priority": "10"
      },
      "payload":{
        "aps": {
          "timestamp": <timestamp>,
          "event": "start",
          "content-state": {
            "demo": 1
          },
          "attributes-type": "DemoAttributes",
          "attributes": {
            "demoAttribute": 1,
          },
          "alert": {
            "title": "test title",
            "body": "test body"
          }
        }
      }
    }
  }

Atualizar uma atividade em andamento

Para atualizar uma atividade ativa remotamente usando Firebase Cloud Messaging, é necessário receber um token de push da Apple. Você também vai precisar do token de registro FCM para o app de destino.

Para criar um payload que atualize uma atividade ao vivo, preencha o campo apns.payload do exemplo de código a seguir para atualizar remotamente uma atividade em tempo real usando FCM. Use o API Explorer para criar e testar seu payload.

"message":{
    "token": "<fcm_token:test>",
    "apns":{
      "live_activity_token": "<live_activity_push_token>",
      "headers":{
        "apns-priority": "10"
      },
      "payload":{
        "aps": {
          "timestamp": <timestamp>,
          "event": "update",
          "content-state": {
            "test1": 100,
            "test2": "demo"
          },
          "alert": {
            "title": "test title",
            "body": "test body"
          }
        }
      }
    }
  }
}

Encerrar uma atividade ao vivo

Para encerrar uma atividade ao vivo usando Firebase Cloud Messaging, é necessário receber um token de push da Apple. Você também precisará do token de registro FCM para o app de destino.

Para criar um payload que encerra uma atividade em tempo real, preencha o campo apns.payload do exemplo de código abaixo para encerrar remotamente uma atividade em tempo real usando FCM. Use o APIs Explorer para criar e testar seu payload.

"message":{
     "token": "<fcm_token:test>",
    "apns":{
      "live_activity_token": "<live_activity_push_token>",
      "headers":{
        "apns-priority": "10"
      },
      "payload":{
        "aps": {
          "timestamp": <timestamp>,
          "dismissal-date": <dismissal_date>,
          "event": "end",
          "content-state": {
            "test1": 100,
            "test2": "demo"
          },
          "alert": {
            "title": "test title",
            "body": "test body"
          }
        }
      }
    }
  }
}