エピソードリストの再生を開始します。
使用状況ノート
リクエストにはProgramIdパラメーターが必要です。
QPS制限
1人のユーザーが1秒あたり最大10件のクエリ (QPS) を実行できます。 1秒あたりの呼び出し数がQPS制限を超えると、スロットリングがトリガーされます。 スロットルはビジネスに影響を与える可能性があります。 したがって、この操作のQPS制限を遵守することをお勧めします。 シングルユーザーの意味とQPSの詳細については、「ApsaraVideo LiveのAPI操作のQPS制限」をご参照ください。
デバッグ
リクエストパラメーター
| パラメーター | データ型 | 必須／任意 | 例 | 説明 |
|---|---|---|---|---|
| 操作 | String | 必須 | StartPlaylist |
実行する操作です。 値を StartPlaylist。 |
| ProgramId | String | 必須 | 445409ec-7eaa-461d-8f29-4bec2eb9 **** |
再生を開始するエピソードリストのID。 AddPlaylistItems 操作を呼び出したときの応答に含まれます。 |
| ResumeMode | String | 任意 | カスタム |
エピソードリストの再生を再開するメソッド。 設定可能な値は以下のとおりです。
|
| StartItemId | String | 任意 | asdfasdfasdf **** |
再生する最初のエピソードのID。 このエピソードは、カルーセル再生で最初に再生されます。 注 ResumeModeパラメーターをCustomに設定した場合、このパラメーターは必須です。
|
| Offset | Integer | 任意 | 10,000 |
システムがエピソードの再生を開始する位置のオフセット。 このパラメーターは、エピソードリソースがファイルの場合にのみ返されます。 単位：ミリ秒。 0より大きい値は、第1のフレームからのオフセットを示す。 |
レスポンスパラメーター
| パラメーター | データ型 | 例 | 説明 |
|---|---|---|---|
| ProgramId | String | 445409ec-7eaa-461d-8f29-4bec2eb9 **** |
再生を開始したエピソードリストのID。 |
| RequestId | String | 5c6a2a0d-f228-4a64-af62-20e91b96 **** |
リクエストの ID です。 |
| StreamInfo | Struct |
エピソードリストの再生に使用されるストリームに関する情報。 |
|
| AppName | String | liveApp **** r |
アプリケーションの名前。 |
| DomainName | String | example.com |
メインのストリーミングドメイン。 |
| StreamName | String | liveStream **** |
ライブストリームの名前。 |
| ストリーム | ストリームの配列 |
さまざまなプロトコルに基づいて再生用に生成されたライブストリームに関する情報。 |
|
| Stream | |||
| PullFlvUrl | String | http://aliyundoc.com/caster/liveStream ****.flv?auth_key=1612772224-0-0-3632be7cd9907169e8b09e91099c **** |
ライブストリームのFlash Video (FV) URL。 |
| PullM3U8Url | String | rtmp:/// aliyundoc.com/caster/liveStream****?auth_key=1612772224-0-0-4404ca59c0246226d49d01f734b1**** |
ライブストリームのRTMP (Real-Time Messaging Protocol) URL。 |
| PullRtmpUrl | String | http://aliyundoc.com/caster/liveStream ****.m3u8?auth_key=1612772224-0-0-919a023a127156fe82e3562c3b3b **** |
ライブストリームのM3U8 URL。 |
| 品質 | String | オリジナル |
ライブストリームの画質。 有効な値は オリジナル: オリジナル品質 |
例
リクエストの例
http(s):// live.aliyuncs.com/?Action=StartPlaylist
&ProgramId=445409ec-7eaa-461d-8f29-4bec2eb9 ****
&ResumeMode=カスタム
&StartItemId=asdfasdfasdf ****
&オフセット=10000
&<共通リクエストパラメーター>正常に処理された場合のレスポンス例
XML 形式
<StartPlaylistResponse>
<RequestId>5c6a2a0d-f228-4a64-af62-20e91b96 ****</RequestId>
<StreamInfo>
<StreamName>liveStream ****</StreamName>
<DomainNam e>example.com</DomainName>
<AppName>liveApp ****</AppName>
<ストリーム>
<ストリーム>
<PullFlvUrl>http://aliyundoc.com/caster/liveStream ****.flv?auth_key=1612772224-0-0-3632be7cd9907169e8b09e91099c ****</PullFlvUrl>
<PullM3U8Url>rtmp:/// aliyundoc.com/caster/liveStream****?auth_key=1612772224-0-0-4404ca59c0246226d49d01f734b1****</PullM3U8Url>
<Quality> オリジナル </Quality>
<PullRtmpUrl>http://aliyundoc.com/caster/liveStream ****.m3u8?auth_key=1612772224-0-0-919a023a127156fe82e3562c3b3b ****</PullRtmpUrl>
</Stream>
</ストリーム>
</StreamInfo>
<ProgramId>445409ec-7eaa-461d-8f29-4bec2eb9 ****</ProgramId>
</StartPlaylistResponse>JSON 形式
{
"StartPlaylistResponse": {
"RequestId": "5c6a2a0d-f228-4a64-af62-20e91b96 ****" 、
"StreamInfo": {
"StreamName": "liveStream ****" 、
"DomainName": "example.com",
"AppName": "liveApp ****" 、
"ストリーム": {
"ストリーム": {
"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 ****"
}
}
},
"ProgramId": "445409ec-7eaa-461d-8f29-4bec2eb9 ****"
}
}エラーコード
エラーコードリストについては、「API エラーセンター」をご参照ください。