LiveGBS流媒体平台GB/T28181功能-获取海康大华宇视NVR设备通道视频直播流地址HLS/HTTP-FLV/WS-FLV/WebRTC/RTMP

LiveGBS如何获取接入的海康大华宇视华为摄像头硬件NVR设备通道视频直播流地址HLS/HTTP-FLV/WS-FLV/WebRTC/RTMP/RTSP等视频流集成

1、背景

LiveGBS国标GB/T28181流媒体服务器软件，支持设备|平台GB28181注册接入、向上级联第三方国标平台， 可视化的WEB页面管理(页面源码开源)；支持云台控制、设备录像检索、回放，支持语音对讲，用户管理， 多种协议流输出，实现浏览器无插件直播。

在项目过程中，需要播放视频流。直接在自己的业务系统里面播放。视频集成的方式有几种呢？下面会详细说明2中常见的集成方式。

2、视频流媒体集成

2.1、WEB页面集成

直接集成包含播放器的页面到业务系统中去，如 iframe 方式集成页面。LiveGBS支持集成分享的直播页面，也可以集成云端录像或是设备录像回看页面

2.1、视频流地址播放器集成

通过接口或其它方式获取视频流的地址，设置到web播放器|APP播放器|PC播放器中，进行播放。可以使用LivePlayer.js H5播放器。

3、WEB页面集成说明

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
• token 鉴权 token, 可选, 没有开启分享的通道需要携带登录接口返回的 URLToken

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
• token 鉴权 token, 可选, 没有开启分享的通道需要携带登录接口返回的 URLToken

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
• token 鉴权 token, 可选, 没有开启分享的通道需要携带登录接口返回的 URLToken

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://{cmsip}:{port}/sms/{sms_id}/rtc/{设备国标编号}{通道国标编号}
• FLV: http://{cmsip}:{port}/sms/{sms_id}/flv/hls/{设备国标编号}{通道国标编号}.flv
• WSFLV: ws://{cms_ip}:{port}/sms/{sms_id}/ws-flv/hls/{设备国标编号}{通道国标编号}.flv
• HLS: http://{cmsip}:{port}/sms/{sms_id}/hls/{设备国标编号}{通道国标编号}/live.m3u8
• RTMP: rtmp://{smsip}:{port}/hls/{设备国标编号}{通道国标编号}
• RTSP: rtsp://{smsip}:{port}/{设备国标编号}{通道国标编号}

HTTPS端口直播流地址格式

• WEBRTC: webrtcs://{cmsip}:{port}/sms/{sms_id}/rtc/{设备国标编号}{通道国标编号}
• FLV: https://{cmsip}:{port}/sms/{sms_id}/flv/hls/{设备国标编号}{通道国标编号}.flv
• WSFLV: wss://{cms_ip}:{port}/sms/{sms_id}/ws-flv/hls/{设备国标编号}{通道国标编号}.flv
• HLS: https://{cmsip}:{port}/sms/{sms_id}/hls/{设备国标编号}{通道国标编号}/live.m3u8
• RTMP: rtmp://{smsip}:{port}/hls/{设备国标编号}{通道国标编号}
• RTSP: rtsp://{smsip}:{port}/{设备国标编号}{通道国标编号}

5、相关问题

5.1、接口调用401

LiveGBS流媒体平台GB/T28181常见问题-安全控制HTTP接口鉴权勾选流地址鉴权后401Unauthorized如何播放调用接口

5.2、iframe全屏播放

如何配置iframe允许自动播放和全屏操作

6、搭建GB28181视频直播平台

高稳GB/T28181国标流媒体服务器软件，支持设备|平台GB28181注册接入、向上级联第三方国标平台，可视化的WEB页面管理(页面源码开源)；支持云台控制、设备录像检索、回放，支持语音对讲，用户管理，多种协议流输出，实现浏览器无插件直播

根据GB28181规范，接入设备或是网关平台，在LiveGBS的web管理后台的，国标设备菜单界面中可以查看到设备列表