调用UpdateLive修改会议
本接口包括到多个操作,更新会议的状态,开始录制、结束录制、结束会议。
录制会用到旁路转推服务,将正在进行实时音视频通话时频道的画面同步到云端进行云端混流,并将混流后的频道直播流推流给第三方CDN或者阿里云视频直播,这一过程称为旁路转推。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | UpdateLive |
系统规定参数。取值:UpdateLive。 |
LiveId | String | 是 | 0f1c45cd-3eee-4e60-b505-2e330b8755d3 |
会议ID |
Status | String | 是 | START_RECORDING |
取值为START_RECORDING、STOP_RECORDING、COMPLETED |
UserId | String | 是 | 7276e3ecd07866ca |
用户ID |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Code | String | OK | |
Data | Struct |
数据 |
|
Id | String | 0ff4ae5b-6211-4998-a5c3-c2e6552cab05 |
录制ID |
Message | String | – | |
RequestId | String | f8b8b0a3-9dec-4af2-97ba-75283534ae49 |
示例
请求示例
http(s)://[Endpoint]/?Action=UpdateLive
&LiveId=0f1c45cd-3eee-4e60-b505-2e330b8755d3
&Status=START_RECORDING
&UserId=7276e3ecd07866ca
&<公共请求参数>
正常返回示例
XML
格式
<Message>-</Message>
<RequestId>f8b8b0a3-9dec-4af2-97ba-75283534ae49</RequestId>
<Data>
<Id>0ff4ae5b-6211-4998-a5c3-c2e6552cab05</Id>
</Data>
<Code>OK</Code>
JSON
格式
{
"Message": "-",
"RequestId": "f8b8b0a3-9dec-4af2-97ba-75283534ae49",
"Data": {
"Id": "0ff4ae5b-6211-4998-a5c3-c2e6552cab05"
},
"Code": "OK"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
403 | Forbidden | Access to this resource on the server is denied. | 没有权限访问该资源 |
500 | InternalServerError | An internal server error occurred. | 服务器内部出错 |
400 | InvalidRequest | The request is invalid. | 无效的请求 |
404 | ResourceNotFound | The specified resource does not exist. | 找不到指定的资源 |
401 | Unauthorized | The request requires user authentication. | 该请求需要进行身份认证 |
访问错误中心查看更多错误码。
访问错误中心查看更多错误码。