启动节目单 - 视频直播

使用说明

先通过AddPlaylistItems接口添加节目单项，再调用本接口启动整个节目单。

QPS限制

本接口的单用户QPS限制为10次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见QPS限制。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	StartPlaylist	系统规定参数。取值：StartPlaylist。
ProgramId	String	是	445409ec-7eaa-461d-8f29-4bec2eb9****	节目单ID。如果您通过AddPlaylistItems接口添加节目单项，请查看AddPlaylistItems接口调用返回的参数ProgramId值。
ResumeMode	String	否	Custom	重启模式。取值： Restart：从头开始。 Continue：根据停止前播放位置继续。如果ResumeMode参数设置为Custom时，请求参数StartItemId才必填。 Custom：自定义。
StartItemId	String	否	asdfasdfasdf****	起始节目单项ID。启动轮播时将先播放此节目单项。重要如果ResumeMode参数设置为Custom时，此参数才必传。
Offset	Integer	否	10000	启动偏移。视频文件起始偏移值。仅对文件视频有效，单位：毫秒。大于0，表示从相对于首帧的偏差时间作为开始读取的位置。

返回数据

名称	类型	示例值	描述
ProgramId	String	445409ec-7eaa-461d-8f29-4bec2eb9****	节目单ID。可作为停止节目单的请求参数。
RequestId	String	5c6a2a0d-f228-4a64-af62-20e91b96****	请求ID。
StreamInfo	Object		返回的流信息。
AppName	String	liveApp****	应用名称。
DomainName	String	example.com	主播流域名。
StreamName	String	liveStream****	播流名称。
Streams	Array of Stream		流信息列表。
Stream
PullFlvUrl	String	http://aliyundoc.com/caster/liveStream**.flv?auth_key=1612772224-0-0-3632be7cd9907169e8b09e91099c**	FLV播流地址。
PullM3U8Url	String	rtmp:///aliyundoc.com/caster/liveStream**?auth_key=1612772224-0-0-4404ca59c0246226d49d01f734b1**	RTMP播流地址。
PullRtmpUrl	String	http://aliyundoc.com/caster/liveStream**.m3u8?auth_key=1612772224-0-0-919a023a127156fe82e3562c3b3b**	m3u8播流地址。
Quality	String	original	画质。取值： original：原画。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=StartPlaylist
&ProgramId=445409ec-7eaa-461d-8f29-4bec2eb9****
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<StartPlaylistResponse>
    <ProgramId>445409ec-7eaa-461d-8f29-4bec2eb9****</ProgramId>
    <RequestId>5c6a2a0d-f228-4a64-af62-20e91b96****</RequestId>
    <StreamInfo>
        <AppName>liveApp****</AppName>
        <DomainName>example.com</DomainName>
        <StreamName>liveStream****</StreamName>
        <Streams>
            <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>
            <PullRtmpUrl>http://aliyundoc.com/caster/liveStream****.m3u8?auth_key=1612772224-0-0-919a023a127156fe82e3562c3b3b****</PullRtmpUrl>
            <Quality>original</Quality>
        </Streams>
    </StreamInfo>
</StartPlaylistResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "ProgramId" : "445409ec-7eaa-461d-8f29-4bec2eb9****",
  "RequestId" : "5c6a2a0d-f228-4a64-af62-20e91b96****",
  "StreamInfo" : {
    "AppName" : "liveApp****",
    "DomainName" : "example.com",
    "StreamName" : "liveStream****",
    "Streams" : [ {
      "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"
    } ]
  }
}

错误码

访问错误中心查看更多错误码。