Iniziare a utilizzare Attività in tempo reale

Con l'API HTTP v1 di Firebase Cloud Messaging, puoi inviare, aggiornare e terminare da remoto le notifiche relative alle attività in tempo reale sui dispositivi iOS. Tieni presente che è necessario iOS 16.1 per utilizzare l'attività in tempo reale e iOS 17.2 per avviare da remoto una notifica relativa all'attività in tempo reale.

Prima di iniziare

Prima di iniziare a utilizzare l'attività in tempo reale su Firebase Cloud Messaging, segui le istruzioni riportate in Configurare un'app client Firebase Cloud Messaging sulle piattaforme Apple per creare e aggiungere Firebase Cloud Messaging all'app client.

Avviare un'attività in diretta

Per avviare un'attività in diretta da remoto utilizzando Firebase Cloud Messaging, devi ottenere un token push-to-start da Apple. Sarà necessario anche il token di registrazione di FCM per l'app di destinazione.

Per creare un payload che avvia un'attività in diretta, compila il campo apns.payload del seguente codice di esempio per avviare da remoto un'attività in diretta utilizzando FCM. Puoi utilizzare Explorer API per creare e testare il tuo 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"
          }
        }
      }
    }
  }

Aggiornare un'attività in tempo reale

Per aggiornare un'attività dal vivo da remoto utilizzando Firebase Cloud Messaging, devi ottenere un token push di Apple. Sarà necessario anche il token di registrazione di FCM per l'app di destinazione.

Per creare un payload che aggiorna un'attività in diretta, compila il campo apns.payload del seguente esempio di codice per aggiornare da remoto un'attività in diretta utilizzando FCM. Puoi utilizzare Explorer API per creare e testare il tuo 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"
          }
        }
      }
    }
  }
}

Terminare un'attività in diretta

Per terminare un'attività dal vivo usando Firebase Cloud Messaging, devi ottenere un token push da Apple. Ti servirà anche il token di registrazioneFCM per l'app di destinazione.

Per creare un payload che termina un'attività in diretta, compila il campo apns.payload del seguente codice di esempio per terminare da remoto un'attività in diretta utilizzando FCM. Puoi utilizzare Explorer API per creare e testare il tuo 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"
          }
        }
      }
    }
  }
}