Canlı Etkinlik'i kullanmaya başlama

Firebase Cloud Messaging HTTP v1 API ile iOS cihazlarda canlı etkinlik bildirimlerini uzaktan gönderebilir, güncelleyebilir ve sonlandırabilirsiniz. Canlı etkinliği kullanmak için iOS 16.1, canlı etkinlik bildirimini uzaktan başlatmak için ise iOS 17.2 sürümünün yüklü olması gerekir.

Başlamadan önce

Firebase Cloud Messaging'da canlı etkinliği kullanmaya başlamadan önce Firebase Cloud Messaging oluşturup istemci uygulamanıza eklemek için Apple platformlarında Firebase Cloud Messaging istemci uygulaması ayarlama başlıklı makaledeki talimatları uygulayın.

Canlı etkinlik başlatma

Firebase Cloud Messaging kullanarak canlı aktiviteyi uzaktan başlatmak için Apple'dan başlatmak için basma jetonu almanız gerekir. Ayrıca hedef uygulama için FCM kayıt jetonuna da ihtiyacınız vardır.

Canlı etkinlik başlatan bir yük oluşturmak için aşağıdaki kod örneğindeki apns.payload alanını doldurarak FCM kullanarak canlı etkinliği uzaktan başlatın.

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

Çalıştır

Örneği API Gezgini'nde denemek için Çalıştır'ı tıklayın.

Canlı etkinliği güncelleme

Firebase Cloud Messaging kullanarak etkin bir canlı aktiviteyi uzaktan güncellemek için Apple'dan push jetonu almanız gerekir. Ayrıca hedef uygulama için FCM kayıt jetonuna da ihtiyacınız vardır.

LiveActivity'yi güncelleyen bir yük oluşturmak için aşağıdaki kod örneğindeki apns.payload alanını doldurarak FCM kullanarak canlı bir etkinliği uzaktan güncelleyin.

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

Çalıştır

Örneği API Gezgini'nde denemek için Çalıştır'ı tıklayın.

Canlı etkinliği sonlandırma

Firebase Cloud Messaging kullanarak canlı etkinliği sonlandırmak için Apple'dan push jetonu almanız gerekir. Ayrıca hedef uygulama için FCM kayıt jetonuna da ihtiyacınız olacaktır.

Canlı etkinliği sonlandıran bir yük oluşturmak için aşağıdaki kod örneğinden apns.payload alanını doldurarak FCM kullanarak canlı etkinliği uzaktan sonlandırın.

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

Çalıştır

Örneği API Gezgini'nde denemek için Çalıştır'ı tıklayın.