システムは、ライブ録画ストリームの新しいステータスをコールバックし、録画完了後に関連する結果と録画ステータスをユーザーに通知します。

注意事項

システムは HTTP / HTTPS URL 設定をサポートしています。 POST リクエストは、ユーザーのサーバーに送信されます。 メッセージ本体は、JSON 形式です。 録画の結果とステータス情報に関するリアルタイムフィードバックが、戻されます。 ユーザーのサーバーは、200 のレスポンスの形式でインターフェイスに結果を返します。 URL を同定する必要はありませんが、適切にアクセスしなければなりません。 アクセスが時間切れになった場合、5 回まで再試行することができます。 再試行の間隔は、100 ミリ秒から 10 秒の間のランダムな値です。

手順

ApsaraVideo Live コンソールで録音コールバック URL を設定できます。

  1. ApsaraVideo Live コンソールにログインします。
  2. [ドメイン名] をクリックしてください。
  3. ストリーム再生ドメイン名を選択して、 [テンプレートセット] をクリックします。
  4. 左側のナビゲーションウィンドウで、 [録画設定] をクリックします。
  5. コールバック URL の右側の [追加] をクリックします。
  6. コールバック設定に、 コールバック 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" は、それぞれターゲット録画ファイルの録画期間、開始時間、終了時間です。

録画ステータスコールバックの例 (NeedStatusNotify = true のときに生成します)
  • 録画開始イベントのコールバック (録画が正常に開始されたことを示します)
    {
    "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"
    
    }