@
目录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.2.8.2、配置RTSP流用户密码
- LiveSMS中配置文件中配置
- livesms.ini -> [rtsp]下面添加如下示例配置,示例中 testname 和 testpass 换成您自己的配置
- 重启LiveSMS后生效,如若配置开启这个,播放rtsp流地址要加上用户名密码
格式如:rtsp://用户名:密码@192.168.2.135:554/34020000001110000234_34020000001320000234
...
[rtsp]
username=testname
password=testpass
...
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管理后台的,国标设备菜单界面中可以查看到设备列表