新手指南

此文件將講解如何使用直播視像 API，以運用您的應用程式直播視像。如果您還沒有應用程式，則可選擇使用 Graph API 測試工具和串流軟件。

準備工作

如果您有應用程式，便需要：

• Meta 應用程式編號及 Facebook 登入使用案例
• 在應用程式中執行 Facebook 登入

  • 如果您的應用程式在沒有讓用戶登入 Facebook 的介面之裝置上運作，請改為執行裝置專用的 Facebook 登入 。
• 以下權限：publish_video
• 存取憑證

如果您沒有應用程式，則亦需要：

• Graph API 測試工具
• 影片串流軟件

開始直播

若要建立 LiveVideo 物件，請傳送 POST 要求到 /me/live_videos?status=LIVE_NOW 端點，其中 me 是用戶或專頁的編號。

curl -i -X POST \
 "https://graph.facebook.com/v21.0/me/live_videos?status=LIVE_NOW"

傳回的回應將如下所示：

{ 
  "id": "10214937378883406",  //The LiveVideo object ID
  "stream_url": "rtmp://rtmp-api.faceboo...",
  "secure_stream_url": "rtmps://rtmp-api.faceboo...", //The stream URL
  "stream_secondary_urls": [],
  "secure_stream_secondary_urls": []
}

擷取系統向您傳回的 id 及 secure_stream_url 值。id 為 LiveVideo 物件編號，可讓您用來操控直播內容。secure_stream_url 為內嵌網址，可用於將直播視像數據從編碼器串流至 LiveVideo 物件。

串流直播

將您在上一步擷取的 secure_stream_url 值傳遞至您的編碼裝置，並向其串流直播視像數據。一旦 LiveVideo 物件偵測到串流數據，您的用戶個人檔案便會發佈直播內容。

查看您的個人檔案，以確認已建立新的直播視像帖子，而且它正在廣播您的串流數據。

如果您使用串流軟件而非開發自己的應用程式，請將 secure_stream_url 值手動加至您的軟件。視乎您使用的串流軟件，您可能需要將串流網址分拆為其伺服器（rtmps://rtmp-api.facebook.com/rtmp/）及關鍵組成部分（/rtmp/ 之後的所有內容）。

結束直播

若要結束直播，請傳送 POST 要求到 /<LIVE_VIDEO_ID>?end_live_video=true 端點。

結束直播要求範例

curl -i -X POST \
  "https://graph.facebook.com/v21.0/<LIVE_VIDEO_ID>?end_live_video=true"

這個動作將結束您的直播，並將之儲存為點播影片（VOD）。若要刪除 VOD，可傳送要求到 DELETE /<LIVE_VIDEO_ID> 端點。

權限被拒錯誤代碼

後續步驟

• 使用直播視像 API 排定未來直播視像的時間。