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

באמצעות HTTP v1 API של Firebase Cloud Messaging, אפשר לשלוח, לעדכן ולסגור מרחוק התראות על פעילות בשידור חי במכשירי iOS. חשוב לזכור שצריך גרסת iOS מגרסה 16.1 כדי להשתמש בפעילות בשידור חי, ומגרסה 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 של אפליקציית היעד.

כדי ליצור מטען נתונים שמעדכן פעילות בשידור חי, ממלאים את השדה 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"
          }
        }
      }
    }
  }
}