排定直播視訊已在第 12.0 版中停用,並將於 2021 年 12 月 14 日在所有版本中停用。呼叫包含 planned_start_time
參數的 POST /ID/live-video
端點將傳回錯誤。
您可用直播視訊 API 建立直播視訊播放,在從建立日期起最長七天內的預定時間直播。
在用戶、粉絲專頁、社團或活動上建立開始日期在未來的直播視訊播放:
POST /{node-id}/live_videos?status=SCHEDULED_UNPUBLISHED&planned_start_time={start-time}
使用 planned_start_time
參數和 UNIX 時間戳記,指示所要的開始時間。
這會在目標節點上建立 LiveVideo 物件,並傳回直播視訊的 secure_stream_url
和 id
。在排程的開始時間或之前,在編碼器上使用加密串流影片網址,將直播視訊資料串流至 LiveVideo 物件。一收到串流資料後,播放便會在預定的開始時間出現在節點的動態時報/摘要上。
排程的播放可在開始日期之前的任何時間點接收串流資料,以供預覽之用。
curl -i -X POST \
"https://graph.facebook.com/{page-id}/live_videos?status=SCHEDULED_UNPUBLISHED&planned_start_time=1541539800&access_token={access-token}"
{ "id": "10214937378883406", //LiveVideo object ID "stream_url": "rtmp://rtmp-api.facebook...", "secure_stream_url": "rtmps://rtmp-api.facebook..." //Stream URL }
若要取得排程的播放清單,請參閱取得排程的播放。
您可用直播視訊 API 來預覽未發佈的直播視訊播放;所建立之 LiveVideo 物件的 status
設為 SCHEDULED_UNPUBLISHED
或 UNPUBLISHED
。
若要預覽未發佈的直播視訊播放,請發送要求至:
GET /{live_video_id}?fields={fields}
使用 {fields}
參數取得 LiveVideo
物件的 dash_preview_url
。
curl -i -X GET \
"https://graph.facebook.com/{live-video-id}
?fields=dash_preview_url
&access_token={access-token}"
{ 'dash_preview_url': 'https://video.xx.fbcdn.net/...', 'id': '{live-video-id}' }
這會傳回直播視訊的 dash_preview_url
和 id
。複製網址並貼在 Dash Player 中,即可預覽直播。
雖然使用第三方的測試播放器來預覽播放是確認播放內容的好方法,但仍建議您在測試的粉絲專頁上播放。若要在粉絲專頁上播放,您必須是粉絲專頁的管理員或編輯。此外,您還可設定隱私參數,以建立只有您自己看得見的串流影片。
若要取得用戶、粉絲專頁、社團或活動上已排程的播放清單,請取得具備 publish_video
權限合適的存取權杖,並發送要求至:
GET /{node-id}/live_videos?broadcast_status=["SCHEDULED_UNPUBLISHED"]
請注意,broadcast_status
值必須是陣列。如需其他值的完整清單,請參閱 LiveVideo 參考資料。
curl -i -X GET \
"https://graph.facebook.com/{page-id}/live_videos?broadcast_status=["SCHEDULED_UNPUBLISHED"]&access_token={access-token}"
{ "data": [ { "status": "SCHEDULED_UNPUBLISHED", "stream_url": "rtmp://rtmp-api-dev.facebook.com:80/rtmp/...", "secure_stream_url": "rtmps://rtmp-api-dev.facebook.com:443/rtmp/...", "embed_html": "<iframe src=\"https://www.facebook.com/plugins/video.php?...", "id": "10214937378883406 " //LiveVideo object ID } ] }
若要變更排程的播放開始時間,請發送要求至:
POST /{live-video-id}?planned_start_time={new-start-time}
{new-start-time}
值必須是 UNIX 時間戳記,指出新的開始時間。成功時,API 會以 LiveVideo 物件的編號回應。
curl -i -X POST \
"https://graph.facebook.com/{live-video-id}?planned_start_time=1541540800&access_token={access-token}"
{ "id": "10214937378883406" }