ストリームプルとは、メディア処理と高速コンテンツ配信のために、サードパーティのストリーミングURLをApsaraVideo liveのライブセンターにアップロードするプロセスを指します。 ApsaraVideo Liveでは、通常のストリームプルとトリガーされたストリームプルを設定できます。 このトピックでは、ApsaraVideo Liveコンソールでストリームのプルを設定する方法について説明します。
用語
ApsaraVideo Liveは、通常のストリームプルとトリガーされたストリームプルをサポートしています。
通常のストリームプル: ストリームプルの開始時間と終了時間を指定します。 ApsaraVideo Liveは、再生リクエストが送信されたかどうかに関係なく、指定された期間にライブストリームをプルします。
Triggered stream pull: 再生リクエストが送信された場合にのみ、ストリームプルをトリガーします。 つまり、指定されたドメイン名のストリーミングURLがストリーミングに使用されると、ApsaraVideo Liveはライブストリームをプルします。 再生リクエストが送信されない場合、ApsaraVideo Liveはオリジンからライブストリームを取得しません。
H.265形式でエンコードされたサードパーティのライブストリームを取得する場合は、お問い合わせください。
制限事項
通常のストリームプル
Real-Time Messaging Protocol (RTMP) 、Flash Video (FLV) 、HTTP Live Streaming (HLS) 、Secure Reliable Transport (SRT) 形式のサードパーティのソースURLがサポートされています。 最大4つのURLを追加できます。
通常のストリームプル用に最大300個のテンプレートを設定できます。 テンプレートの最大許容数を増やしたい場合は、ソースストリームの数を増やします。 詳細については、「クォータ管理」をご参照ください。 調整後、通常のストリームプルに許可されるテンプレートの最大数は、ソースストリームの数と同じです。
ストリームのプルが開始されてからストリームのプルが終了するまでの期間は、7日を超えることはできません。
SRT上の規則的な流れ引きのためのスイッチは提供されない。 オリジンが提供するストリームがSRT形式であることを確認するだけで済みます。
トリガーストリーム引き
RTMP、FLV、およびHLSプロトコルがサポートされています。
トリガーされたストリームプル用に最大200のテンプレートを設定できます。
SRTを介したストリームプルでは、通常のストリームプルのみがサポートされます。
IPv6アドレスからストリームをプルすることはできません。
[設定] ページに移動
ApsaraVideo Liveコンソールにログインします。
左側のナビゲーションウィンドウで、[ドメイン名] をクリックします。 ドメイン管理 ページが表示されます。
設定したいストリーミングドメインを見つけて、[操作] 列の ドメイン設定 をクリックします。
左側のナビゲーションツリーで、
を選択します。 デフォルトでは、[Triggered Stream Pulling] タブが表示されます。
トリガーされたストリームのプルの設定
トリガーされたストリームフェッチング タブで、追加 をクリックします。
トリガーストリームのプルを設定します。
説明トリガーされたストリームプル用に最大200のテンプレートを設定できます。
次の表に、トリガーされたストリームプルのパラメーターを示します。
パラメーター
説明
ストリーミング URL の AppName
ライブストリームが属するアプリケーションの名前。 このパラメーターは、ストリーミングURLを生成するために使用されます。 このパラメーターの値は、取り込みURLで指定されているアプリケーション名と同じである必要はありません。
ただし、ソース URL の AppNameパラメーターを設定しない場合、このパラメーターの値は、取り込みURLで指定されているアプリケーション名と同じである必要があります。
ドメイン名のすべてのアプリケーションに対してストリームプルを設定する場合は、このパラメーターをali_all_appに設定します。
ソース URL の AppName
back-to-originストリームプル用のアプリケーションの名前。 このパラメーターの値は、取り込みURLで指定されているアプリケーション名と同じである必要があります。
このパラメーターを設定しない場合、ストリーミング URL の AppNameパラメーターの値が使用されます。 この場合、AppName In Streaming URLパラメーターの値は、取り込みURLで指定されているアプリケーション名と同じである必要があります。
ソース URL
サードパーティのライブストリームのURL。 最大4つのURLを追加できます。
Back-to-origin ストリームフェッチングのプロトコル
RTMP、FLV、およびHLS形式がサポートされています。
トランスコーディング
この機能を有効にすると、ソースストリームまたはトランスコードされたストリームを再生すると、オリジンからのストリームプルが自動的にトリガーされます。
この機能を無効にすると、ソースストリームを再生したときにのみ、オリジンからのストリームのプルが自動的にトリガーされます。
OKをクリックします。
通常のストリームプルの設定
通常のストリームフェッチング タブをクリックし、追加 をクリックします。
通常のストリームプルを設定します。
重要最大4つのソースURLを追加できます。
通常のストリームプル用に最大300個のテンプレートを設定できます。 テンプレートの最大許容数を増やしたい場合は、ソースストリームの数を増やします。 詳細については、「クォータ管理」をご参照ください。 調整後、通常のストリームプルに許可されるテンプレートの最大数は、ソースストリームの数と同じです。
ストリームのプルが開始されてからストリームのプルが終了するまでの期間は、7日を超えることはできません。
次の表に、通常のストリームプルのパラメーターを示します。
パラメーター
説明
アプリ名
アプリケーションの名前。 このパラメーターは、ストリーミングURLを生成するために使用されます。 このパラメーターの値は、取り込みURLで指定されているアプリケーション名と同じである必要はありません。
ドメイン名のすべてのアプリケーションに対してストリームプルを設定する場合は、このパラメーターをali_all_appに設定します。
ストリーム名
ライブストリームの名前。テンプレート間で一意でなければなりません。
ソースURL
サードパーティのライブストリームのURL。
RTMP、FLV、およびSRT形式のURLがサポートされています。 最大4つのURLを追加できます。
開始時間 /終了時間
ストリームプルの開始時刻と終了時刻。 終了時間に達すると、ストリームの引き込みが停止します。
OKをクリックします。
ストリームプルの設定を変更する
ストリームプルの設定を変更して、オリジンが使用できない予期しない状況に対処できます。
設定ページで、トリガーされたストリームフェッチング タブまたは 通常のストリームフェッチング タブをクリックして、ストリームのプルの既存の設定を表示します。
変更するテンプレートを見つけて、[操作] 列の [変更] をクリックします。
ストリームフェッチング設定 ダイアログボックスで、ストリームのプル設定を変更します。
パラメーターの詳細については、このトピックの「通常のストリームプルの設定」および「トリガーストリームプルの設定」のセクションをご参照ください。
OK をクリックします。
通常のストリームプル
設定を変更すると、変更された設定に基づいてストリームが再びプルされます。 変更が実行中のビジネスに影響しないことを確認してください。
トリガーストリーム引き
設定を変更すると、既存の再生要求は変更前のオリジン設定に準拠し、新しい再生要求は変更されたオリジン設定に準拠します。
ストリームのプルを構成するときにAppName in Streaming URLパラメーターが指定されている場合、ストリームのプル設定を変更するときにこのパラメーターを空のままにすることはできません。
コールバックロジック
コールバックロジック
Real-Time Messaging Protocol (RTMP) によるストリーム取り込み中、ApsaraVideo Liveは、ApsaraVideo LiveがOnPublishメッセージを受信してから2秒以内にストリーム取り込みクライアントが接続を閉じるかどうかを確認します。 ストリーム取り込みクライアントが接続を閉じない場合、ApsaraVideo Liveはストリーム取り込みの成功に関するコールバック通知を送信します。
互いに関連付けられた取り込みドメインAとストリーミングドメインBがあり、ストリーミングドメインBの通常のストリームプルとトリガーされたストリームプルを設定したとします。ストリームプルのステータスに関するコールバック通知を受信する場合は、取り込みドメインAのストリームインジェストコールバックを設定します。クライアントが2秒以内に接続を閉じない場合、ストリームプルは成功と見なされます。
コールバック通知とDescribeLiveStreamsOnlineList操作の呼び出しに対する応答に基づいて、ストリームの取り込みまたはプルが成功したことを確認した後、ストリーミングURLを発行することを推奨します。