X-Link API 文档-V4.0.0

简体中文

English

简体中文

English

Appearance

请求实时流 ​

用户先通过此接口获取播放的url,接口会响应多种拉流协议url,用户自行根据自己的需求去创建播放器拉流

接口信息

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

请求类型: GET ​

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

请求参数 ​

字段类型必选说明
vehicleNostring是车牌号
channelNointeger是通道号
isSubCodebool否是否为子码流

响应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/realtime_video?vehicleNo=13000000005&channelNo=1&isSubCode=true&_t=1699064763458
http://localhost:8080/web_api/v1/media/realtime_video?vehicleNo=13000000005&channelNo=1&isSubCode=true&_t=1699064763458

响应示例 ​

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

应答成功后拉流播放 ​

对于H5页面,如果想要简单的话,可以直接用flvjs来播放,使用方法用户自己查询
由于http最多只能播放6个视频,建议使用ws来播放,优先级别:webrtc > wss > https 这边目前是采用webrtc播放,公网测试大概在700ms的延时,如果需要,后续可以提供jssdk
西瓜flv的使用文档,使用方法可以点击查看