ライブ動画の配信予約はv12.0で廃止され、2021年12月14日にはすべてのバージョンで廃止されます。POST /ID/live-video
エンドポイントをplanned_start_time
パラメーターを指定して呼び出すとエラーが返されるようになります。
ライブ動画APIを使用して、作成日から7日後までの間の事前に設定した時間にライブ配信するライブ動画を作成することができます。
ユーザー、ページ、グループ、またはイベントで、開始日が先の日付のライブ動画配信を作成するには、次の宛先にリクエストを送信します。
POST /{node-id}/live_videos?status=SCHEDULED_UNPUBLISHED&planned_start_time={start-time}
予定開始時間を示すには、planned_start_time
パラメーターとUNIXタイムスタンプを使用します。
これにより、目的のノードにLiveVideoオブジェクトが作成され、ライブ動画のsecure_stream_url
とid
が返されます。予定された開始時間、または開始時間前にライブ動画データをLiveVideoオブジェクトにストリーミングするには、エンコーダーでセキュアなストリームURLを使用します。ライブ配信は、ストリーミングデータを受信できる限り、予定された開始時間にノードのタイムライン/フィードに表示されます。
スケジュールを設定したライブ配信では、開始日より前の任意の時点に、プレビュー目的で、ストリーミングデータを受け取れます。
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を使用して、未公開のライブ動画配信、つまりstatus
をSCHEDULED_UNPUBLISHED
またはUNPUBLISHED
に設定して作成されたLiveVideoオブジェクトをプレビューできます。
未公開のライブ動画配信をプレビューするには、次の宛先にリクエストを送信します。
GET /{live_video_id}?fields={fields}
LiveVideo
オブジェクトのdash_preview_url
を取得するには、{fields}
パラメーターを使用します。
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
を返します。ライブ配信をプレビューするには、URLをコピーしてDashプレイヤーに貼り付けます。
サードパーティ製のテストプレイヤーを使用してライブ配信をプレビューするのはライブ配信のコンテンツを確認するのに良い方法ではありますが、テストページにライブ配信することをお勧めします。ページにライブ配信するには、ページ管理者またはページ編集者である必要があります。さらに、プライバシーパラメーターを設定して、ストリーミングが自分だけに表示されるようにすることができます。
ユーザー、ページ、グループ、またはイベントでスケジュールが設定されたライブ配信のリストを取得するには、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オブジェクトのIDを返します。
curl -i -X POST \
"https://graph.facebook.com/{live-video-id}?planned_start_time=1541540800&access_token={access-token}"
{ "id": "10214937378883406" }
ライブ配信を即時開始するには、次の宛先にリクエストを送信します。
POST /{live-video-id}?status=LIVE_NOW
ライブ配信を表すLiveVideoオブジェクトに関連付けられたストリーミングURLがストリーミングデータを受け取ると、ライブ配信が開始されます。リクエストが正常に処理されると、APIはLiveVideoオブジェクトのIDを返します。
curl -i -X POST \
"https://graph.facebook.com/{live-video-id}?status=LIVE_NOW&access_token={access-token}"
{ "id": "10214937378883406" }