概覽

在 Graph API 中，直播視像由 LiveVideo 物件表示。如要進行直播視像，您首先需使用 API 在用戶、專頁、群組或活動上建立 LiveVideo 物件。建立完成後，API 將傳回 LiveVideo 物件編號和提取串流網址。然後，您可以使用此串流網址將直播視像資料從編碼器串流至 LiveVideo 物件，並使用此物件操控直播視像的能見度。

元件

直播

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

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

您可以使用用戶、專頁、群組或活動物件的 /live_videos 關係連線，在這些物件上建立直播。

串流影片網址

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

提取通訊協定

直播視像 API 支援 RTMPS 協定。

RTMPS

若是串流至提取串流影片網址的資料，則必須使用 RTMPS 資料傳輸通訊協定。建立 LiveVideo 物件時，API 將傳回一個 RTMPS 安全串流影片網址，以便您在串流至我們的伺服器時使用。

以下列出支援 RTMPS 的軟件和硬件供應商例子：

投票活動

您可以使用 API 為直播視像建立投票活動，以收集觀眾的即時反應。在 Graph API 中，投票活動由 VideoPoll 物件表示，並可由 POST /{live-video-id}/polls 端點基於 LiveVideo 物件建立。建立完成後，API 將傳回 VideoPoll 物件編號，您可以用來操控投票活動和查詢觀眾互動情況。

工具

直播視像編輯器

如果您使用的串流軟件沒有整合至直播視像 API，則可使用我們的直播視像編輯器工具以獲取串流影片網址，並將之手動插至您想用的串流軟件（如 OBS、XSplit 等）中。透過直播視像編輯器，您可以在自己的用戶個人檔案，或者您管理的專頁、群組或活動上建立直播。

直播提取

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

影片規格

請參閱我們的參考資料，以查看音訊和影片規格的完整清單。