ApsaraVideo Live:ライブストリーム録音のコールバック

コールバック設定方法

サンプルコールバック

JSON形式のコールバックコンテンツは、HTTP POSTリクエストのリクエストボディに含まれ、コールバックURLに送信されます。 コールバックURLは、ライブストリーミング録画のコールバックの設定でNotifyUrlパラメーターによって指定されます。 受信機は、要求本文を解析し、コールバック内容を取得することができます。

• 記録ステータスのコールバック

  説明

  APIを呼び出して、記録ステータスのコールバックを設定できます。 NeedStatusNotifyパラメーターがtrueに設定されている場合、コールバックコンテンツを生成できます。

  NeedStatusNotifyパラメーターは、AddLiveRecordNotifyConfig操作のリクエストパラメーターです。 記録ステータスのコールバックを有効にするかどうかを指定します。

  表 1. Parameters

  パラメーター	説明
  domain	ストリーミングドメイン。
  app	アプリケーションの名前。
  stream	ライブストリームの名前。
  event	イベント名。 設定可能な値は以下のとおりです。 record_started: 録画が開始されました。 record_paused: 録画が一時停止されます。 record_resumed: 記録が再開されました。

  記録開始のサンプルコールバック:

  {
  "domain": "gs_domain",
  "app": "gs_app",
  "stream": "gs_stream",
  "event": "record_started"
  }
                      

• 録音生成コールバック

  表 2. Parameters

  パラメーター	説明
  domain	ストリーミングドメイン。
  app	アプリケーションの名前。
  stream	ライブストリームの名前。
  ウリ	指定されたObject storage Service (OSS) バケット内の記録のストレージパス。
  期間	録音の期間。 (単位：秒)
  start_time	録音の開始時間。 時刻は UNIX のタイムスタンプです。 (単位：秒)
  stop_time	録音の終了時間。 時刻は UNIX のタイムスタンプです。 (単位：秒)
  push_args	callback_の前にcallback_が付いているストリーム取り込みパラメーター (callback_arg1やcallback_myidなど) 。

  説明

  • サンプルコールバックは、カスタムコールバックテンプレートがない場合に適用されます。

  • 各パラメータは1つの値のみをサポートします。 パラメーターに複数の値を渡す場合、コールバックはパラメーターに渡された最初の値のみを返します。 たとえば、value1とvalue2をcallback_args1パラメーターに渡すと、コールバックは "callback_args1": "value1" のみを返します。

  録音の生成のためのサンプルコールバック:

  {
    "domain": "demo.aliyundoc.com",
    "app": "liveApp****",
    "stream": "liveStream****",
    "uri": "liveApp****/liveStream****/0_2017-03-08-23:09:46_2017-03-08-23:10:40.flv",
    "duration": 69.403,
    "start_time": 1488985786,
    "stop_time": 1488985840,
    "push_args": {
      "callback_args1": "value1",
      "callback_myid": "1231389741"
    }
  }

関連ドキュメント

詳細については、「コールバックの管理」をご参照ください。