リファレンス

推奨設定

ライブ動画の配信を適切に行うには、次の条件を満たす必要があります。

音声データと動画データの両方を含める
8時間を超えないようにする
後述の推奨設定を利用する(例: H264/AACでなければならない)
配信中に設定を変更しない

これらの制約に従わない場合、次のような状態が発生する可能性があります。

ストリーミングの予期しない終了
視聴の質の低下
予期しない動作

動画の設定

キーフレームサイズ — 推奨は2秒。4秒を超えないようにしてください。
解像度とビットレート —
60FPSで1080p
解像度: 1920x1080
動画ビットレート範囲: 4,500～9,000Kbps
30FPSで1080p
解像度: 1920x1080
動画ビットレート範囲: 3,000～6,000Kbps
60FPSで720p
解像度: 1280x720
動画ビットレート範囲: 2,250～6,000Kbps
30FPSで720p
解像度: 1280x720
動画ビットレート範囲: 1,500～4,000Kbps
30FPSで480p
解像度: 854x480
動画ビットレート範囲: 600～2,000Kbps
360p
解像度: 640x360
動画ビットレート範囲: 400～1,000Kbps
プロトコル — RTMPSストリーミング
Pixelアスペクト比 — 目安は16:9。この比率から外れすぎている場合は、ストリームをサポートできない場合があります
動画コーデック —
- H.264、1080p/30FPSまではレベル4.1
- H.264、1080p/60FPSでレベル4.2

音声の設定

音声コーデック — AAC Low Complexity
サンプルレート — 44.1kHzまたは48kHz
音声ビットレート — 128kbps (推奨)～256kbps (超えないこと)
チャンネルレイアウト — ステレオ

エンドポイント

LiveVideo

エンドポイント	説明
`DELETE /{live_video_id}`	LiveVideoを削除します。
`GET /{event-id}/live_videos`	イベントのLiveVideoのコレクションを取得します。
`GET /{group-id}/live_videos`	グループのLiveVideoのコレクションを取得します。
`GET /{live-video-id}`	LiveVideoのフィールドとエッジを取得します。
`GET /{live-video-id}/comments`	LiveVideoのコメントのコレクションを取得します。
`GET /{live-video-id}/crosspost_shared_pages`	LiveVideoをシェアできるページのコレクションを取得します。
`GET /{live-video-id}/likes`	LiveVideoに「いいね！」したプロフィールのコレクションを取得します。
`GET /{live-video-id}/polls`	LiveVideoのVideoPollのコレクションを取得します。
`GET /{live-video-id}/reactions`	LiveVideoにリアクションしたプロフィールのコレクションを取得します。
`GET /{page-id}/live_videos`	ページのLiveVideoのコレクションを取得します。
`GET /{user-id}/live_videos`	ユーザーのLiveVideoのコレクションを取得します。
`POST /{event-id}/live_videos`	イベントでLiveVideoを作成します。
`POST /{group-id}/live_videos`	グループでLiveVideoを作成します。
`POST /{live_video_id}`	LiveVideoのフィールドをアップデートします。
`POST /{live_video_id}/input_streams`	LiveVideoのLiveVideoInputStreamを作成します。
`POST /{live_video_id}/polls`	LiveVideoのVideoPollを作成します。
`POST /{page-id}/live_videos`	ページでLiveVideoを作成します。
`POST /{user-id}/live_videos`	ユーザーでLiveVideoを作成します。

LiveVideoInputStream

エンドポイント	説明
`GET /{live-video-input-stream-id}`	LiveVideoInputStreamのフィールドとエッジを取得します。
`POST /{live_video_id}/input_streams`	LiveVideoのLiveVideoInputStreamを作成します。

Polls

エンドポイント	説明
`GET /{live-video-id}/polls`	LiveVideoのVideoPollのコレクションを取得します。
`GET /{video-poll-id}`	VideoPollのフィールドとエッジを取得します。
`POST /{live_video_id}/polls`	LiveVideoのVideoPollを作成します。
`POST /{video_poll_id}`	VideoPollのフィールドをアップデートします。

エラーコード

エラーメッセージはRTMP経由で送信され、その後グラフAPIまで保持されます。一斉配信/動画IDを使用して、GETリクエストによりグラフエクスプローラツールでエラーをクエリできます。返されるエラーには、エラーコード、説明、タイムスタンプが含まれています。

error_subcode	エラーの概要	説明
`COPYRIGHT__LIVE_COPYRIGHT_VIOLATION`	ライブ動画の著作権違反	他のページが所有する音声または視覚コンテンツが含まれている可能性があるため、ライブ動画が停止されました。
`VIDEO__CREATE_FAILED`	アップロードの問題	問題が発生したため、動画がアップロードされませんでした。もう一度実行してください。
`LIVE_VIDEO__DELETE_FAILED`	ライブ動画が削除されない	問題が発生したため、ライブ動画を削除できませんでした。もう一度実行してください。
`LIVE_VIDEO__EDIT_API_NOT_ALLOWED`	ライブ配信中は動画APIによる編集はできない	動画編集APIを使用してライブ動画を編集することはできません。ライブ動画IDを使用してください。
`LIVE_VIDEO__LIVE_STREAM_ERROR`	一般的なストリーミングエラー	ストリーミング中にエラーが発生しました。
`LIVE_VIDEO__NOT_EXIST`	ライブ動画が存在しない	アクセスしようとしているライブ動画は現在システムに存在しません。
`LIVE_VIDEO__PRIVACY_REQUIRED`	プライバシー設定が必要	ライブ配信の前にプライバシーを設定する必要があります。