總覽

本文件是在 Facebook 上串流直播之直播視訊 API 的總覽。

運作方式

直播視訊是由圖形 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 在直播視訊上建立票選活動，以取得瀏覽者的即時回應。票選活動是由圖形 API 中的 VideoPoll 物件代表，可用 POST /LIVE_VIDEO_ID/polls 端點在 LiveVideo 物件上建立。建立時，API 將傳回 VideoPoll 物件編號，您可使用該編號來操縱票選活動及查詢瀏覽者的互動。

工具

直播視訊撰寫工具

如果您使用無法與直播視訊 API 整合的串流軟體，則您可以使用我們的直播視訊撰寫工具來取得串流影片網址，並手動將網址插入您偏好的串流軟體。直播視訊撰寫工具可讓您在自己的用戶個人檔案，或您管理的粉絲專頁或活動上建立直播。

直播嵌入

要擁有良好的直播視訊播放品質，首先要有可靠的伺服器連線。連線品質不佳，可能導致視訊品質降低、播放中斷和直播失敗。直播嵌入工具可讓您測試嵌入品質，以診斷連線問題、找出最適合您直播的視訊嵌入伺服器，以及提供播放問題最少的高品質直播。

後續步驟

• 瞭解播放直播視訊所需的音訊和視訊規格 。
• 開始使用直播視訊 API 播放直播視訊。