スタートガイド

このドキュメントでは、ライブ動画APIを利用し、アプリを使ったライブ動画配信方法について説明します。まだアプリがない場合は、グラフAPIエクスプローラおよびストリーミングソフトウェアを使用できます。

開始する前に

アプリがある場合は、次のものが必要です。

• FacebookログインのユースケースにおけるMetaアプリID
• アプリにFacebookログインが実装されていること

  • ユーザーがFacebookにサインインできるインターフェイスを備えていないデバイスでアプリを使用する場合は、代わりにデバイス用Facebookログインを実装します。
• 次のアクセス許可:publish_video
• アクセストークン

アプリがない場合は、次のものも必要です。

• グラフAPIエクスプローラ
• 動画ストリーミングソフトウェア

ライブ配信を開始する

LiveVideoオブジェクトを作成するには、/me/live_videos?status=LIVE_NOWエンドポイントにPOSTリクエストを送信します。meはユーザーまたはページのIDです。

curl -i -X POST \
 "https://graph.facebook.com/v25.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オブジェクトIDであり、ライブ配信を操作するために使用できます。secure_stream_urlは取り込みURLであり、エンコーダーからLiveVideoオブジェクトにライブ動画データをストリーミングするために使用できます。

ライブ配信のストリーミング

使用するエンコーディングデバイスに前のステップでキャプチャしたsecure_stream_url値を渡して、ライブ動画データをストリーミングします。LiveVideoオブジェクトがストリーミングデータを検出すれば、ユーザープロフィールでライブ配信が始まります。

自分のプロフィールを表示して、新しいライブ動画投稿が作成されており、ストリーミングデータがライブ配信されていることを確認します。

独自のアプリを開発する代わりにストリーミングソフトウェアを利用している場合は、手動でsecure_stream_url値をそのソフトウェアに追加します。使用しているストリーミングソフトウェアによっては、ストリーミングURLをサーバー(rtmps://rtmp-api.facebook.com/rtmp/)とキーコンポーネント(/rtmp/より後のすべて)に分割しなければならない場合があります。

ライブ配信を終了する

ライブ配信を終了するには、/<LIVE_VIDEO_ID>?end_live_video=trueエンドポイントにPOSTリクエストを送信します。

ライブ配信終了リクエストの例

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

これでライブ配信が終了し、ビデオオンデマンド(VOD)に保存します。VODを削除する場合は、DELETE /<LIVE_VIDEO_ID>エンドポイントにリクエストを送信します。

アクセス許可拒否のエラーコード

次のステップ

• ライブ動画APIを使用して、今後のライブ配信のライブ動画をスケジュール設定します。