ライブストリーム TS セグメントからのオンデマンド再生用 M3U8 マニフェスト生成 - LIVE - Alibaba Cloud - ApsaraVideo Live

指定された時間範囲の M3U8 インデックスファイルを作成します。

操作説明

OSS が設定されている必要があります。詳細については、「OSS の設定項目」を参照してください。ライブ録画インデックス機能は、ライブビデオストリームを M3U8 フォーマットで録画し、OSS に保存した後、保存された TS メディアセグメントファイルのインデックスファイルに対してリアルタイムクリッピングを実行します。

説明

録画インデックスを作成するには、ライブストリームでアップストリーミングが行われている必要があります。指定された時間範囲内にライブストリーミングが行われていない場合、またはストリーム名が正しくない場合は、録画インデックスの作成は失敗したとなります。
DomainName、AppName、StreamName が正しいことを確認してください。正しくない場合、InvalidStream.NotFound エラーが返されます。
StartTime と EndTime の間隔は、少なくとも 1 つの TS メディアセグメントファイルの持続時間（デフォルトで 30 秒）以上である必要があります。
EndTime は StartTime より後である必要があり、間隔は 4 日を超えることはできません。
TS メディアセグメントファイルの情報は、ApsaraVideo Live システムに 3 か月間のみ保持されます。M3U8 ファイルを作成できるのは、過去 3 か月以内の録画からのみです。
TS メディアセグメントファイルは OSS に保存されます。保持期間は OSS ストレージ構成によって決定されます。詳細については、「ライフサイクルルールの設定項目」を参照してください。
作成された M3U8 インデックスファイルの情報は、ApsaraVideo Live システムに 6 か月間のみ保持されます。クエリできるのは、過去 6 か月以内に作成されたインデックスファイルの情報だけです。
M3U8 インデックスファイルは OSS に保存されます。保持期間は OSS ストレージ構成によって決定されます。
M3U8 ファイルと TS ファイルが異なるバケットに保存されている場合、M3U8 ファイル内の TS パスは HTTP フォーマットになります。

QPS 制限

この API の単一ユーザー QPS 制限は、1 秒あたり 45 回の呼び出しです。この制限を超えると速度制限がトリガーされ、ビジネスに影響を与える可能性があります。この操作は適切に呼び出してください。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

live:CreateLiveStreamRecordIndexFiles

create

*Domain

