LiveGBS如何获取接入的海康大华宇视华为摄像头硬件NVR设备通道视频直播流地址HLS/HTTP-FLV/WS-FLV/WebRTC/RTMP/RTSP等视频流集成
1、背景2、视频流媒体集成2.1、页面集成2.1、视频流地址播放集成 3、页面集成说明3.1、 直播分享页集成3.1.1、查看通道3.1.2、开启分享3.1.3、分享页面传参3.1.4、分享页面播放 3.2、时间轴回放分享页集成3.3、电子地图分享页集成 4、视频流地址播放集成说明4.1、获取直播流地址(页面查看)4.2、获取直播流地址(接口调用)4.2.1、实时直播4.2.1.1、开始直播接口说明4.2.1.1、开始直播接口调用示例 4.2.2、前端设备录像4.2.2.1、开始回放接口说明4.2.2.2、开始回放接口调用示例 4.2.3、获取HTTP-FLV直播流地址4.2.4、获取HLS直播流地址4.2.5、获取WebRTC直播流地址4.2.6、获取RTMP直播流地址4.2.7、获取WS-FLV直播流地址4.2.8、获取RTSP直播流地址4.2.8.1、开启RTSP 4.3、获取直播流地址(静态拼接) 5、接口调用相关问题6、搭建GB28181视频直播平台
1、背景
LiveGBS国标GB/T28181流媒体服务器软件,支持设备|平台GB28181注册接入、向上级联第三方国标平台, 可视化的WEB页面管理(页面源码开源);支持云台控制、设备录像检索、回放,支持语音对讲,用户管理, 多种协议流输出,实现浏览器无插件直播。
在项目过程中,需要播放视频流。直接在自己的业务系统里面播放。视频集成的方式有几种呢?下面会详细说明2中常见的集成方式。
2、视频流媒体集成
2.1、页面集成
直接集成包含播放器的页面到业务系统中去,如 iframe 方式集成页面。LiveGBS支持集成分享的直播页面,也可以集成云端录像或是设备录像回看页面
2.1、视频流地址播放集成
通过接口或其它方式获取视频流的地址,设置到web播放器|APP播放器|PC播放器中,进行播放。可以使用LivePlayer.js H5播放器。
3、页面集成说明
3.1、 直播分享页集成
3.1.1、查看通道
上一层的设备可以是一个NVR,一个下级平台,一个单兵设备。点击设备列表的 【查看通道】,可以查看到设备下面具体的视频通道(摄像头)。
3.1.2、开启分享
通道可以配置开启分享, 分享之后,可以获得一个具体的播放页面,分享的是页面地址并非原始流地址。可以直接集成分享页面到自己的业务系统中(通过iframe方式集成)
LiveGBS可以控制单个视频通道 ,是否可以被分享,默认不分享,可以在通道列表中开启分享
3.1.3、分享页面传参
具体的分享页面可以附件的一些参数可以参考:使用分享页面
<!-- 直播 --><iframe src="http://ip:10000/play.html?serial=34020000001110000001&code=34020000001320000001&aspect=fullscreen" allowfullscreen allow="autoplay; fullscreen; microphone;"></iframe>
其中 URL 参数:
serial 设备国标编号
code 通道国标编号
share 是否显示分享, 可选, yes/no, 默认值为 yes
ptz 是否显示云台控制, 可选, yes/no, 默认值为 yes
talk 是否显示对讲麦克风, 可选, yes/no, 默认值为 no
aspect 配置只显示视频播放区域, 同时指定宽高比, 可选, wxh, 例如 640x360, 即16:9, 当 aspect=fullscreen 时, 整页显示播放器
fluent 是否以流畅模式播放, 可选, yes/no, 默认值为 yes
autoplay 是否自动播放, 可选, yes/no, 默认值为 yes
controls 是否显示播放器控制栏, 可选, yes/no, 默认值为 yes
stretch 是否拉伸显示, 可选, yes/no, 默认值为 no
muted 是否播放器静音, 可选, yes/no, 默认值为 yes
protocol 播放流格式, 可选, webrtc/flv/ws_flv/hls/rtmp, 默认 auto check
3.1.4、分享页面播放
手机端可以直接扫码观看,或是 手机浏览器访问分享的直播页面
3.2、时间轴回放分享页集成
同样设备录像和云端录像,也可以通过时间轴页面分享集成到自己的业务系统。通过传递的type 区分是设备录像 还是 云端录像
<!-- 时间轴回放 --><iframe src="http://ip:10000/playback.html?type=device&serial=34020000001110000001&code=34020000001320000001" allowfullscreen allow="autoplay; fullscreen"></iframe>
其中 URL 参数:
type 回放类型, 设备录像/云端录像, 可选, device/cloud, 默认值为 device
serial 设备国标编号
code 通道国标编号
day 当前日期, 可选, YYYYMMDD, 默认值为 当天
minutes 当前时间轴游标位置, 可选, 0~1439, 默认值为 当前时间
calendar 是否显示日历, 可选, yes/no, 默认值为 yes
autoplay 是否自动播放, 可选, yes/no, 默认值为 yes
controls 是否显示播放器控制栏, 可选, yes/no, 默认值为 yes
stretch 是否拉伸显示, 可选, yes/no, 默认值为 no
muted 是否播放器静音, 可选, yes/no, 默认值为 yes
protocol 播放流格式, 设备录像有效, 可选, webrtc/flv/ws_flv/hls/rtmp, 默认 auto check
3.3、电子地图分享页集成
<!-- 电子地图 --><iframe src="http://ip:10000/map.html" allowfullscreen allow="autoplay; fullscreen; microphone;"></iframe>
其中 URL 参数:
serial 设备国标编号, 可选
code 通道国标编号, 可选
trace 是否显示移动轨迹, 可选, yes/no, 默认值为 no
search 是否显示搜索框, 可选, yes/no, 默认值为 yes
ptz 是否显示云台控制, 可选, yes/no, 默认值为 yes
talk 是否显示对讲麦克风, 可选, yes/no, 默认值为 no
fluent 是否以流畅模式播放, 可选, yes/no, 默认值为 yes
autoplay 是否自动播放, 可选, yes/no, 默认值为 yes
controls 是否显示播放器控制栏, 可选, yes/no, 默认值为 yes
stretch 是否拉伸显示, 可选, yes/no, 默认值为 no
muted 是否播放器静音, 可选, yes/no, 默认值为 yes
protocol 播放流格式, 可选, webrtc/flv/ws_flv/hls/rtmp, 默认 auto check
4、视频流地址播放集成说明
获取通道视频直播流地址,下面具体介绍几种获取直播流播放地址的方式。可以使用LivePlayer.js H5播放器播放。
4.1、获取直播流地址(页面查看)
国标设备-》查看通道-》播放
默认播放的 的直播流, 可以点击下面的选项,切换播放的直播流格式
这里的点击播放,实际上是取视频直播流地址,设置到播放器中的,下面会具体说明如何获取视频直播流地址
浏览器跟踪NETWORK浏览器可以 f12 打开开发者模式,再查看通道点击播放,然后在 Network 中跟踪到 api/v1/stream/start 接口调用和结果
4.2、获取直播流地址(接口调用)
4.2.1、实时直播
4.2.1.1、开始直播接口说明
通过调用接口的方式获取直播流地址,具体接口 实时直播 - 开始直播 /api/v1/stream/start
4.2.1.1、开始直播接口调用示例
接口请求示例
http://192.168.2.135:10000/api/v1/stream/start?serial=34020000001110000234&code=34020000001320000234
接口返回示例
{ ... "FLV": "http://192.168.2.135:10000/sms/34020000002020000001/flv/hls/34020000001110000234_34020000001320000234.flv", "HLS": "http://192.168.2.135:10000/sms/34020000002020000001/hls/34020000001110000234_34020000001320000234/34020000001110000234_34020000001320000234_live.m3u8", "RTMP": "rtmp://192.168.2.135:11935/hls/34020000001110000234_34020000001320000234", "RTSP": "rtsp://192.168.2.135:554/34020000001110000234_34020000001320000234", "WS_FLV": "ws://192.168.2.135:10000/sms/34020000002020000001/ws-flv/hls/34020000001110000234_34020000001320000234.flv", "WEBRTC": "webrtc://192.168.2.135:10000/sms/34020000002020000001/rtc/34020000001110000234_34020000001320000234", ....}
4.2.2、前端设备录像
4.2.2.1、开始回放接口说明
通过调用接口的方式获取前端设备录像的直播流地址,具体接口 前端设备录像 - 开始回放/api/v1/playback/start
4.2.2.2、开始回放接口调用示例
接口请求示例
http://192.168.2.135:10000/api/v1/playback/start?serial=34020000001110000234&code=34020000001310000002&starttime=2024-03-08T10%3A50%3A00&endtime=2024-03-08T11%3A00%3A00
接口返回示例
{ ... StreamID: "playback:34020000001110000234:34020000001310000002:1200000109"FLV: "http://192.168.2.135:10000/sms/34020000002020000001/flv/hls/34020000001110000234_34020000001310000002_1200000109.flv"HLS: "http://192.168.2.135:10000/sms/34020000002020000001/hls/34020000001110000234_34020000001310000002_1200000109/live.m3u8"RTMP: "rtmp://192.168.2.135:11935/hls/34020000001110000234_34020000001310000002_1200000109"RTSP: "rtsp://39.98.57.187:554/34020000001110000234_34020000001310000002_1200000109"WEBRTC: "webrtc://192.168.2.135:10000/sms/34020000002020000001/rtc/34020000001110000234_34020000001310000002_1200000109"WS_FLV: "ws://192.168.2.135:10000/sms/34020000002020000001/ws-flv/hls/34020000001110000234_34020000001310000002_1200000109.flv" ....}
4.2.3、获取HTTP-FLV直播流地址
取上面接口返回的 FLV 字段,如:
"FLV": "http://192.168.2.135:10000/sms/34020000002020000001/flv/hls/34020000001110000234_34020000001320000234.flv",
4.2.4、获取HLS直播流地址
取上面接口返回的 HLS 字段,如
"HLS": "http://192.168.2.135:10000/sms/34020000002020000001/hls/34020000001110000234_34020000001320000234/34020000001110000234_34020000001320000234_live.m3u8",
4.2.5、获取WebRTC直播流地址
取上面接口返回的 WEBRTC字段,如
"WEBRTC": "webrtc://192.168.2.135:10000/sms/34020000002020000001/rtc/34020000001110000234_34020000001320000234",
4.2.6、获取RTMP直播流地址
取上面接口返回的 RTMP 字段,对应的 RTMP 端口需要在服务端开放 TCP,如
"RTMP": "rtmp://192.168.2.135:11935/hls/34020000001110000234_34020000001320000234",
4.2.7、获取WS-FLV直播流地址
取上面接口返回的 WS_FLV字段,如
"WS_FLV": "ws://192.168.2.135:10000/sms/34020000002020000001/ws-flv/hls/34020000001110000234_34020000001320000234.flv",
4.2.8、获取RTSP直播流地址
取上面接口返回的 RTSP 字段,如
"RTSP": "rtsp://192.168.2.135:554/34020000001110000234_34020000001320000234",
4.2.8.1、开启RTSP
在基础配置 -> 流媒体服务配置中配置,RTSP端口,对应的 RTSP 端口需要在服务端开放 TCP
4.3、获取直播流地址(静态拼接)
如果需要通过直播流地址直接拉流, 而不是通过开始直播接口, 请开启 基础配置 -》允许直播地址拉流
配置规则如下:
HTTP端口直播流地址格式
WEBRTC: webrtc://{cms_ip}:{port}/sms/{sms_id}/rtc/{设备国标编号}_{通道国标编号}
FLV: http://{cms_ip}:{port}/sms/{sms_id}/flv/hls/{设备国标编号}_{通道国标编号}.flv
WS_FLV: ws://{cms_ip}:{port}/sms/{sms_id}/ws-flv/hls/{设备国标编号}_{通道国标编号}.flv
HLS: http://{cms_ip}:{port}/sms/{sms_id}/hls/{设备国标编号}_{通道国标编号}/live.m3u8
RTMP: rtmp://{sms_ip}:{port}/hls/{设备国标编号}_{通道国标编号}
RTSP: rtsp://{sms_ip}:{port}/{设备国标编号}_{通道国标编号}
HTTPS端口直播流地址格式
WEBRTC: webrtcs://{cms_ip}:{port}/sms/{sms_id}/rtc/{设备国标编号}_{通道国标编号}
FLV: https://{cms_ip}:{port}/sms/{sms_id}/flv/hls/{设备国标编号}_{通道国标编号}.flv
WS_FLV: wss://{cms_ip}:{port}/sms/{sms_id}/ws-flv/hls/{设备国标编号}_{通道国标编号}.flv
HLS: https://{cms_ip}:{port}/sms/{sms_id}/hls/{设备国标编号}_{通道国标编号}/live.m3u8
RTMP: rtmp://{sms_ip}:{port}/hls/{设备国标编号}_{通道国标编号}
RTSP: rtsp://{sms_ip}:{port}/{设备国标编号}_{通道国标编号}
5、接口调用相关问题
LiveGBS国标GB/T28181流媒体平台调用接口时遇到401Unauthorized时怎么办?
6、搭建GB28181视频直播平台
高稳GB/T28181国标流媒体服务器软件,支持设备|平台GB28181注册接入、向上级联第三方国标平台,可视化的WEB页面管理(页面源码开源);支持云台控制、设备录像检索、回放,支持语音对讲,用户管理,多种协议流输出,实现浏览器无插件直播
根据GB28181规范,接入设备或是网关平台,在LiveGBS的web管理后台的,国标设备菜单界面中可以查看到设备列表