開始使用

本文件說明如何使用直播影片 API，用您的應用程式播放直播影片。如果您還沒有應用程式，可以使用圖形 API 測試工具和您選擇的串流軟體。

準備工作

如果您有應用程式，則需要下列項目：

• 具備「Facebook 登入」使用案例的 Meta 應用程式編號
• 在應用程式中實作的「Facebook 登入」

  • 如果您的應用程式位在沒有介面可讓用戶登入 Facebook 的裝置上，請改為實作裝置專用的「Facebook 登入」。
• 下列權限：publish_video
• 存取權杖

如果您沒有應用程式，則另外還需要：

• 圖形 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 為後續的直播排程直播影片。