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

Firebase Cloud Messaging HTTP v1 API ช่วยให้คุณส่ง อัปเดต และสิ้นสุดการแจ้งเตือนกิจกรรมแบบเรียลไทม์ในอุปกรณ์ iOS จากระยะไกลได้ โปรดทราบว่าคุณต้องใช้ iOS 16.1 เพื่อใช้กิจกรรมแบบเรียลไทม์ และ iOS 17.2 เพื่อเริ่มการแจ้งเตือนกิจกรรมแบบเรียลไทม์จากระยะไกล

ก่อนเริ่มต้น

ก่อนเริ่มต้นใช้งานกิจกรรมแบบเรียลไทม์ใน Firebase Cloud Messaging ให้ทำตาม วิธีการในหัวข้อตั้งค่าแอปไคลเอ็นต์ Firebase Cloud Messaging ในแพลตฟอร์ม Apple เพื่อสร้างและเพิ่ม Firebase Cloud Messaging ลงในแอปไคลเอ็นต์

เริ่มกิจกรรม Live

หากต้องการเริ่มกิจกรรมแบบเรียลไทม์จากระยะไกลโดยใช้ Firebase Cloud Messaging คุณต้องรับโทเค็น Push-to-Start จาก 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 คุณต้องรับ Push Token จาก Apple นอกจากนี้ คุณยังต้องมีโทเค็นการลงทะเบียน FCM สำหรับแอปเป้าหมายด้วย

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

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