概覽

本文件概述用於在 Facebook 串流直播的直播視像 API。

Meta 由 2024 年 6 月 10 日起推出一些新的必要條件，帳戶必須達到有關條件，才能在 Facebook 上開始直播。新的必要條件如下：

有關 Facebook 帳戶必須已建立至少 60 天。
有關 Facebook 專頁或專業模式個人檔案必須有至少 100 名追蹤者。

運作方式

在 Graph API 中，直播視像由 LiveVideo 物件表示。如要進行直播視像，請先以 API 建立用戶、專頁或活動的 LiveVideo 物件。建立好之後，API 將傳回 LiveVideo 物件編號和提取串流網址。然後，您可以使用此串流網址將直播視像資料從編碼器串流至 LiveVideo 物件，並使用此物件操控哪些人可觀看直播視像。

組件

直播

直播視像由 LiveVideo 物件表示。您可以操控 LiveVideo 物件的屬性，從而控制直播視像。例如，您可更改直播視像的能見度、更新其描述或標題、加入標籤、界定分享對象、加入投票活動，或執行許多其他動作。

LiveVideo 物件與 LiveVideoInputStream 物件相關，後者表示直播的提取串流資料。LiveVideoInputStream 物件由系統自動為您建立和管理。

您可以使用用戶、專頁或活動物件的 /live_videos 關係連線，為有關物件建立直播。

串流網址

串流網址為提取網址，可用於將直播視像資料從編碼器串流至 LiveVideo 物件。當您以 API 建立 LiveVideo 物件時，API 的回應將包含 LiveVideo 物件編號和不重複的串流網址。此串流網址將在 24 小時後過期，必須在此期限前使用。一經使用，串流網址將可持續串流長達 8 小時。

RTMPS

視像直播必須使用 RTMPS 資料傳輸協議進行加密。開始直播後，API 會傳回 RTMPS 安全串流網址，您在將直播資料串流至我們的伺服器時必須使用此網址。

投票活動

您可以使用 API 為直播視像建立投票活動，以收集觀眾的即時回覆。在 Graph API 中，投票活動由 VideoPoll 物件表示，並可透過 POST /LIVE_VIDEO_ID/polls 端點基於 LiveVideo 物件建立。一經建立，API 將傳回 VideoPoll 物件編號，以便您用來操控投票活動和查詢觀眾互動情況。

工具

直播視像編輯器

如果您使用的串流軟件沒有整合至直播視像 API，則可使用我們的直播視像編輯器工具以獲取串流網址，並將之手動插入您想用的串流軟件當中。借助直播視像編輯器，您可以在自己的用戶個人檔案，或者您管理的專頁或活動上建立直播。

直播視像編輯器

直播提取

要確保您的直播視像品質良好，首先要與我們的伺服器維持可靠連線。連線如果不穩定，則可能會導致影片品質欠佳、播放中斷和直播失敗。有了直播提取工具，您便可以測試提取品質，從而診斷連線問題、找出直播的最佳影片提取伺服器，並提供較少播放問題的優質直播。

直播提取

後續步驟

了解進行直播視像所需的音訊和影片規格。
開始使用直播視像 API 進行直播視像。