システムは、ライブ録画ストリームの新しいステータスをコールバックし、録画完了後に関連する結果と録画ステータスをユーザーに通知します。
注意事項
システムは HTTP / HTTPS URL 設定をサポートしています。 POST リクエストは、ユーザーのサーバーに送信されます。 メッセージ本体は、JSON 形式です。 録画の結果とステータス情報に関するリアルタイムフィードバックが、戻されます。 ユーザーのサーバーは、200 のレスポンスの形式でインターフェイスに結果を返します。 URL を同定する必要はありませんが、適切にアクセスしなければなりません。 アクセスが時間切れになった場合、5 回まで再試行することができます。 再試行の間隔は、100 ミリ秒から 10 秒の間のランダムな値です。
手順
ApsaraVideo Live コンソールで録音コールバック URL を設定できます。
- ApsaraVideo Live コンソールにログインします。
- [ドメイン名] をクリックしてください。
- ストリーム再生ドメイン名を選択して、 [テンプレートセット] をクリックします。
- 左側のナビゲーションウィンドウで、 [録画設定] をクリックします。
- コールバック URL の右側の [追加] をクリックします。
- コールバック設定に、 コールバック URL を入力します。
注 セキュリティ上の理由から、イントラネット URL をコールバックすることはできません。 コールバック URL は有効なインターネット URL である必要があります。
例
ユーザーコールバックアドレスは、 http:// 1.1.1.1/notify/record
で、返される本文の内容は次のとおりです。
ファイル生成イベントコールバックの例
{
"domain": "live.aliyunlive.com",
"app": "live",
"stream": "hello",
"uri": "live/hello/0_2017-03-08-23:09:46_2017-03-08-23:10:40.flv",
"duration": 69.403,
"start_time": 1488985786,
"stop_time": 1488985840
}
ここで、 "domain"、"app"、"stream" は、それぞれ録画のドメイン名、アプリケーション名、ストリーム名です。"uri" は、録画 OSS バケット内のターゲット録画ファイルのパスです。"duration"、"start_time"、"stop_time" は、それぞれターゲット録画ファイルの録画期間、開始時間、終了時間です。
-
録画開始イベントのコールバック (録画が正常に開始されたことを示します)
{ "Domain": "maid ", "app": "live", "stream": "hello", "event": "record_started" }
ここで、"domain"、"app" および "stream"は、それぞれ記録ドメイン名、アプリケーション名およびストリーム名です。 "event" はイベント名で、record_started / record_paused / record_resumed になります。
-
録画一時停止イベントのコールバック (録画が正常に一時停止されたことを示します)
{ "domain": "live.aliyunlive.com", "app": "gs_app", "stream": "gs_stream", "event": "record_paused" }
-
録画エラーのコールバック (録画中にエラーが発生したことを示します)
{ "domain": "gs_domain", "app": "gs_app", "stream": "gs_stream", "event": "record_error" }