Premiers pas avec l'activité en direct

L'API HTTP v1 Firebase Cloud Messaging vous permet d'envoyer, de mettre à jour et de mettre fin à distance aux notifications d'activités 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 les activités en direct sur Firebase Cloud Messaging, suivez les instructions de 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 de démarrage par pression 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, renseignez 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 d'Apple. Vous aurez également besoin du jeton d'enregistrement FCM pour l'application cible.

Pour construire une charge utile qui met à jour une activité en direct, renseignez 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 l'explorateur d'API 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"
          }
        }
      }
    }
  }
}

Mettre fin à une activité en direct

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

Pour construire une charge utile qui met fin à une activité en direct, remplissez le champ apns.payload de l'exemple de code suivant pour mettre fin à une activité en direct à distance à 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_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"
          }
        }
      }
    }
  }
}