總覽

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

工具

直播視訊撰寫工具

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

直播嵌入

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

視訊規格

如需完整的音訊和視訊規格清單，請參閱我們的參考資料。