با Live Activity شروع کنید

با Firebase Cloud Messaging HTTP v1 API ، می‌توانید از راه دور اعلان‌های فعالیت زنده را در دستگاه‌های iOS ارسال، به‌روزرسانی و پایان دهید. توجه داشته باشید که برای استفاده از فعالیت زنده به iOS 16.1 و برای شروع از راه دور اعلان فعالیت زنده به iOS 17.2 نیاز دارید.

قبل از شروع

قبل از شروع فعالیت زنده در Firebase Cloud Messaging ، دستورالعمل‌های موجود در راه‌اندازی برنامه مشتری Firebase Cloud Messaging در پلتفرم‌های Apple را دنبال کنید تا Firebase Cloud Messaging به برنامه مشتری خود ایجاد و اضافه کنید.

یک فعالیت زنده را شروع کنید

برای شروع یک فعالیت زنده از راه دور با استفاده از Firebase Cloud Messaging ، باید یک توکن push-to-start از اپل دریافت کنید. شما همچنین به رمز ثبت FCM برای برنامه هدف نیاز دارید.

برای ایجاد باری که یک فعالیت زنده را شروع می کند ، فیلد apns.payload را از نمونه کد زیر پر کنید تا از راه دور یک فعالیت زنده را با استفاده از FCM شروع کنید. شما می توانید از API Explorer برای ساخت و آزمایش محموله خود استفاده کنید.

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

یک فعالیت زنده را به روز کنید

برای به‌روزرسانی یک فعالیت زنده از راه دور با استفاده از Firebase Cloud Messaging ، باید از اپل یک Push Token دریافت کنید. شما همچنین به رمز ثبت FCM برای برنامه هدف نیاز دارید.

برای ایجاد باری که یک فعالیت زنده را به روز می کند ، فیلد apns.payload را از نمونه کد زیر پر کنید تا یک فعالیت زنده با استفاده از FCM از راه دور به روز شود. شما می توانید از API Explorer برای ساخت و آزمایش محموله خود استفاده کنید.

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

پایان دادن به یک فعالیت زنده

برای پایان دادن به یک فعالیت زنده با استفاده از Firebase Cloud Messaging ، باید از اپل یک Push Token دریافت کنید. شما همچنین به رمز ثبت FCM برای برنامه هدف نیاز دارید.

برای ایجاد باری که به یک فعالیت زنده پایان می دهد ، فیلد apns.payload را از نمونه کد زیر پر کنید تا از راه دور یک فعالیت زنده را با استفاده از FCM پایان دهید. شما می توانید از API Explorer برای ساخت و آزمایش محموله خود استفاده کنید.

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