這份文件已更新。
中文(台灣) 的翻譯尚未完成。
英文更新時間:2021年11月15日

參考資料

建議的設定

為了確保直播順利,直播影片必須:

  • 同時包含音訊和影片資料
  • 長度不得超過 8 小時
  • 使用以下指定的建議設定(例如:必須為 H264/AAC)
  • 不可在直播期間變更設定

若無法符合以上限制,可能導致:

  • 串流影片意外終止
  • 觀賞者看到的影片品質低落
  • 未預期的行為

影片設定

  • 主要畫面格大小:建議 2 秒。請勿超過 4 秒。
  • 解析度和位元速率:

    1080p @ 60 FPS
    解析度:1920x1080
    視訊位元速率範圍:4,500-9,000 Kbps

    1080p @ 30FPS
    解析度: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;如果與此比例的差距過大,我們可能無法支援您的串流
  • 影片轉碼器
    • 1080p 30 FPS:H.264、Level 4.1
    • 1080p 60 FPS:H.264、Level 4.2

音訊設定

  • 音訊轉碼器:AAC 低複雜度
  • 取樣速率:44.1kHz 或 48kHz
  • 音訊位元速率:128 kbps(偏好)至 256 kbps(不超過)
  • 聲道配置:立體聲

端點

LiveVideo

LiveVideoInputStream

票選活動

端點說明

GET /{live-video-id}/polls

取得 LiveVideoVideoPoll 集合。

GET /{video-poll-id}

取得 VideoPoll 的欄位和關係連線。

POST /{live_video_id}/polls

LiveVideo 建立 VideoPoll

POST /{video_poll_id}

更新 VideoPoll 的欄位。

錯誤代碼

錯誤訊息將透過 RTMP 傳送,然後將持續到圖形 API。您可用直播/影片編號透過 GET 要求在圖形測試工具中查詢錯誤。傳回的錯誤將包含錯誤代碼、說明和時間戳記。

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

需要隱私設定

您需要先設定隱私,才能進行直播。