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

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

قبل از شروع

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

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

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

برای ساختن بار که فعالیت زنده را شروع می‌کند، فیلد apns.payload را از نمونه کد زیر تکمیل کنید تا فعالیت زنده را بااستفاده از 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

اجرا

برای امتحان کردن نمونه در کاوشگر API، روی اجرا کردن کلیک کنید.

به‌روزرسانی فعالیت Live

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

برای ساختن بار که «فعالیت زنده» را به‌روز می‌کند، فیلد apns.payload را از نمونه کد زیر تکمیل کنید تا فعالیت زنده‌ای را بااستفاده از 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

اجرا

برای امتحان کردن نمونه در کاوشگر API، روی اجرا کردن کلیک کنید.

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

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

برای ساختن باربری که فعالیت زنده را پایان می‌دهد، فیلد apns.payload را از نمونه کد زیر تکمیل کنید تا فعالیت زنده را بااستفاده از 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

اجرا

برای امتحان کردن نمونه در کاوشگر API، روی اجرا کردن کلیک کنید.