概要
このチュートリアルでは、「Brightcove live」でライブストリーミングジョブを作成し、「RTMP」出力を作成してYouTubeLiveとFacebookLiveに再ストリーミングする方法をAPIレベルで説明します。
このチュートリアルではカール APIリクエストを作成しますが、簡単に作成できます不眠症、郵便配達員または代わりに他のRESTクライアント。
ライブジョブを作成する
まず、ライブジョブを作成します。Live API API-KEY
にはが必要です。アクセスできない場合は、アカウントマネージャーにお問い合わせください。
-
以下をコピーして貼り付けますカールテキストエディタへのコマンド:
curl -X POST \ https://api.bcovlive.io/v1/jobs \ -H 'Content-Type: application/json' \ -H 'x-api-key: ' \ -d '{ "live_stream": true, "region": "", "outputs": [{ "label": "hls360p", "live_stream": true, "height": 360, "video_bitrate": 365, "segment_seconds": 6, "keyframe_interval": 60 }, { "label": "hls432p", "live_stream": true, "height": 432, "video_bitrate": 730, "segment_seconds": 6, "keyframe_interval": 60 }, { "label": "hls540p", "live_stream": true, "height": 540, "video_bitrate": 2000, "segment_seconds": 6, "keyframe_interval": 60 }, { "label": "hls720p3M", "live_stream": true, "height": 540, "video_bitrate": 2000, "segment_seconds": 6, "keyframe_interval": 60 }, { "label": "hls720p4.5M", "live_stream": true, "height": 540, "video_bitrate": 4500, "segment_seconds": 6, "keyframe_interval": 60 }] }'
-
置換:
をエンコーダに最も近い利用可能なリージョンとすると、エンコーダに最も近い利用可能なリージョンが表示されます。例えば:
us-west-2
をBrightcoveのLive API キーで使ってください。例:
abcdfeg-this-is-a-fake-api-key-FgJajjasd12hJHsZ
- これらの変更を行ったら、ターミナルまたは使用するコマンドラインアプリにコードをコピーして貼り付けて実行します。
-
応答は次のようなものでなければなりません:
{ "id": "3b6871bf2f344acaa6b397d09b476018", "outputs": [... removed for simplicity ...], "stream_url": "rtmp://ep1-usw2.bcovlive.io:1935/3b6871bf2f344acaa6b397d09b476018", "stream_name": "alive", "static": false, "encryption": {}, "playback_url": "https://bcovlive-a.akamaihd.net/3b6871bf2f344acaa6b397d09b476018/us-west-2/NA/playlist.m3u8", "playback_url_dvr": "https://bcovlive-a.akamaihd.net/3b6871bf2f344acaa6b397d09b476018/us-west-2/NA/playlist_dvr.m3u8" }
このジョブは5つのレンディションを作成しますベースオンAppleの推奨事項。
エンコーダーを設定する
ここで示す手順は、このチュートリアルの手順をテストするために使用された Elemental ライブボックスエンコーダを想定しています。別のエンコーダを使用している場合は、設定が似ているはずです。
この場合の最も重要な設定は次のとおりです。
- タイムコードソースを「システムクロック」として設定
- 「OnFi タイムコード周波数」を 1 に設定します
- ビデオ内の「タイムコード挿入」を確認する
- 強く推奨:フレームレート = ソースに従う
これは、この実験で使用した設定です:
テスト再生
この VideoJS HLS デモページを使用して再生をテストできます。playback_url
返された値を作成ジョブの応答に貼り付けるだけです。
ライブストリームを YouTube ライブに追加する
ここでは、ライブストリーミングを有効にした YouTube アカウントを持っていることを前提としています。
-
[ ライブに移動 ] をクリックすると、次の項目が表示されます。
-
「エンコーダライブストリーミング」をクリックします:
-
ライブイベントの YouTube メタデータを設定し、「エンコーダー設定」データを使用して、Brightcoveのライブストリームを YouTube に接続します。
-
YouTube ライブをセットアップしたので、ライブジョブから RTMP 出力を作成します。
-
をコピーしますカール以下のコマンドをテキストエディタに入力します。
curl -X POST \ https://api.bcovlive.io/v1/jobs//rtmpouts \ -H 'Content-Type: application/json' \ -H 'x-api-key: ' \ -d '{ "url": "rtmp://a.rtmp.youtube.com/live2/" }'
-
置換:
をBrightcoveのライブジョブ ID で登録してください。この例では、この値はになります
3b6871bf2f344acaa6b397d09b476018
。ライブジョブの作成リクエストに対する応答から、値は異なります。BrightcoveライブAPIキー用。例えば:
abcdfeg-this-is-a-fake-api-key-FgJajjasd12hJHsZ
YouTubeが提供するストリーム名/キー
- 編集したコードをコマンドラインアプリに貼り付けて実行します。
-
応答は次のようなものでなければなりません:
{ "connection_info": { "host": "a.rtmp.youtube.com", "port": 1935, "application": "live2", "streamName": "" }, "duration_history": [], "rtmp_out_id": "27aacdfa5bcf4436ade0519e6a748aba", "stream_start": 1542902218238 }
-
YouTubeの再生をテストするには、 YouTubeに行くことができますマイチャンネル :
ライブストリームを Facebook ライブに追加する
ここでは、ライブストリーミングが有効になっているFacebookアカウントを持っていると仮定しています。
-
ライブビデオをクリックします
-
[ 接続してストリームキー ] をクリックして、Brightcoveのライブジョブを接続するために必要なデータを取得します。
-
次に、Facebook の「サーバー URL」と「ストリームキー」を使用して、Brightcoveのライブジョブのライブ出力を作成します。をコピーしますカール以下のコマンドを実行して、テキストエディタに貼り付けます。
curl -X POST \ https://api.bcovlive.io/v1/jobs//rtmpouts \ -H 'Content-Type: application/json' \ -H 'x-api-key: ' \ -d '{ "url": "rtmp://live-api-s.facebook.com:80/rtmp/" }'
-
置換:
をBrightcoveのライブジョブ ID で登録してください。この例では、この値はになります
3b6871bf2f344acaa6b397d09b476018
。ライブジョブの作成リクエストに対する応答から、値は異なります。をBrightcoveのLive API キーで使ってください。例えば:
abcdfeg-this-is-a-fake-api-key-FgJajjasd12hJHsZ
Facebookがあなたに与えるストリーム名をあなたと一緒に
-
応答は次のようなものでなければなりません:
{ "connection_info": { "host": "live-api-s.facebook.com", "port": 80, "application": "rtmp", "streamName": "" }, "duration_history": [], "rtmp_out_id": "59323c3d1e2b44748755853193fb126c", "stream_start": 1542904101097 }
-
Facebook ライブストリームをテストするには、Facebook ウェブページの [ライブ開始] をクリックします。