创建一个定时任务。
接口说明
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息,可以在RAM权限策略语句的Action
元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:
- 操作:是指具体的权限点。
- 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
- 资源类型:是指操作中支持授权的资源类型。具体说明如下:
- 对于必选的资源类型,用背景高亮的方式表示。
- 对于不支持资源级授权的操作,用
全部资源
表示。
- 条件关键字:是指云产品自身定义的条件关键字。
- 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
---|---|---|---|---|
live:InitializeAutoShowListTask | get |
|
| 无 |
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
ResourceIds | string | 否 | 播单中的点播媒资文件 ID 列表(目前仅支持点播视频文件)。 最多支持三个节目,每个节目会按照列表顺序进行播放直到 EndTime 会自动结束。 说明
| ["89e02xxxxfb349axxxxa0c350d**** ","6ae0xxxxxb349axxxxa0c350a****"] |
StartTime | long | 是 | 开始时间戳,单位:毫秒。 | 1645688994000 |
EndTime | long | 是 | 结束时间戳,单位:毫秒。 | 1645688994000 |
CasterConfig | string | 是 | 导播台配置。包含:
说明
JSON 格式字符串,结构体内部字段请按首字母大写,驼峰格式输入。
| {"CasterTemplate": "lp_ld","LiveTemplates":["lhd", "lsd","lud"]} |
DomainName | string | 是 | 输出的播流域名。 | example.aliyundoc.com |
CallBackUrl | string | 否 | 用户回调地址。 | http://***.com/callback |
返回参数
示例
正常返回示例
JSON
格式
{
"CasterId": "b4810848-bcf9-4aef-bd4a-e6bba2d9****",
"RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8",
"StreamList": "[{\"videoFormat\":\"flv\",\"outputStreamUrl\":\"http://example.aliyundoc.com\",\"transcodeConfig\":\"original\"}]"
}
错误码
HTTP status code | 错误码 | 错误信息 |
---|---|---|
400 | InvalidParameter.PurchaseTime | %s |
400 | InvalidParameter.ExpireTime | %s |
400 | MissingParameter | %s |
400 | InvalidChargeType.Malformed | %s |
400 | InvalidChargeType.PostSupport | %s |
400 | InvalidCasterTemplate.Malformed | %s |
400 | InvalidParameter.Malformed | %s |
400 | InvalidParameter.ChargeType | %s |
400 | InvalidPeriod.Malformed | %s |
400 | InvalidClientToken.Malformed | %s |
400 | IncorrectCasterStatus | %s |
400 | InvalidCasterId.Malformed | %s |
400 | InvalidUserId.Malformed | %s |
400 | IncorrectCasterStatus.EnableChannel | %s |
400 | InvalidParameter.StartTime | %s |
401 | CasterNumberExceed | %s |
401 | IllegalOperation | %s |
404 | InvalidParameter.NormType | %s |
404 | InvalidConfiguration.NotFound | %s |
404 | InvalidCaster.NotFound | %s |
404 | InvalidDomainName.NotFound | %s |
408 | CreateCaster.Timeout | %s |
500 | InternalError | %s |
访问错误中心查看更多错误码。
变更历史
变更时间 | 变更内容概要 | 操作 |
---|
暂无变更历史
示例代码
public void InitializeAutoShowListTask() throws ClientException {
CommonRequest initializeAutoShowListTaskRequest = new CommonRequest()
initializeAutoShowListTaskRequest.setAction("InitializeAutoShowListTask");
initializeAutoShowListTaskRequest.setDomain("live.aliyuncs.com");
initializeAutoShowListTaskRequest.setVersion("2016-11-01");
JSONArray resourceIds = new JSONArray();
resourceIds.add("xxx1");
initializeAutoShowListTaskRequest.putQueryParameter("ResourceIds", resourceIds.toJSONString());
long currentTimeMillis = System.currentTimeMillis();
//播放一分钟时长,在 30 秒后启动
long startTime = currentTimeMillis + 30 * 1000;
long endTime = startTime + 1 * 60 * 1000;
SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
// 时间戳转换成时间
String start = sdf.format(new Date(Long.parseLong(String.valueOf(startTime))));
// 时间戳转换成时间
String end = sdf.format(new Date(Long.parseLong(String.valueOf(endTime))));
System.out.printf("格式化结果:start %s end %s\n", start, end);
initializeAutoShowListTaskRequest.putQueryParameter("StartTime", String.valueOf(startTime));
initializeAutoShowListTaskRequest.putQueryParameter("EndTime", String.valueOf(endTime));
JSONObject casterConfig = new JSONObject();
casterConfig.put("CasterTemplate", "lp_hd");
JSONArray liveTemplate = new JSONArray();
liveTemplate.add("lhd");
liveTemplate.add("lsd");
casterConfig.put("LiveTemplate", liveTemplate);
initializeAutoShowListTaskRequest.putQueryParameter("CasterConfig", casterConfig.toJSONString());
initializeAutoShowListTaskRequest.putQueryParameter("DomainName", "testdomainplay.alivecdn.com");
DefaultAcsClient client = initClient(ACCESS_KEY_ID, ACCESS_KEY_SECRET);
CommonResponse commonResponse = client.getCommonResponse(initializeAutoShowListTaskRequest);
System.out.printf("Status is %s and Response is:\n", commonResponse.getHttpStatus());
JSONObject jsonObject = JSON.parseObject(commonResponse.getData());
System.out.println(JSON.toJSONString(jsonObject, true));
}
JSON 格式返回示例
{
"RequestId": "9F6448C9-6F92-1BAC-AFDD-C308782A6573",
"StreamList": [
{
"videoFormat": "flv",
"outputStreamUrl": "http://example.aliyundoc.com/caster/2967b3b2b52242019c277de2a11a****.flv",
"transcodeConfig": "original"
},
{
"videoFormat": "rtmp",
"outputStreamUrl": "rtmp://example.aliyundoc.com/caster/2967b3b2b52242019c277de2a11a****",
"transcodeConfig": "original"
},
{
"videoFormat": "m3u8",
"outputStreamUrl": "http://example.aliyundoc.com/caster/2967b3b2b52242019c277de2a11a****.m3u8",
"transcodeConfig": "original"
},
{
"videoFormat": "flv",
"outputStreamUrl": "http://example.aliyundoc.com/caster/2967b3b2b52242019c277de2a11a****_lhd.flv",
"transcodeConfig": "lhd"
},
{
"videoFormat": "rtmp",
"outputStreamUrl": "rtmp://example.aliyundoc.com/caster/2967b3b2b52242019c277de2a11a****_lhd",
"transcodeConfig": "lhd"
},
{
"videoFormat": "m3u8",
"outputStreamUrl": "http://example.aliyundoc.com/caster/2967b3b2b52242019c277de2a11a****_lhd.m3u8",
"transcodeConfig": "lhd"
},
{
"videoFormat": "flv",
"outputStreamUrl": "http://example.aliyundoc.com/caster/2967b3b2b52242019c277de2a11a****_lsd.flv",
"transcodeConfig": "lsd"
},
{
"videoFormat": "rtmp",
"outputStreamUrl": "rtmp://example.aliyundoc.com/caster/2967b3b2b52242019c277de2a11a****_lsd",
"transcodeConfig": "lsd"
},
{
"videoFormat": "m3u8",
"outputStreamUrl": "http://example.aliyundoc.com/caster/2967b3b2b52242019c277de2a11a****_lsd.m3u8",
"transcodeConfig": "lsd"
}
],
"CasterId": "6277b6a3-1a40-4063-85f7-145666e3****"
}