Live video data streamed to a broadcast’s ingest stream URL must meet the following specifications. Videos must include both audio and video data and cannot exceed 8 hours in duration. Do not switch settings mid-broadcast.
Resolution — 1280x720
Frame Rate — 30 FPS
Frame Type — Progressive Scan
Keyframe Interval — 2 seconds
Pixel Aspect Ratio — Square
Video Bitrate — 4 Mbps maximum for 720p, 9Mbps for 1080p
Video Codec — H.264 Main Profile (MP 77), H.264 High Profile (HiP 100), CBR
Audio Codec — AAC
Sample Rate — 48kHz
Audio Bitrate — 256kbps
Channel Layout — Stereo
Endpoint | Description |
---|---|
Delete a LiveVideo. | |
Get a collection of LiveVideos on an Event. | |
Get a collection of LiveVideos on a Group. | |
Get fields and edges on a LiveVideo. | |
Get a collection of VideoPolls on a LiveVideo. | |
Get a collection of Profiles that have reacted to a LiveVideo. | |
Get a collection of LiveVideos on a Page. | |
Get a collection of LiveVideos on a User. | |
Update fields on a LiveVideo. | |
Create a LiveVideoInputStream on a LiveVideo. | |
Endpoint | Description |
---|---|
Get fields and edges on a LiveVideoInputStream. | |
Create a LiveVideoInputStream on a LiveVideo. |
Endpoint | Description |
---|---|
Get a collection of VideoPolls on a LiveVideo. | |
Get fields and edges on a VideoPoll. | |
Update fields on a VideoPoll. |
Error messages will be sent via RTMP then will persist through to the Graph API. You can use the broadcast/video ID and query for the errors in the Graph Explorer tool via a GET
request. Errors returned will contain the error code, description, and a timestamp.
error_subcode | Error Summary | Description |
---|---|---|
COPYRIGHT__LIVE_COPYRIGHT_VIOLATION | Live Copyright Violation | Your live video has been stopped because it may contain audio or visual content that belongs to a different Page. |
VIDEO__CREATE_FAILED | Upload Problem | There was a problem and your video was not uploaded. Please try again. |
LIVE_VIDEO__DELETE_FAILED | Live Video Not Deleted | There was a problem and we were not able to delete your live video. Please try again. |
LIVE_VIDEO__EDIT_API_NOT_ALLOWED | Editing Via Video API Is Not Allowed While Live | Editing a live video using the Video Edit API is not allowed. Use the live video ID. |
LIVE_VIDEO__LIVE_STREAM_ERROR | Generic Stream | There was an error during the stream |
LIVE_VIDEO__NOT_EXIST | Live Video Does Not Exist | The live video you are trying to access does not exist in the system any more. |
LIVE_VIDEO__PRIVACY_REQUIRED | Privacy Setting Required | You need to set a privacy before going live. |