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 o 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 tempo real

Para atualizar remotamente uma atividade ativa usando Firebase Cloud Messaging, você precisa receber um token de envio (em inglês) 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 API Explorer para criar e testar o 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"
          }
        }
      }
    }
  }
}