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