调用QueryLiveStreaming获取设备直播开播地址。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 QueryLiveStreaming

系统规定参数。取值：QueryLiveStreaming。

IotId String 是 id1

设备ID。可调用物联网平台QueryDeviceDetail查询。

StreamType Integer 否 0
  • 0（默认值）：主码流
  • 1：辅码流
ShouldEncrypt Boolean 否 false

是否加密，默认为false。

EncryptType Integer 否 0

加密类型，帧加密默认为0。

Scheme String 否 rtmp

协议类型，默认为rtmp。

  • rtmp-RTMP协议
  • hls-HLS协议

返回数据

名称 类型 示例值 描述
Code String MissingParamter

调用失败时，返回的错误码。
Data Struct

播放地址信息。
DecryptKey String {\"iv\":\"\",\"key\":\"\"}

解密密钥。
Path String rtmp://106.15.11.120/live?token=token1/streamName

播放地址(10s内有效，且只能使用一次)。
ErrorMessage String XXXis mandatory for this action

调用失败时，返回的出错信息。
RequestId String 06DC77A0-4622-42DB-9EE0-25FIOHS82JK1

请求ID。
Success Boolean true

表示是否调用成功：

  • true表示调用成功
  • false表示调用失败

示例

请求示例

http(s)://[Endpoint]/?Action=QueryLiveStreaming
&IotId=id1
&StreamType=0
&<公共请求参数>

正常返回示例

XML 格式 

<QueryLiveStreamingResponse>
  <RequestId>06DC77A0-4622-42DB-9EE0-25FIOHS82JK1</RequestId>
  <Success>true</Success>
  <Data>
      <Path>rtmp://106.15.11.120/live?token=8bce***/streamName
   </Path>
       <DecryptKey>{\"iv\":\"\",\"key\":\"\"}
   </DecryptKey>
  </Data>
</QueryLiveStreamingResponse>

JSON 格式 

{
  "RequestId":"06DC77A0-4622-42DB-9EE0-25FIOHS82JK1",
  "Success":true,
  "Data":{
  "Path":"rtmp://106.15.11.120/live?token=token1/streamName",
       "DecryptKey":"{\"iv\":\"\",\"key\":\"\"}"
  }
}

错误码

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