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

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

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

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

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

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

כדי ליצור payload שמתחיל פעילות במצב לייב, צריך למלא את השדה apns.payload מקוד הדוגמה הבא כדי להתחיל מרחוק פעילות במצב לייב באמצעות FCM. אפשר להשתמש בAPI Explorer כדי ליצור ולבדוק את מטען הייעודי (payload).

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

כדי ליצור payload לעדכון פעילות בזמן אמת, צריך למלא את השדה apns.payload בדוגמת הקוד הבאה כדי לעדכן מרחוק פעילות בזמן אמת באמצעות FCM. אפשר להשתמש בAPI Explorer כדי ליצור ולבדוק את מטען הייעודי (payload).

"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, צריך לקבל push token מאפל. תצטרכו גם את אסימון הרישום של FCM של אפליקציית היעד.

כדי ליצור payload שמסיים פעילות במצב לייב, צריך למלא את השדה apns.payload בדוגמת הקוד הבאה כדי לסיים מרחוק פעילות במצב לייב באמצעות FCM. אפשר להשתמש בAPI Explorer כדי ליצור ולבדוק את מטען הייעודי (payload).

"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"
          }
        }
      }
    }
  }
}