録画設定が完了したら、オンデマンドでの録画を有効にするかどうかを選択することができます。

オンデマンド録画の設定は下記のとおりです。

  • アップストリーミングパラメーター設定 (現在サポートされていません)

  • HTTP コールバック方式

    HTTP コールバック方式を使用する場合、コールバック URL を指定し、ドメイン、アプリケーション、またはストリームレベルでのオンデマンド録画を設定する必要があります。 指定されたドメイン、アプリケーション、またはストリーム名に一致するストリームを受信すると、録画サービスは 5 つのパラメーターを持つリクエストを指定されたコールバック URL に送信し、このストリームを録画するかどうかを尋ねます。 詳細は、「HTTP コールバック」をご参照ください。

パラメータのリクエスト

名前 タイプ 説明
domain String ドメイン名。
app String ライブストリーミングアプリケーションの名前。
stream String ライブストリームの名前。
codec String ファイルのエンコード方法。
  • 有効な値：h264 および h265。
  • このパラメーターを指定しない場合、デフォルトで h264 になります。
vbitrate String ビデオのビットレート。
  • 単位：Kbit/s
  • たとえば、値 2000 は、ビットレートが 2 Mbit/s であることを示しています。

レスポンスのパラメータ

名前 データ型 必須/省略可能 説明
ApiVersion String 任意

API のバージョン。

デフォルト値：V1.0。
NeedRecord Boolean 必須 ストリームを録画する必要があるかどうかを示します。
Interval JSON Object 任意 各録画形式の録画時間。
  • 有効な値：5〜21600。
  • (単位：秒)
Format Array 任意 録画形式：.mp4、.flv、または .m3u8。

コーディング例

リクエスト例
GET /? app=seq_all&domain=qt01.alivecdn.com&stream=ondemand8&vbitrate=2000&codec=h264 HTTP/1.1
Host: live.abc.com
User-Agent: Go-http-client/1.1
Accept-Encoding: gzip
レスポンスパラメーター
{
    "ApiVersion": "1.0",
    "NeedRecord": true,
    "interval": {
        "Mp4": 300,
        "Flv": 120,
        "M3U8": 180
    },
    "Format" : ["mp4","flv"]
}

レスポンスパラメーター処理

録画サービスは、既存のパラメーターをレスポンスパラメーターで上書きします。 たとえば、Interval の値を明示的に指定した場合、録画サービスはそれを使用して、データベースの録画設定の Interval の値を上書きします。 録画サービスは、指定された形式とデータベースに記録されている形式の共通部分から、適用可能な録画形式を決定します。 Format で指定された形式がデータベースの既存の録画設定に存在しない場合、ライブストリームは録画されません。
注

  • 200 以外の HTTP ステータスコードを受け取った場合、ユーザーの API の呼び出しのエラーとみなされます。

  • HTTP ボディの最大長は、2,048 バイトです。 ボディの長さが 2,048 バイトを超える場合、悪意のある攻撃を避けるために HTTP ボディは切り捨てられます。