一般情報
RTMP 出力を使用するには、次の点に注意してください。
- イベント時間またはデジタルマーケティングパッケージを購入している必要があります
- RTMP 出力時間は、イベント時間に対して請求されます
- ライブジョブごとに 5 つの出力に制限されています
- ストリーム用に選択した出力レンディションの 1
labelつをラベルで選択できる場所を定義できます。labelが設定されていない場合、出力はデフォルトで入力ソースになります。 - 標準ジョブおよび定期イベント (SEP) で使用できます。
- イベントや24時間365日のストリームに使用できます。
- ライブストリームから独立して開始および停止できます。
- RTMP 出力機能が実装される前に作成された SEP ジョブの場合、この機能は完全には機能しません。API では、RTMP 出力が実際に作成された場合でも、失敗が表示されます。最良の結果を得るには、RTMP 出力機能を使用する新しい SEP ジョブを作成します。
- 標準ジョブ（SEP 以外）で RTMP 出力を使用する場合、ジョブが終了すると RTMP 出力ストリームは終了します。
- RTMP出力NSサポート
rtmpsURL、およびソーシャルメディアプラットフォームがそれらをサポートしている場合は、それらを使用することをお勧めします。また、2019年5月1日現在、FacebookはRTMPSのみを許可することに注意してください。 - RTMP URL で現在サポートされている形式は、のみです
rtmps://host:port/application/streamName。
通知
rtmp_output_state_changedイベントの通知を設定できます。次の状態について通知が送信されます。
| RTMP 出力状態 | ( rtmp_output_state_changed通知についてはとして報告state ) |
|---|---|
starting |
ストリームが開始しています。 |
connected |
エンコーダが接続されました。 |
Disconnected |
エンコーダが切断されました。 |
error |
ストリームの接続に失敗しました。 |
pending_deactivation |
エントリポイントは、ストリーミングワーカーからのクリーンアップのためにキューに入れられました。 |
deactivation_in_progress |
エントリポイントがストリーミングワーカーから切断されています。 |
cancelled |
エントリポイントはキャンセルされました。 |
finished |
エントリポイントは正常に完了しました。 |
RTMP 出力の通知は、ライブジョブの作成時にジョブレベルで設定する必要があります。
RTMP state出力について報告されるさまざまな値を表示するには、ライブ通知を参照してください。
RTMP 出力の作成
最初に、通常どおりライブジョブを作成し、次に RTMP エンドポイントを作成するために追加のリクエストを行う必要があります。
注:ジョブの有効化/無効化などの特定の状況下では、この API 呼び出しがエラーを返す可能性があります。その場合、一時停止後に再試行してください。
終点
https://api.bcovlive.io/v1/jobs/{jobId}/rtmpouts
方法
POST
リクエスト本文
{
"url": "rtmps://host:port/application/streamName",
"output_label": "480p"
}
| フィールド名 | 必須 | タイプ | 説明 |
|---|---|---|---|
url |
はい | 文字列 | RTMP 出力の URL-例rtmp://live-api-s.facebook.com:80/rtmp/my_stream |
output_label |
いいえ | 文字列 | RTMP 出力のソースとして使用するジョブ出力のラベル。RTMP 入力を代わりに使用する場合は、このパラメータを省略します。 |
レスポンスの例
{
"host": "live-api-s.facebook.com",
"port": 80,
"application": "rtmp",
"streamName": "my_stream",
"rtmp_out_id": "asdfg-lkjh"
}
RTMP 出力を取得する
終点
https://api.bcovlive.io/v1/jobs/{jobId}/rtmpouts
方法
GET
レスポンスの例
[
{
"rtmp_out_id": "asdfg-lkjh",
"stream_start": 1538746255247,
"connection_info": {
"host": "a.rtmp.youtube.com",
"port": 1935,
"application": "live2",
"streamName": "my_stream",
"sessionStatus": "Active"
}
}
]
RTMP 出力を停止する
終点
https://api.bcovlive.io/v1/jobs/{jobId}/rtmpouts/{rtmp_out_id}/stop
方法
PUT
レスポンスの例
{
"message": "RTMP out asdfg-lkjh deleted successfully"
}