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

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

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

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

התחלת פעילות בשידור חי

כדי להתחיל פעילות בשידור חי מרחוק באמצעות Firebase Cloud Messaging, צריך לקבל מ-Apple אסימון להפעלה בלחיצת לחצן. נדרש גם אסימון הרישום 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, צריך לקבל מ-Apple טוקן דחיפה. תצטרכו גם את אסימון הרישום FCM של אפליקציית היעד.

כדי ליצור מטען ייעודי (payload) שמעדכן פעילות בזמן אמת, צריך למלא את השדה 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, צריך לקבל מ-Apple אסימון דחיפה. נדרש גם אסימון הרישום 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"
          }
        }
      }
    }
  }
}