بدء استخدام "النشاط المباشر"

باستخدام Firebase Cloud Messaging HTTP v1 API، يمكنك إرسال إشعارات الأنشطة المباشرة وتعديلها وإيقافها عن بُعد على أجهزة iOS. يُرجى العِلم أنّه يجب توفّر الإصدار 16.1 من نظام التشغيل iOS لاستخدام ميزة "النشاط Live"، والإصدار 17.2 من نظام التشغيل iOS لبدء إشعار "نشاط Live" عن بُعد.

قبل البدء

قبل البدء في استخدام ميزة "النشاط المباشر" على 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 Explorer.

تعديل نشاط مباشر

لتعديل نشاط مباشر عن بُعد باستخدام 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 Explorer.

إنهاء نشاط 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,
        "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 Explorer.