StartPlaylist API によるライブプレイリストの起動 - LIVE

プレイリストを開始します。

操作説明

AddPlaylistItems 操作を呼び出して、プレイリストにアイテムを追加します。次に、この操作を呼び出してプレイリストを開始します。

QPS 制限

この操作には、ユーザーごとのクエリ/秒 (QPS) 制限が 10 件あります。この制限を超えると、API 呼び出しがスロットルされ、ビジネスに影響を与える可能性があります。指定された制限内でこの操作を呼び出してください。

今すぐお試しください

この 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:StartPlaylist

update

*Domain

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

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
RegionId	string	任意	リージョン ID。	cn-shanghai
ProgramId	string	必須	プレイリストの ID。AddPlaylistItems 操作を呼び出してプレイリストにアイテムを追加する場合は、返された ProgramId パラメーターの値を使用します。	445409ec-7eaa-461d-8f29-4bec2eb9****
ResumeMode	string	任意	再開モード。有効な値： Restart：最初から開始します。 Continue：停止したところから再生を再開します。 StartItemId パラメーターは、ResumeMode パラメーターを Custom に設定した場合にのみ必須です。 Custom：カスタム開始点。	Custom
StartItemId	string	任意	最初に再生するアイテムの ID。カルーセルが開始されると、このアイテムが再生されます。重要このパラメーターは、ResumeMode を Custom に設定した場合にのみ必須です。	asdfasdfasdf****
Offset	integer	任意	ビデオファイルの開始オフセット。このパラメーターは、ビデオファイルに対してのみ有効です。単位：ミリ秒。 0 より大きい値は、最初のフレームを基準とした開始時間を指定します。	10000

レスポンスフィールド

フィールド	型	説明	例
	object
ProgramId	string	プレイリストの ID。この ID をリクエストパラメーターとして使用して、プレイリストを停止できます。	445409ec-7eaa-461d-8f29-4bec2eb9****
RequestId	string	リクエスト ID。	5c6a2a0d-f228-4a64-af62-20e91b96****
StreamInfo	object	ストリームに関する情報。
AppName	string	アプリケーション名。	liveApp****
DomainName	string	ストリーミングドメイン。	example.com
StreamName	string	ストリーム名。	liveStream****
Streams	object
Stream	array<object>	ストリーム情報の一覧。
	object
PullFlvUrl	string	FLV ストリーミング URL。	http://aliyundoc.com/caster/liveStream**.flv?auth_key=1612772224-0-0-3632be7cd9907169e8b09e91099c**
PullM3U8Url	string	RTMP ストリーミング URL。	rtmp:///aliyundoc.com/caster/liveStream**?auth_key=1612772224-0-0-4404ca59c0246226d49d01f734b1**
PullRtmpUrl	string	M3U8 ストリーミング URL。	http://aliyundoc.com/caster/liveStream**.m3u8?auth_key=1612772224-0-0-919a023a127156fe82e3562c3b3b**
Quality	string	ビデオ画質。有効な値： original：元の画質。	original

例

成功レスポンス

JSONJSON

{
  "ProgramId": "445409ec-7eaa-461d-8f29-4bec2eb9****",
  "RequestId": "5c6a2a0d-f228-4a64-af62-20e91b96****",
  "StreamInfo": {
    "AppName": "liveApp****",
    "DomainName": "example.com",
    "StreamName": "liveStream****",
    "Streams": {
      "Stream": [
        {
          "PullFlvUrl": "http://aliyundoc.com/caster/liveStream****.flv?auth_key=1612772224-0-0-3632be7cd9907169e8b09e91099c****",
          "PullM3U8Url": "rtmp:///aliyundoc.com/caster/liveStream****?auth_key=1612772224-0-0-4404ca59c0246226d49d01f734b1****",
          "PullRtmpUrl": "http://aliyundoc.com/caster/liveStream****.m3u8?auth_key=1612772224-0-0-919a023a127156fe82e3562c3b3b****",
          "Quality": "original"
        }
      ]
    }
  }
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
400	IncorrectSceneStatus	%s, please check and try again later.
400	IncorrectCasterStatus	%s, please check and try again later.
400	IncorrectSceneStatus.Inuse	%s, please check and try again later.
400	InvalidProgramId.Malformed	%s, please check and try again later.
400	InvalidParameter.Malformed	There are invalid parameters: %s.
400	InvalidNormType.Malformed	%s, please check and try again later.
400	InvalidParameter.Offset	%s, please check and try again later.
400	InvalidParameter.StartItemId	%s, please check and try again later.
500	InternalError	%s, please try again later.
403	UserQuotaExceed	Quota exceeded: %s.
404	PlayListNotFound	%s, please check and try again later.
404	PlayListItemNotFound	%s, please check and try again later.
404	InvalidCaster.NotFound	%s, please check and try again later.
404	InvalidCasterTemplate.NotFound	%s, please check and try again later.
404	IncorrectCasterStatus.EnableChannel	%s, please check and try again later.

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

変更履歴

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