獲取設(shè)備錄像視頻取流URL。

調(diào)試

您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計(jì)算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。

請(qǐng)求參數(shù)

名稱 類型 是否必選 示例值 描述
Action String 是 GetDeviceVideoUrl

系統(tǒng)規(guī)定參數(shù)。取值：GetDeviceVideoUrl。

CorpId String 是 252060345870948****

項(xiàng)目ID，在產(chǎn)品控制臺(tái)進(jìn)行創(chuàng)建或者通過(guò)CreateCorp來(lái)進(jìn)行創(chuàng)建。
DeviceId String 否 1101050001132700****

設(shè)備ID
StorageType String 否 0

視頻源。取值范圍：

0：存儲(chǔ)在VCS云端

1：存儲(chǔ)在設(shè)備本地

默認(rèn)為0
StartTime Long 否 1599807533000

開(kāi)始時(shí)間，timestamp格式，毫秒。
EndTime Long 否 1600081668000

結(jié)束時(shí)間，timestamp格式，毫秒。
OutProtocol String 否 hls

流播放協(xié)議，取值范圍：

hls

flv

httpshls

httpsflv

rtsp

存儲(chǔ)在設(shè)備本地時(shí)，支持全部協(xié)議；

存儲(chǔ)在VCS云端時(shí)，僅支持 hls 和 httpshls 協(xié)議。

此參數(shù)不傳時(shí)，默認(rèn)為 hls。
GbId String 否 1101050001132700****

已廢棄。設(shè)備國(guó)標(biāo)編碼。請(qǐng)使用DeviceId。

返回?cái)?shù)據(jù)

名稱 類型 示例值 描述
RequestId String 08ebc43f_a815_4ba2_8920_c113b60c66a4

請(qǐng)求ID
Code String 200

請(qǐng)求返回Code
Message String Success

返回結(jié)果消息
OutProtocol String hls

流播放協(xié)議
Url String http://example.com/xxx

視頻回放URL

示例

請(qǐng)求示例

http(s)://[Endpoint]/?Action=GetDeviceVideoUrl
&CorpId=252060345870948****
&DeviceId=1101050001132700****
&StorageType=0
&StartTime=1599807533000
&EndTime=1600081668000
&OutProtocol=hls
&GbId=1101050001132700****
&公共請(qǐng)求參數(shù)

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<GetDeviceVideoUrlResponse>
    <RequestId>08ebc43f_a815_4ba2_8920_c113b60c66a4</RequestId>
    <Code>200</Code>
    <Message>Success</Message>
    <OutProtocol>hls</OutProtocol>
    <Url>http://example.com/xxx</Url>
</GetDeviceVideoUrlResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "08ebc43f_a815_4ba2_8920_c113b60c66a4",
  "Code" : "200",
  "Message" : "Success",
  "OutProtocol" : "hls",
  "Url" : "http://example.com/xxx"
}

錯(cuò)誤碼

訪問(wèn)錯(cuò)誤中心查看更多錯(cuò)誤碼。