เริ่มต้นใช้งานการถ่ายทอดสด

Firebase Cloud Messaging HTTP v1 API ช่วยให้คุณส่ง อัปเดต และสิ้นสุดการแจ้งเตือนกิจกรรมที่กำลังดำเนินอยู่จากระยะไกลในอุปกรณ์ 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

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

เรียกใช้

คลิกเรียกใช้เพื่อลองใช้ตัวอย่างในโปรแกรมสำรวจ API

อัปเดตกิจกรรม Live

หากต้องการอัปเดตกิจกรรมที่กำลังดำเนินอยู่จากระยะไกลโดยใช้ Firebase Cloud Messaging คุณต้อง ขอโทเค็นพุช จาก Apple นอกจากนี้ คุณยังต้องมีโทเค็นการลงทะเบียนFCM สำหรับแอปเป้าหมายด้วย

หากต้องการสร้างเพย์โหลดที่อัปเดตกิจกรรม Live ให้กรอกข้อมูลในช่อง apns.payload จากตัวอย่างโค้ดต่อไปนี้เพื่ออัปเดตกิจกรรม Live จากระยะไกลโดยใช้ 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

เรียกใช้

คลิกเรียกใช้เพื่อลองใช้ตัวอย่างในโปรแกรมสำรวจ API

สิ้นสุดกิจกรรม Live

หากต้องการสิ้นสุดกิจกรรมสดโดยใช้ Firebase Cloud Messaging คุณต้องขอโทเค็นพุช จาก Apple นอกจากนี้ คุณยังต้องมีโทเค็นการลงทะเบียนFCM สำหรับแอปเป้าหมายด้วย

หากต้องการสร้างเพย์โหลดที่สิ้นสุดกิจกรรม Live ให้กรอกข้อมูลในช่อง apns.payload จากตัวอย่างโค้ดต่อไปนี้เพื่อสิ้นสุดกิจกรรม Live จากระยะไกลโดยใช้ 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

เรียกใช้

คลิกเรียกใช้เพื่อลองใช้ตัวอย่างในโปรแกรมสำรวจ API