直播視像 API

參考資料

建議設定

如要確保成功展開直播，直播視像必須符合以下要求：

同時包含音訊和影片數據
不超過 8 小時
利用下方指定的建議設定（例如：格式必須為 H264/AAC）
不要在直播中途更改設定

如果未能符合這些限制條件，可能會導致以下情況：

串流影片異常終止
向觀眾呈現的直播品質較差
異常行為

影片設定

主要畫面格時長 — 建議設定為 2 秒。切勿超過 4 秒。
解像度和位元速率 —
1080p @ 60 FPS
解像度：1920x1080
影片位元速率範圍：4,500-9,000 Kbps
1080p @ 30 FPS
解像度：1920x1080
影片位元速率範圍：3,000-6,000 Kbps
720p @ 60 FPS
解像度：1280x720
影片位元速率範圍：2,250-6,000 Kbps
720p @ 30 FPS
解像度：1280x720
影片位元速率範圍：1,500-4,000 Kbps
480p @ 30 FPS
解像度：854x480
影片位元速率範圍：600-2,000 Kbps
360p
解像度：640x360
影片位元速率範圍：400-1,000 Kbps
協定 — RTMPS 串流協定
像素長闊比例 — 理想比例為 16:9；若與此比率差距過大，我們可能無法支援直播
視像轉碼器 —
- H.264，Level 4.1（高達 1080p 30 FPS）
- H.264，Level 4.2（1080p 60 FPS）

音訊設定

音訊轉碼器 — AAC 低複雜度規格
取樣率 — 44.1kHz 或 48kHz
音訊位元速率 — 128 kbps（首選）至 256 kbps（上限）
聲道配置 — 立體聲

端點

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 傳送錯誤訊息，並將之繼續傳送至 Graph API。您可以透過 GET 要求，在 Graph 測試工具中使用直播／影片編號查詢錯誤。傳回的錯誤將包含錯誤代碼、描述和時戳。

error_subcode	錯誤摘要	描述
`COPYRIGHT__LIVE_COPYRIGHT_VIOLATION`	違反直播版權	系統已停止您的直播影片，因為影片可能含有屬於其他專頁的影音內容。
`VIDEO__CREATE_FAILED`	上載問題	上載您的影片時發生問題，因此影片無法上載。請再試一次。
`LIVE_VIDEO__DELETE_FAILED`	直播影片尚未刪除	刪除您的直播影片時發生問題，因此影片無法刪除。請再試一次。
`LIVE_VIDEO__EDIT_API_NOT_ALLOWED`	不允許在直播期間透過影片 API 編輯內容	不允許使用影片編輯 API 編輯直播影片。使用直播影片編號。
`LIVE_VIDEO__LIVE_STREAM_ERROR`	一般串流直播	串流直播期間出現錯誤
`LIVE_VIDEO__NOT_EXIST`	直播影片不存在	您想存取的直播影片不再存在於系統中。
`LIVE_VIDEO__PRIVACY_REQUIRED`	必須設定私隱項目	您必須在直播前設定私隱項目。