全部产品
阿里云办公

启动导播台

更新时间:2018-06-27 19:15:19

描述

启动导播台,若PVW、PGM场景不存在则创建,启动PVW、PGM场景,启动底层音视频处理任务。

请求参数

参数 类型 是否必选 描述
Action String 操作接口名,系统规定参数,取值:StartCaster
CasterId String 导播台Id

返回参数

参数 类型 描述
RequestId String 该条任务请求Id
PvwSceneInfos []SceneInfo PVW场景信息列表
PgmSceneInfos []SceneInfo PGM场景信息列表

SceneInfo

参数 类型 描述
SceneId String 场景ID
StreamUrl String 导播台场景对应播放流地址,非旁路输出流地址
StreamInfos StreamInfo[] 旁路输出播放地址列表

StreamInfo

参数 类型 描述
TranscodeConfig String 转码配置
lsd:标清
lld:流畅
lud:超清
lhd:高清
VideoFormat String 格式 flv,rtmp,m3u8
OutputStreamUrl String 播放地址

特殊错误码

错误代码 描述 Http 状态码 语义
PermissionDenied Permission Denied 401 无权访问导播台
InvalidCaster.NotFound Caster is not found. 404 指定导播台不存在
InvalidConfiguration.NotFound DomainName is not configured 404 配置信息缺失
InternalError InternalError 500 内部错误

示例

请求示例

  1. https://live.aliyuncs.com?Action=StartCaster&CasterId=80787064-1c94-4dc1-85ce-9409960a9bf0&<公共请求参数>

返回示例

  1. {
  2. "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8",
  3. "PvwSceneInfos": [
  4. {
  5. "SceneId":"b5f8c837-ceeb-424f-b30b-68e94e864995",
  6. "StreamUrl":"rtmp://XXXXXX/caster/1975ee99db904ebb83908d43bc878188?auth_key=1506396160-0-0-063397072a9980fd418d43eb00e02e09"
  7. }
  8. ],
  9. "PgmSceneInfos": [
  10. {
  11. "SceneId":"b5f8c837-ceeb-424f-b30b-68e94e864996",
  12. "StreamUrl":"rtmp://XXXXXX/caster/1975ee99db904ebb83908d43bc878188?auth_key=1506396160-0-0-063397072a9980fd418d43eb00e02e10",
  13. "StreamInfos": [
  14. {
  15. "VideoFormat": "flv",
  16. "OutputStreamUrl": "http://XXXXXX/caster/fb628e2469f94f2aa2c0c219af8b2527_lld.flv?auth_key=1506396160-0-0-7de771a77102680861853af862d5eaf0",
  17. "TranscodeConfig": "lld"
  18. },
  19. {
  20. "VideoFormat": "rtmp",
  21. "OutputStreamUrl": "rtmp://XXXXXX/caster/fb628e2469f94f2aa2c0c219af8b2527_lld?auth_key=1506396160-0-0-77ed32cd82ed32ccd51a832b5765814c",
  22. "TranscodeConfig": "lld"
  23. },
  24. {
  25. "VideoFormat": "m3u8",
  26. "OutputStreamUrl": "http://XXXXXX/caster/fb628e2469f94f2aa2c0c219af8b2527.m3u8?auth_key=1506396160-0-0-d51f0512dcf76aa749f79f53ae6421d2",
  27. "TranscodeConfig": "lld"
  28. }
  29. ]
  30. }
  31. ]
  32. }