X-Link API 文档-V4.0.0

简体中文

English

简体中文

English

Appearance

请求历史流 ​

  1. 视频回放:用户根据查询回来的录像列表,可以播放历史视频流

  2. 录像下载:需要把请求参数的isDownload设置为true,同时调用获取上传进度接口获取设备上传进度,当100时,再调用录像下载接口,下载文件到本地

  3. 视频回放和录像下载不能同时操作同一台设备的同一通道

接口信息

请求地址: /web_api/v1/media/history_video ​

请求类型: GET ​

Content-Type:x-www-form-urlencoded ​

请求参数 ​

字段类型必选说明
vehicleNostring是车牌号
channelNointeger是通道号
isSubCodebool否是否为子码流
startTimeinteger是开始时间,UTC时间戳
endTimeinteger是结束时间,UTC时间戳
mediaTypeinteger否媒体类型 0:音视频,1:音频,2:视频
storageTypeinteger否存储器类型 1:主存储器,2灾备存储器
playTypeinteger否回放方式0;正常回放;l:快进回放:2 : 关键帧快退回放;3:关键帧播放;4:单帧上传
speedinteger否倍速 0:无效,1:1倍,2:2 倍,3:4 倍,4:8 倍,5:16 倍
isDownloadbool否是否为为下载,如不是下载,不需要生成mp4

响应Data ​

字段类型说明
zlmStreamIDstring拉流ID,用于其它接口获取流信息
zlmTalkStreamIDstring推流ID,用来推对讲流
rtmpstringRTMP 拉流URL
rtmpsstringRTMP 加密拉流URL
rtspstringRTSP 拉流URL
rtspsstringRTSP 加密拉流URL
httpFlvstringHTTP-FLV 拉流URL
httpFlvsstringHTTP-FLV 加密 拉流URL
wsFlvstringwebsocket 拉流URL
wsFlvsstringwebsocket加密 拉流URL
webRTCstringwebRTC拉流URL
webRTCsstringwebRTC 加密 拉流URL
talkWebRTCstring对讲推送的流 URL
talkWebRTCsstring对讲推送的流 URL(加密)

示例 ​

请求示例 ​

url
http://localhost:8080/web_api/v1/media/history_video?vehicleNo=13000000005&channelNo=1&isSubCode=true&startTime=1699026825&endTime=1699028383&mediaType=0&storageType=0&playType=0&speed=1&_t=1699065906071
http://localhost:8080/web_api/v1/media/history_video?vehicleNo=13000000005&channelNo=1&isSubCode=true&startTime=1699026825&endTime=1699028383&mediaType=0&storageType=0&playType=0&speed=1&_t=1699065906071

响应示例 ​

json
{
    "hdr":{
        "code":200
    },
    "data":{
        "zlmStreamID":"7296322783548543480",
        "zlmTalkStreamID":"",
        "rtmp":"rtmp://localhost:7206/play/7296322783548543480",
        "rtmps":"rtmps://localhost:7206/play/7296322783548543480",
        "rtsp":"rtsp://localhost:7207/play/7296322783548543480",
        "rtsps":"rtsps://localhost:7207/play/7296322783548543480",
        "httpFlv":"http://localhost:7205/play/7296322783548543480.live.flv",
        "httpFlvs":"https://localhost:443/play/7296322783548543480.live.flv",
        "wsFlv":"ws://localhost:7205/play/7296322783548543480.live.flv",
        "wsFlvs":"wss://localhost:443/play/7296322783548543480.live.flv",
        "webRTC":"http://localhost:7205/index/api/webrtc?app=play&stream=7296322783548543480&type=play",
        "webRTCs":"https://localhost:443/index/api/webrtc?app=play&stream=7296322783548543480&type=play",
        "talkWebRTC":"",
        "talkWebRTCs":""
    }
}
{
    "hdr":{
        "code":200
    },
    "data":{
        "zlmStreamID":"7296322783548543480",
        "zlmTalkStreamID":"",
        "rtmp":"rtmp://localhost:7206/play/7296322783548543480",
        "rtmps":"rtmps://localhost:7206/play/7296322783548543480",
        "rtsp":"rtsp://localhost:7207/play/7296322783548543480",
        "rtsps":"rtsps://localhost:7207/play/7296322783548543480",
        "httpFlv":"http://localhost:7205/play/7296322783548543480.live.flv",
        "httpFlvs":"https://localhost:443/play/7296322783548543480.live.flv",
        "wsFlv":"ws://localhost:7205/play/7296322783548543480.live.flv",
        "wsFlvs":"wss://localhost:443/play/7296322783548543480.live.flv",
        "webRTC":"http://localhost:7205/index/api/webrtc?app=play&stream=7296322783548543480&type=play",
        "webRTCs":"https://localhost:443/index/api/webrtc?app=play&stream=7296322783548543480&type=play",
        "talkWebRTC":"",
        "talkWebRTCs":""
    }
}

应答成功后拉流播放 ​

对于H5页面,如果想要简单的话,可以直接用flvjs来播放,使用方法用户自己查询
这边目前是采用webrtc播放,公网测试大概在700ms的延时,如果需要,后续可以提供jssdk
西瓜flv的使用文档,使用方法可以点击查看