Pierwsze kroki z Live Activity

Za pomocą interfejsu Firebase Cloud Messaging HTTP v1 API możesz zdalnie wysyłać, aktualizować i kończyć powiadomienia o aktywności na żywo na urządzeniach z iOS. Aby korzystać z aktywności na żywo, musisz mieć iOS 16.1, a aby zdalnie uruchamiać powiadomienia o aktywności na żywo, musisz mieć iOS 17.2.

Zanim zaczniesz

Zanim zaczniesz korzystać z aktywności na żywo w Firebase Cloud Messaging, postępuj zgodnie z instrukcjami w Konfigurowanie aplikacji klienckiej Komunikacji w chmurze Firebase (FCM) na platformach Apple, aby utworzyć i dodać Firebase Cloud Messaging do aplikacji klienckiej.

Rozpoczynanie aktywności na żywo

Aby zdalnie rozpocząć aktywność na żywo za pomocą Firebase Cloud Messaging, musisz uzyskać token push-to-start od Apple. Będziesz też potrzebować FCM tokena rejestracji dla aplikacji docelowej.

Aby utworzyć ładunek, który rozpoczyna aktywność na żywo, wypełnij pole apns.payload z tego przykładowego kodu, aby zdalnie rozpocząć aktywność na żywo za pomocą 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

Uruchom

Aby wypróbować przykład w API Explorerze , kliknij Uruchom.

Aktualizowanie aktywności na żywo

Aby zdalnie zaktualizować aktywność na żywo za pomocą Firebase Cloud Messaging, musisz uzyskać token push od Apple. Będziesz też potrzebować FCM tokena rejestracji dla aplikacji docelowej.

Aby utworzyć ładunek, który aktualizuje aktywność na żywo, wypełnij pole apns.payload z tego przykładowego kodu, aby zdalnie zaktualizować aktywność na żywo za pomocą 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

Uruchom

Aby wypróbować przykład w API Explorerze , kliknij Uruchom.

Kończenie aktywności na żywo

Aby zakończyć aktywność na żywo za pomocą Firebase Cloud Messaging, musisz uzyskać od Apple token push. Będziesz też potrzebować FCM tokena rejestracji dla aplikacji docelowej.

Aby utworzyć ładunek, który kończy aktywność na żywo , wypełnij pole apns.payload z tego przykładowego kodu, aby zdalnie zakończyć aktywność na żywo za pomocą 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

Uruchom

Aby wypróbować przykład w API Explorerze , kliknij Uruchom.