acs:cdn:*:{#accountId}:domain/{#DomainName}

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
DomainName	string	必須	ストリーマーのストリーミングドメイン。	example.com
AppName	string	必須	ストリームが属するアプリケーションの名前。テンプレートの効果を有効にするには、AppName がアップストリーミング URL の AppName と一致している必要があります。すべての AppName 値に一致させるには、このパラメーターを * に設定します。	liveApp****
StreamName	string	必須	ストリーム名。テンプレートの効果を有効にするには、StreamName がアップストリーミング URL の StreamName と一致している必要があります。すべての StreamName 値に一致させるには、このパラメーターを * に設定します。指定された DomainName および AppName の下で、ストリームに実際のアップストリーミング活動があった必要があります。そうでない場合、InvalidStream.NotFound エラーが返されます。	liveStream****
OssEndpoint	string	必須	OSS バケットのエンドポイント。	cn-oss-****.aliyuncs.com
OssBucket	string	必須	OSS バケットの名前。	liveBucket****
OssObject	string	必須	OSS に保存されている録画ファイルの名前。	{AppName}/{StreamName}/{Date}/{Hour}/{Minute}_{Second}.m3u8
StartTime	string	必須	インデックスファイルの開始時刻。この時刻以降にアップロードされた TS ファイルがインデックスファイルに含まれます。時間は yyyy-MM-ddTHH:mm:ssZ フォーマット（協定世界時 (UTC)）で指定します。	2017-12-21T08:00:00Z
EndTime	string	必須	インデックスファイルの終了時刻。この時刻より前にアップロードされた TS ファイルがインデックスファイルに含まれます。時間は yyyy-MM-ddTHH:mm:ssZ フォーマット（協定世界時 (UTC)）で指定します。	2017-12-22T08:00:00Z
EndTimeIncluded	boolean	任意	終了時刻を含めるかどうかを指定します。このパラメーターを true にセットすると、システムは追加の TS ファイルを 1 つ含めようとし、作成されたインデックスファイルが StartTime と EndTime の期間を完全にカバーするようにします。	false

レスポンスフィールド

フィールド	型	説明	例
	object
RequestId	string	リクエスト ID。	550439A3-F8EC-4CA2-BB62-B9DB43EEEF30
RecordInfo	object	録画フォーマット情報。
RecordUrl	string	インデックスファイルの URL。	http://*****/atestObject.m3u8
StreamName	string	ストリーム名。	liveStream****
CreateTime	string	作成時刻。時間は yyyy-MM-ddTHH:mm:ssZ フォーマット（協定世界時 (UTC)）です。	2016-05-27T09:40:56Z
RecordId	string	インデックスファイルの ID。	c4d7f0a4-b506-43f9-8de3-07732c3f****
Height	integer	ビデオの高さ。	480
OssBucket	string	OSS バケットの名前。	liveBucket****
DomainName	string	ストリーマーのストリーミングドメイン。	example.com
OssObject	string	OSS に保存されている録画ファイルの名前。	liveObject****.m3u8
EndTime	string	終了時刻。時間は yyyy-MM-ddTHH:mm:ssZ フォーマット（協定世界時 (UTC)）です。	2015-12-01T07:40:00Z
AppName	string	ストリームが属するアプリケーションの名前。	liveApp****
StartTime	string	開始時刻。時間は yyyy-MM-ddTHH:mm:ssZ フォーマット（協定世界時 (UTC)）です。	2015-12-01T07:36:00Z
Width	integer	ビデオの幅。	640
Duration	number	録画時間。単位：秒。	20
OssEndpoint	string	OSS バケットのエンドポイント。	cn-oss-****.aliyuncs.com

例

成功レスポンス

JSONJSON

{
  "RequestId": "550439A3-F8EC-4CA2-BB62-B9DB43EEEF30",
  "RecordInfo": {
    "RecordUrl": "http://*****/atestObject.m3u8",
    "StreamName": "liveStream****",
    "CreateTime": "2016-05-27T09:40:56Z",
    "RecordId": "c4d7f0a4-b506-43f9-8de3-07732c3f****",
    "Height": 480,
    "OssBucket": "liveBucket****",
    "DomainName": "example.com",
    "OssObject": "liveObject****.m3u8",
    "EndTime": "2015-12-01T07:40:00Z",
    "AppName": "liveApp****",
    "StartTime": "2015-12-01T07:36:00Z",
    "Width": 640,
    "Duration": 20,
    "OssEndpoint": "cn-oss-****.aliyuncs.com"
  }
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ	説明
400	InvalidStartTime.Mismatch	Specified StartTime does not math the current time.
400	InvalidStartTime.Malformed	Specified StartTime is malformed.
400	InvalidParams	invalid params
400	InvalidEndTime.Malformed	Specified EndTime is malformed.
400	InvalidEndTime.Mismatch	Specified end time does not math the specified start time.	終了時間が開始時刻と一致しません。時間が整合していることを確認してください。
400	InvalidOssEndpoint.Malformed	Specified OssEndpoint is malformed.
400	InvalidOssBucket.Malformed	Specified OssBucket is malformed.	OSSBucket パラメーターが無効です。OSS BUCKET パラメーターが正しいことを確認してください。
400	InvalidOssObject.Malformed	Specified OssObject is malformed.
400	InvalidStream.NotFound	Speicified stream does not exist.
400	InvalidConfig.Changed	The oss bucket info between StartTime and EndTime has changed.	OSS バケットの開始時刻と終了時間が変更されました。
400	NoRecordContent	The record content between StartTime and EndTime is empty.	StartTime と EndTime の間に Record が見つかりませんでした。
400	RecordContentExceed	The record content between StartTime and EndTime is exceeded, please narrow down the range.
400	OperationNotSupport	The Operation is not support for flv/mp4 format or live to vod record.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.
404	InvalidBucket.NotFound	The bucket does not belong to you.	指定されたバケットは現在のユーザーに属していません。

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。