Live API：静的エントリポイント
はじめに
静的エントリポイント (SEP) 機能を使用すると、エントリポイント URL と再生 URL を静的に保ち、再利用可能な状態で、長時間実行されるライブジョブをアクティブ化および非アクティブ化できます。この機能により、お客様は施設または現場でエンコーダを設定し、ライブチャネルまたはプログラム用に独自のスケジューリングロジックを作成できます。
DVRとSEP
DVR 機能は、スタティックエントリポイントで使用できますが、SEP がアクティブになっている間だけ使用できます。
静的エントリポイントの作成
標準の Create Job操作が使用されますが、静的エントリポイントを追加するには、プロパティをジョブリクエストに追加する必要があります。
"static": true
このジョブからの応答する RTMP URL は静的であり、以下のセクションで説明する操作を使用してジョブをアクティブ/非アクティブ化することで再利用できます。このドキュメントの最後に記載されている制限事項を読み、理解してください。
最大待ち時間
SEP ジョブがアクティブになった後、エンコーダが開始されていないと、しばらくすると自動的に非アクティブ化されます。ルールは次のとおりです。
event_length値が 30 分を超える場合、ジョブはデフォルトで自動的に 30 分で終了します。待機時間を変更する場合は、サポートに連絡する必要があります。自動非アクティブ化を無効にすることはできません。event_length値がより小さい場合reconnect_time、ジョブはに設定された時間内に終了します。event_length。
SEP ライブストリームをアクティベート
静的エントリポイントのライブストリームを有効にするには、次のリクエストを Live API に送信します。
| 方法 | PUT |
|---|---|
| 終点 |
|
リクエスト本文は必要ありません。
SEP ライブストリームを無効にする
静的エントリポイントのライブストリームを無効にするには、次のリクエストを Live API に送信します。
| 方法 | PUT |
|---|---|
| 終点 |
|
リクエスト本文は必要ありません。
SEP ジョブをキャンセルする
静的エントリポイントジョブを永久に停止するには、PUTエンドポイントにリクエストを送信することで、ライブジョブと同様にジョブをキャンセルできます/jobs/{job_id}/cancel。詳細については、 APIリファレンスを参照してください。
制限事項
- VOD へのライブは、完了時にストリームをアーカイブするように設定することはできません。
選択肢:
- ジョブ設定は変更できません。これらの設定は、現在、最初に SEP を作成した設定に関連付けられています。
- ストリームのアクティブ化には、エントリポイントが使用可能になるまでに最大 60 秒かかります。
ベストプラクティス：
ジョブの状態の変更に関するライブプラットフォームからの通知を実装して、SEP ジョブが実際に準備できたときのリアルタイムの更新を取得します。
選択肢:
- エンコーダを起動する最低 60 秒前にストリームをアクティブにします。
- エンコーダに組み込みの再試行（Wirecast、Elemental など）がある場合は、ストリームを直ちに接続でき（エラーが発生する場合もあります）、エントリポイントが使用可能になるとすぐにエンコーダが再接続されます。
- reconnect_Time は、エンコーダの切断時の SEP ジョブにも適用されます。再接続時間に達すると、SEP ジョブは非アクティブ状態に戻ります。
ベストプラクティス：
ジョブが完了したら常に API 経由でストリームを無効にし、切断時に再接続時間を待機できる時間に設定します（入力時間のコストはこの待機期間中に発生します）。
- 各アカウントには、3つの利用可能なSEPジョブのみが割り当てられます 地域ごと。上限に達した場合、新しい SEP ジョブを作成する前に、いずれかの SEP ジョブをキャンセルする必要があります。
SEP ジョブの最大数に達して、別の SEP ジョブを作成しようとすると、次のエラーが返されます。
{ "error": "You've reached the number of static entry points jobs you can create for your account" } - 同時に 5 つ以上の SEP ジョブをアクティブ化しようとすると、次のようなエラーが表示されます。
{ “message”:“Allocating additional streaming capacity to the region. Please retry your request.: no_streaming_capacity_in_region”, “statusCode”:500, “name”:“ApiError”, “isApiError”:true }リクエストを再試行する前に、一部のジョブのアクティブ化が完了するまで待つ必要があります。
備考
- 非アクティブ化後の SEP ジョブのクリッピング
- ユーザーは、ストリームの次のアクティブ化まで、または 7 日間のうち短い方のクリップを作成できます。ストリームが再びアクティブになると、以前の録画セッションはサーバーから削除され、クリップできなくなります。
- SEP が使用されたときの stream_start_time フィールドのタイミングは何ですか？
- SEP がアクティブになると、開始時刻と見なされます。