Premiers pas avec l'activité en direct

Avec l'API HTTP v1 Firebase Cloud Messaging, vous pouvez envoyer, mettre à jour et mettre fin à distance aux notifications d'activité en direct sur les appareils iOS. Notez que vous avez besoin d'iOS 16.1 pour utiliser l'activité en direct et d'iOS 17.2 pour démarrer à distance une notification d'activité en direct.

Avant de commencer

Avant de commencer à utiliser l'activité en direct sur Firebase Cloud Messaging, suivez les instructions de la section Configurer une application cliente Firebase Cloud Messaging sur les plates-formes Apple pour créer et ajouter Firebase Cloud Messaging à votre application cliente.

Démarrer une activité en direct

Pour démarrer une activité en direct à distance à l'aide de Firebase Cloud Messaging, vous devez obtenir un jeton Push-to-start auprès d'Apple. Vous aurez également besoin du jeton d'enregistrement FCM pour l'application cible.

Pour créer une charge utile qui démarre une activité en direct, remplissez le champ apns.payload de l'exemple de code suivant pour démarrer à distance une activité en direct à l'aide de FCM. Vous pouvez utiliser l'explorateur d'API pour créer et tester votre charge utile.

"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"
          }
        }
      }
    }
  }

Mettre à jour une activité en direct

Pour mettre à jour une activité en direct à distance à l'aide de Firebase Cloud Messaging, vous devez obtenir un jeton push auprès d'Apple. Vous aurez également besoin du jeton d'enregistrement FCM pour l'application cible.

Pour créer une charge utile qui met à jour une activité en direct, remplissez le champ apns.payload de l'exemple de code suivant pour mettre à jour à distance une activité en direct à l'aide de FCM. Vous pouvez utiliser APIs Explorer pour créer et tester votre charge utile.

"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"
          }
        }
      }
    }
  }
}

Arrêter une activité en direct

Pour mettre fin à une activité en direct à l'aide de Firebase Cloud Messaging, vous devez obtenir un jeton push auprès d'Apple. Vous aurez également besoin du jeton d'enregistrement FCM pour l'application cible.

Pour créer une charge utile qui met fin à une activité en direct, renseignez le champ apns.payload de l'exemple de code suivant afin de mettre fin à une activité en direct à distance à l'aide de FCM. Vous pouvez utiliser APIs Explorer pour créer et tester votre charge utile.

"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"
          }
        }
      }
    }
  }
}