การเริ่มต้นใช้งาน

เอกสารนี้อธิบายวิธีใช้ API วิดีโอถ่ายทอดสดเพื่อแพร่ภาพวิดีโอถ่ายทอดสดโดยใช้แอพของคุณ หากคุณไม่มีแอพ คุณสามารถใช้ Graph API Explorer และซอฟต์แวร์สตรีมที่คุณต้องการได้

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

หากคุณมีแอพ คุณจะต้องมีสิ่งต่อไปนี้

• ID แอพ Meta ที่มีกรณีการใช้งานการเข้าสู่ระบบด้วย Facebook
• มีการใช้การเข้าสู่ระบบด้วย Facebook ในแอพของคุณ

  • หากแอพของคุณอยู่บนอุปกรณ์ที่ไม่มีอินเทอร์เฟซที่ช่วยให้ผู้ใช้สามารถลงชื่อเข้าใช้ Facebook ได้ ให้ใช้การเข้าสู่ระบบ Facebook สำหรับอุปกรณ์ แทน
• สิทธิ์การอนุญาต publish_video
• โทเค็นการเข้าถึง

หากคุณไม่มีแอพ คุณจะต้องมีสิ่งต่อไปนี้ด้วย

• Graph API Explorer
• ซอฟต์แวร์สตรีมวิดีโอ

เริ่มการแพร่ภาพ

หากต้องการสร้างอ็อบเจ็กต์ LiveVideo ให้ส่งคำขอ POST ไปยังตำแหน่งข้อมูล /me/live_videos?status=LIVE_NOW โดยที่ me คือ ID สำหรับผู้ใช้หรือเพจ

curl -i -X POST \
 "https://graph.facebook.com/v21.0/me/live_videos?status=LIVE_NOW"

ระบบจะส่งคืนการตอบกลับที่มีลักษณะดังนี้

{ 
  "id": "10214937378883406",  //The LiveVideo object ID
  "stream_url": "rtmp://rtmp-api.faceboo...",
  "secure_stream_url": "rtmps://rtmp-api.faceboo...", //The stream URL
  "stream_secondary_urls": [],
  "secure_stream_secondary_urls": []
}

เก็บบันทึกค่า id และ secure_stream_url ที่ระบบส่งคืนมาให้คุณ โดย id คือ ID ของอ็อบเจ็กต์ LiveVideo ซึ่งคุณสามารถใช้เพื่อจัดการการแพร่ภาพได้ ส่วน secure_stream_url คือ URL นำเข้า ซึ่งคุณจะใช้ในการสตรีมข้อมูลวิดีโอถ่ายทอดสดจากตัวเข้ารหัสไปยังอ็อบเจ็กต์ LiveVideo

สตรีมการแพร่ภาพ

ส่งค่า secure_stream_url ที่คุณเก็บบันทึกไว้ในขั้นตอนล่าสุดไปยังอุปกรณ์เข้ารหัส และสตรีมข้อมูลวิดีโอถ่ายทอดสดไปยังอุปกรณ์ดังกล่าว เมื่ออ็อบเจ็กต์ LiveVideo ตรวจพบข้อมูลการสตรีม การแพร่ภาพจะเริ่มถ่ายทอดสดบนโปรไฟล์ผู้ใช้ของคุณ

ดูโปรไฟล์ของคุณและตรวจสอบว่าได้มีการสร้างโพสต์วิดีโอถ่ายทอดสดใหม่ขึ้นมาแล้วและกำลังแพร่ภาพข้อมูลการสตรีมของคุณ

หากคุณกำลังใช้ซอฟต์แวร์การสตรีมแทนที่จะพัฒนาแอพของคุณเองขึ้นมา ให้เพิ่มค่า secure_stream_url ลงในซอฟต์แวร์ของคุณด้วยตนเอง คุณอาจจำเป็นต้องแบ่ง URL ของสตรีมออกเป็นส่วนเซิร์ฟเวอร์ (rtmps://rtmp-api.facebook.com/rtmp/) กับส่วนที่เป็นองค์ประกอบหลัก (ส่วนทั้งหมดที่อยู่หลัง /rtmp/) ของ URL นั้นๆ ทั้งนี้ขึ้นอยู่กับซอฟต์แวร์สตรีมที่คุณใช้งาน

จบการแพร่ภาพ

หากต้องการจบการแพร่ภาพ ให้ส่งคำขอ POST ไปยังตำแหน่งข้อมูล /<LIVE_VIDEO_ID>?end_live_video=true

ตัวอย่างคำขอจบการแพร่ภาพ

curl -i -X POST \
  "https://graph.facebook.com/v21.0/<LIVE_VIDEO_ID>?end_live_video=true"

คำขอนี้จะจบการแพร่ภาพของคุณ และบันทึกเป็นวิดีโอตามความต้องการ (VOD) หากคุณต้องการลบ VOD ให้ส่งคำขอไปยังตำแหน่งข้อมูล DELETE /<LIVE_VIDEO_ID>

รหัสข้อผิดพลาดเมื่อสิทธิ์การอนุญาตถูกปฏิเสธ

ขั้นตอนถัดไป

• ใช้ API วิดีโอถ่ายทอดสดเพื่อกำหนดเวลาแพร่ภาพวิดีโอถ่ายทอดสดให้กับการแพร่ภาพในอนาคต