指定した時間範囲の録音用のM3U8インデックスファイルを作成します。
使用状況ノート
ApsaraVideo Liveを使用すると、ライブストリームをM3U8形式で録画し、M3U8ファイルとそのメディアセグメントファイルをObject Storage Service (OSS) バケットに保存し、保存したメディアセグメントファイルをリアルタイムで編集できます。
- インデックスファイルは、ライブストリームが取り込まれた後にのみ作成できます。 指定された時間範囲でビデオがストリーミングされない場合、または指定されたライブストリーム名が無効な場合、インデックスファイルは作成されません。
- StartTimeパラメーターとEndTimeパラメーターで指定される時間範囲は、少なくとも1つのメディアセグメントファイルの期間である必要があります。 1つのメディアセグメントファイルのデフォルトの期間は30秒です。
- ApsaraVideo Liveは、メディアセグメントファイルに関する情報を3か月間のみ保存します。 M3U8インデックスファイルは、過去3か月の録画に対してのみ作成できます。
- OSSは、ストレージ設定で指定された期間、メディアセグメントファイルを保存します。
- ApsaraVideo Liveは、M3U8インデックスファイルに関する情報を6か月間のみ保存します。 クエリできるのは、過去6か月間に作成されたM3U8インデックスファイルに関する情報だけです。
- OSSは、ストレージ設定で指定された期間、M3U8インデックスファイルを保存します。
QPS制限
1人のユーザーが1秒あたり最大45件のクエリ (QPS) を実行できます。 1秒あたりの呼び出し数がQPS制限を超えると、スロットリングがトリガーされます。 スロットルはビジネスに影響を与える可能性があります。 したがって、この操作のQPS制限を遵守することをお勧めします。 シングルユーザーの意味とQPSの詳細については、「ApsaraVideo LiveのAPI操作のQPS制限」をご参照ください。
デバッグ
リクエストパラメーター
パラメーター | データ型 | 必須/任意 | 例 | 説明 |
---|---|---|---|---|
操作 | String | 必須 | CreateLiveStreamRecordIndexFiles |
実行したい操作。 値をCreateLiveStreamRecordIndexFilesに設定します。 |
AppName | String | 必須 | liveApp **** |
ライブストリームが属するアプリケーションの名前。 |
DomainName | String | 必須 | example.com |
メインのストリーミングドメイン。 |
EndTime | String | 必須 | 2017-12-22T08:00:00Z |
M3U8インデックスファイルが作成される記録の終わり。 ISO 8601標準のyyyy-MM-dd T HH:mm:ss Z形式で時刻を指定します。 時刻はUTCである必要があります。 |
OssBucket | String | 必須 | liveBucket **** |
M3U8インデックスファイルが保存されているOSSバケットの名前。 |
OssEndpoint | String | 必須 | oss-cn-developer.aliyundoc.com |
OSSのエンドポイント。 |
OssObject | String | 必須 | {AppName}/{StreamName}/{Date}/{Hour}/{Minute }_{ Second}.m3u8 |
OSSに保存されているレコードの名前。 |
StartTime | String | 必須 | 2017-12-21T08:00:00Z |
M3U8インデックスファイルが作成される録音の先頭。 ISO 8601標準のyyyy-MM-dd T HH:mm:ss Z形式で時刻を指定します。 時刻はUTCである必要があります。 |
StreamName | String | 必須 | liveStream **** |
ライブストリームの名前。 |
レスポンスパラメーター
パラメーター | データ型 | 例 | 説明 |
---|---|---|---|
RecordInfo | Struct |
レコーディングの設定。 |
|
RecordUrl | String | http:// *****/atestObject.m3u8 |
M3U8インデックスファイルのURL。 |
DomainName | String | example.com |
メインのストリーミングドメイン。 |
AppName | String | liveApp **** |
ライブストリームが属するアプリケーションの名前。 |
StreamName | String | liveStream **** |
ライブストリームの名前。 |
StartTime | String | 2015-12-01T07:36:00Z |
M3U8インデックスファイルが作成される録音の先頭。 時間は、 Z形式のISO 8601標準に従います。 時刻はUTCで表示されます。 |
EndTime | String | 2015-12-01T07:40:00Z |
M3U8インデックスファイルが作成される記録の終わり。 時間は、 Z形式のISO 8601標準に従います。 時刻はUTCで表示されます。 |
有効期間 | Float | 20 |
記録の長さ。 (単位:秒) |
Height | Integer | 480 |
ビデオの高さ。 |
幅 | Integer | 640 |
ビデオの幅。 |
CreateTime | String | 2016-05-27T09:40:56Z |
M3U8インデックスファイルが作成された時刻。 時間は、 Z形式のISO 8601標準に従います。 時刻は UTC 表示です。 |
OssBucket | String | liveBucket **** |
M3U8インデックスファイルが保存されているOSSバケットの名前。 |
OssEndpoint | String | oss-cn-developer.aliyundoc.com |
OSSのエンドポイント。 |
OssObject | String | liveObject ****.m3u8 |
OSSに保存されているレコードの名前。 |
レコードID | String | c4d7f0a4-b506-43f9-8de3-07732c3f **** |
M3U8インデックスファイルのID。 |
RequestId | String | 550439A3-F8EC-4CA2-BB62-B9DB43EEEF30 |
リクエストの ID です。 |
例
リクエストの例
http(s):// live.aliyuncs.com/?Action=CreateLiveStreamRecordIndexFiles
&AppName=liveApp ****
&DomainNam e=example.com
&EndTime=2017-12-22T08:00:00Z
&OssBucket=liveBucket ****
&OssEndpoint= oss-cn-developer.aliyundoc.com
&OssObject={AppName}/{StreamName}/{Date}/{Hour}/{Minute }_{ Second}.m3u8
&StartTime=2017-12-21T08:00:00Z
&StreamName=liveStream ****
&<共通リクエストパラメーター>
正常に処理された場合のレスポンス例
XML
形式
<CreateLiveStreamRecordIndexFilesResponse>
<RequestId>550439A3-F8EC-4CA2-BB62-B9DB43EEEF30</RequestId>
<RecordInfo>
<EndTime>2015-12-01T07:40:00Z</EndTime>
<DomainNam e>example.com</DomainName>
<CreateTime>2016-05-27T09:40:56Z</CreateTime>
<StartTime>2015-12-01T07:36:00Z</StartTime>
<OssBucket>liveBucket ****</OssBucket>
<期間> 20</期間>
<AppName>liveApp ****</AppName>
<StreamName>liveStream ****</StreamName>
<OssEndpoint> oss-cn-developer.aliyundoc.com</OssEndpoint>
<RecordUrl>http:// *****/atestObject.m3u8</RecordUrl>
<OssObject>liveObject ****.m3u8</OssObject>
<高さ> 480</高さ>
<RecordId>c4d7f0a4-b506-43f9-8de3-07732c3f ****</RecordId>
<Width>640</Width>
</RecordInfo>
</CreateLiveStreamRecordIndexFilesResponse>
JSON
形式
{
"CreateLiveStreamRecordIndexFilesResponse": {
"RequestId": "550439A3-F8EC-4CA2-BB62-B9DB43EEEF30" 、
"RecordInfo": {
"EndTime": "2015-12-01T07:40:00Z" 、
"DomainName": "example.com",
"CreateTime": "2016-05-27T09:40:56Z" 、
"StartTime": "2015-12-01T07:36:00Z" 、
"OssBucket": "liveBucket ****" 、
"期間": 20、
"AppName": "liveApp ****" 、
"StreamName": "liveStream ****" 、
"OssEndpoint": "oss-cn-developer.aliyundoc.com" 、
"RecordUrl": "http:// *****/atestObject.m3u8" 、
"OssObject": "liveObject ****.m3u8" 、
"高さ": 480、
"RecordId": "c4d7f0a4-b506-43f9-8de3-07732c3f ****" 、
"幅": 640
}
}
}
エラーコード
HTTP ステータスコード | エラーコード | エラーメッセージ | 説明 |
---|---|---|---|
400 | InvalidStartTime.Malformed | 指定された StartTime は不正です。 | 開始時刻の形式が無効な場合に返されるエラーメッセージ。 StartTimeパラメーターの値が有効かどうかを確認します。 |
400 | InvalidEndTime.Malformed | 指定された EndTime は不正です。 | 終了時刻の形式が無効な場合に返されるエラーメッセージ。 EndTimeパラメーターの値が有効かどうかを確認します。 |
400 | InvalidEndTime. ミスマッチ | 指定された終了時間は、指定された開始時間を計算しません。 | StartTimeパラメーターとEndTimeパラメーターで指定された時間範囲が無効な場合に返されるエラーメッセージ。 StartTimeパラメーターとEndTimeパラメーターが正しく指定されているかどうかを確認します。 |
400 | InvalidOssBucket.Malformed | 指定されたOssBucketは不正です。 | OSSバケット名の形式が無効な場合に返されるエラーメッセージ。 OssBucketパラメーターの値が有効かどうかを確認します。 |
400 | InvalidOssObject.Malformed | 指定されたOssObjectは不正です。 | OSSオブジェクト名の形式が無効な場合に返されるエラーメッセージ。 OssObjectパラメーターの値が有効かどうかを確認します。 |
400 | InvalidStream.NotFound | Speicifiedストリームは存在しません。 | ライブストリームが存在しない場合に返されるエラーメッセージ。 StreamNameパラメーターの値が有効かどうかを確認します。 |
400 | InvalidConfig.Changed | StartTimeとEndTimeの間のossバケット情報が変更されました。 | StartTimeパラメーターとEndTimeパラメーターで指定された時間範囲でバケット情報が変更された場合に返されるエラーメッセージ。 |
400 | NoRecordContent | StartTimeとEndTimeの間のレコードコンテンツは空です。 | StartTimeパラメーターとEndTimeパラメーターで指定された時間範囲に記録が存在しない場合に返されるエラーメッセージ。 |
400 | OperationNotSupport | この操作はFLVまたはMP4形式をサポートしておらず、ライブからVODに録画されたストリーミングもサポートしていません。 | この操作は、FLVまたはMP4形式での録画、またはライブからVODに録画されたストリーミングでは使用できない場合に返されるエラーメッセージ。 |
エラーコードリストについては、「API エラーセンター」をご参照ください。