איך מתחילים להפעיל את ההגדרה 'פעילות בשידור חי'

עם Firebase Cloud Messaging HTTP v1 API, אפשר לשלוח, לעדכן ולסיים מרחוק התראות על פעילות בשידור חי במכשירי iOS. שימו לב שצריך iOS 16.1 כדי להשתמש בפעילות בזמן אמת, ו-iOS 17.2 כדי להתחיל מרחוק התראה על פעילות בזמן אמת.

לפני שמתחילים

לפני שמתחילים להשתמש בפעילות בזמן אמת ב-Firebase Cloud Messaging, צריך לפעול לפי ההוראות במאמר הגדרת אפליקציית לקוח של העברת הודעות בענן ב-Firebase בפלטפורמות של אפל כדי ליצור את Firebase Cloud Messaging ולהוסיף אותו לאפליקציית הלקוח.

התחלת פעילות בזמן אמת

כדי להתחיל פעילות בזמן אמת מרחוק באמצעות Firebase Cloud Messaging, צריך לקבל מ-Apple אסימון push-to-start. תצטרכו גם את אסימון הרישום של FCM של אפליקציית היעד.

כדי ליצור payload שמתחיל פעילות במצב לייב, צריך למלא את השדה 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

הרצה

לוחצים על Run כדי לנסות את הדוגמה ב-API Explorer.

עדכון פעילות בזמן אמת

כדי לעדכן פעילות בזמן אמת מרחוק באמצעות Firebase Cloud Messaging, צריך לקבל אסימון push מאפל. תצטרכו גם את אסימון הרישום של FCM לאפליקציית היעד.

כדי ליצור payload לעדכון פעילות במצב לייב, צריך למלא את השדה 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

הרצה

לוחצים על Run כדי לנסות את הדוגמה ב-API Explorer.

איך מסיימים פעילות בזמן אמת

כדי לסיים פעילות בזמן אמת באמצעות Firebase Cloud Messaging, צריך לקבל אסימון התראות מ-Apple. תצטרכו גם את אסימון הרישום של FCM לאפליקציית היעד.

כדי ליצור מטען ייעודי (payload) שמסיים פעילות בזמן אמת, ממלאים את השדה 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

הרצה

לוחצים על Run כדי לנסות את הדוגמה ב-API Explorer.