一般情報
RTMP 出力を使用するには、次の点に注意してください。
- イベント時間、またはデジタルマーケティングパッケージを購入している必要があります。
- RTMP 出力時間は、イベント時間に対して請求されます
- ライブジョブごとに 5 つの出力に制限されています
- ストリームに対して選択した出力レンディションの 1
labelつをラベルで選択できる場所を定義できます。が設定されていない場合、label出力はデフォルトで入力ソースになります。 - 標準ジョブおよび定期イベント (SEP) で使用できます。
- イベントや24時間年中無休のストリームに使用できます。
- ライブストリームから独立して開始および停止できます。
- 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"
}