Premiers pas avec l'activité en direct

Avec l'Firebase Cloud Messaging API HTTP v1, vous pouvez envoyer, mettre à jour et arrêter à distance les notifications d'activité en direct sur les appareils iOS. Notez que vous devez disposer 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 FCM jeton d'enregistrement pour l'application cible.

Pour créer une charge utile qui démarre une activité en direct, remplissez le apns.payload champ de l'exemple de code suivant afin de démarrer à distance une activité en direct à l'aide de FCM.

REST

{
"message": {
  "token": "FCM_TOKEN",
  "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"
        }
      }
    }
  }
}
}

cURL

curl -X POST -H "Authorization: Bearer OAUTH2_ACCESS_TOKEN" -H "Content-Type: application/json" -d '{
"message": {
"token": "FCM_TOKEN",
"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"
      }
    }
  }
}
}
}' https://fcm.googleapis.com/v1/projects/YOUR_PROJECT_ID/messages:send

Exécuter

Cliquez sur Exécuter pour essayer l'exemple dans l'explorateur d'API.

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 FCM jeton d'enregistrement 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 afin de mettre à jour à distance une activité en direct à l'aide de FCM.

REST

{
"message": {
  "token": "FCM_TOKEN",
  "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"
        }
      }
    }
  }
}
}

cURL

curl -X POST -H "Authorization: Bearer OAUTH2_ACCESS_TOKEN" -H "Content-Type: application/json" -d '{
"message": {
"token": "FCM_TOKEN",
"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"
      }
    }
  }
}
}
}' https://fcm.googleapis.com/v1/projects/YOUR_PROJECT_ID/messages:send

Exécuter

Cliquez sur Exécuter pour essayer l'exemple dans l'explorateur d'API.

Arrêter une activité en direct

Pour arrêter 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 FCM jeton d'enregistrement pour l'application cible.

Pour créer une charge utile qui arrête une activité en direct, remplissez le apns.payload champ de l'exemple de code suivant afin d'arrêter à distance une activité en direct à l'aide de FCM.

REST

{
"message": {
  "token": "FCM_TOKEN",
  "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"
        }
      }
    }
  }
}
}

cURL

curl -X POST -H "Authorization: Bearer OAUTH2_ACCESS_TOKEN" -H "Content-Type: application/json" -d '{
"message": {
"token": "FCM_TOKEN",
"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"
      }
    }
  }
}
}
}' https://fcm.googleapis.com/v1/projects/YOUR_PROJECT_ID/messages:send

Exécuter

Cliquez sur Exécuter pour essayer l'exemple dans l'explorateur d'API.