録画設定が完了したら、オンデマンドでの録画を有効にするかどうかを選択することができます。
オンデマンド録画の設定は下記のとおりです。
-
アップストリーミングパラメーター設定 (現在サポートされていません)
-
HTTP コールバック方式
HTTP コールバック方式を使用する場合、コールバック URL を指定し、ドメイン、アプリケーション、またはストリームレベルでのオンデマンド録画を設定する必要があります。 指定されたドメイン、アプリケーション、またはストリーム名に一致するストリームを受信すると、録画サービスは 5 つのパラメーターを持つリクエストを指定されたコールバック URL に送信し、このストリームを録画するかどうかを尋ねます。 詳細は、「HTTP コールバック」をご参照ください。
パラメータのリクエスト
名前 | タイプ | 説明 |
---|---|---|
domain | String | ドメイン名。 |
app | String | ライブストリーミングアプリケーションの名前。 |
stream | String | ライブストリームの名前。 |
codec | String | ファイルのエンコード方法。
|
vbitrate | String | ビデオのビットレート。
|
レスポンスのパラメータ
名前 | データ型 | 必須/省略可能 | 説明 |
---|---|---|---|
ApiVersion | String | 任意 |
API のバージョン。 デフォルト値:V1.0。 |
NeedRecord | Boolean | 必須 | ストリームを録画する必要があるかどうかを示します。 |
Interval | JSON Object | 任意 | 各録画形式の録画時間。
|
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 ボディは切り捨てられます。