調用StartCaster啟動導播臺。
使用說明
先通過CreateCaster接口創建導播臺,再調用本接口啟動導播臺。若PVW、PGM場景不存在則創建,啟動PVW、PGM場景,啟動底層音視頻處理任務。
QPS限制
本接口的單用戶QPS限制為10次/秒。超過限制,API調用會被限流,這可能會影響您的業務,請合理調用。更多信息,請參見QPS限制。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | StartCaster | 系統規定參數。取值:StartCaster。 |
CasterId | String | 是 | 80787064-1c94-4dc1-85ce-9409960a**** | 導播臺ID。
說明 直播控制臺云導播臺頁面導播臺列表中的導播臺名稱即導播臺ID。 |
返回數據
名稱 |
類型 |
示例值 |
描述 |
PgmSceneInfos | Array of SceneInfo | PGM場景信息列表。 |
|
SceneInfo | |||
SceneId | String | b5f8c837-ceeb-424f-b30b-68e94e86**** | 場景ID。 |
StreamInfos | Array of StreamInfo | 旁路輸出播放地址列表。 |
|
StreamInfo | |||
OutputStreamUrl | String | rtmp://abclive/caster/example.net | 播放地址。 |
TranscodeConfig | String | lld | 轉碼配置。 取值:
|
VideoFormat | String | flv | 格式。取值:
|
StreamUrl | String | rtmp://abclive/caster/example.edu | 導播臺PGM場景對應播放流地址,非旁路輸出流地址。 |
PvwSceneInfos | Array of SceneInfo | PVW場景信息列表。 |
|
SceneInfo | |||
SceneId | String | b5f8c837-ceeb-424f-b30b-68e94e86**** | 場景ID。 |
StreamUrl | String | rtmp://abclive/caster/example.net | 導播臺PVW場景對應播放流地址,非旁路輸出流地址。 |
RequestId | String | 6EBD1AC4-C34D-4AE1-963E-B688A228BE31 | 請求ID。 |
示例
請求示例
http(s)://live.aliyuncs.com/?Action=StartCaster
&CasterId=80787064-1c94-4dc1-85ce-9409960a****
&<公共請求參數>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<?xml version="1.0" encoding="UTF-8" ?>
<StartCasterResponse>
<RequestId>6EBD1AC4-C34D-4AE1-963E-B688A228BE31</RequestId>
<PvwSceneInfos>
<SceneInfo>
<SceneId>b5f8c837-ceeb-424f-b30b-68e94e86****</SceneId>
<RtsUrl/>
<StreamUrl>rtmp://abclive/caster/example.net</StreamUrl>
</SceneInfo>
</PvwSceneInfos>
<PgmSceneInfos>
<SceneInfo>
<SceneId>b5f8c837-ceeb-424f-b30b-68e94e86****</SceneId>
<StreamUrl>rtmp://abclive/caster/example.edu</StreamUrl>
<StreamInfos>
<StreamInfo>
<OutputStreamUrl>rtmp://abclive/caster/example.net</OutputStreamUrl>
<VideoFormat>flv</VideoFormat>
<TranscodeConfig>lld</TranscodeConfig>
</StreamInfo>
</StreamInfos>
</SceneInfo>
</PgmSceneInfos>
</StartCasterResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"StartCasterResponse" : {
"RequestId" : "6EBD1AC4-C34D-4AE1-963E-B688A228BE31",
"PvwSceneInfos" : {
"SceneInfo" : {
"SceneId" : "b5f8c837-ceeb-424f-b30b-68e94e86****",
"RtsUrl" : "",
"StreamUrl" : "rtmp://abclive/caster/example.net"
}
},
"PgmSceneInfos" : {
"SceneInfo" : {
"SceneId" : "b5f8c837-ceeb-424f-b30b-68e94e86****",
"StreamUrl" : "rtmp://abclive/caster/example.edu",
"StreamInfos" : {
"StreamInfo" : {
"OutputStreamUrl" : "rtmp://abclive/caster/example.net",
"VideoFormat" : "flv",
"TranscodeConfig" : "lld"
}
}
}
}
}
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
文檔內容是否對您有幫助?