LiveQing

LiveNVR Onvif/RTSP流媒体服务使用说明书

简介

LiveNVR能够通过简单的网络摄像机通道配置，将传统监控行业里面的高清网络摄像机IPCamera、NVR等具有RTSP/Onvif协议输出的设备接入到LiveNVR，LiveNVR能够将这些设备源的音/视频数据进行采集、转换、输出，进行全平台终端直播（PC、Android、iOS、微信、H5），并且LiveNVR能够将视频源的直播数据对接到第三方CDN网络，实现安防设备互联网级别的直播分发。

主要功能

1. 通过RTSP协议接入摄像机

2. 支持Onvif协议，支持云台控制，焦距缩放

3. 全平台（web/Android/iOS/微信/H5）观看，支持RTMP、HLS协议

4. 支持CDN接入，直接在每一个通道配置填写独立的阿里云/腾讯云CDN的RTMP推流地址即可

5. 支持全网页配置管理

6. 支持用户管理，权限验证

7. 支持录像点播、录像计划、时间录像检索播放

8. 支持分屏展示

使用的端口

默认WEB端口：10800 (TCP) 默认RTMP端口：10935 (TCP)

说明

其他网络访问需开放上面两个端口

端口可以根据需要在 livenvr.ini 中配置修改

[base_config] -> port=10800

[base_config] -> rtmp_port=10935

使用

下载安装

下载LiveNVR服务器版本，解压软件

注意：不能解压到有中文目录的路径中

启动 | 停止服务

  • Windows

说明

第一种方式启动后停止：选中窗口 Ctrl+C

第二种方式启动后停止: windows服务中停止

  • Linux
#解压目录下执行
#启动：
./start.sh
#停止：
./stop.sh

登录服务

在浏览器中访问LiveNVR部署的机器地址，端口默认为10800（http://ip:10800），跳转到登陆页面，默认用户名/密码为admin/admin

登陆后进入主页，这时视频广场是空的，因为还没有进行通道配置

通道配置

点击通道配置进入通道配置页，可以选择需要配置的通道右上角的设置按钮

弹出配置页，并输入接入摄像机的IP地址、端口、RTSP地址、用户名、密码、按需直播等选项，支持Onvif控制的可以填入Onvif地址，配置完成后点击确定。

如果摄像机接入RTSP地址选项中可以配置账号和密码的尽量在这个url里面配置好账号和密码，地址格式正确就可以正常访问。而在配置项里面给出的摄像机用户名和摄像机密码选项是为了兼容有些url里面不能带有用户名和密码。两个并不冲突。

在RTSP协议上，由于各个厂家都有不同的处理方法，比如：海康、大华、雄迈、宇视、天地伟业等厂家的RTSP地址规则有所区别。

RTSP配置规则

大华产品 rtsp://username:password@ip:port/cam/realmonitor?channel=1&subtype=0

  • username: 用户名
  • password: 密码
  • ip: 为设备IP
  • port: 端口号默认为554，默认554时可不填写
  • channel: 通道号，起始为1。例如通道2，则为channel=2
  • subtype: 码流类型，主码流（subtype=0），辅码流（subtype=1）

示例： rtsp://admin:admin@127.0.0.1:554/camera/monitor?channel=1&subtype=1

海康-预览取流-旧版规则（2012年之前的设备只持旧版规则） rtsp://<username>:<password>@<ipaddress>:<port>/<videotype>/ch<id>/<streamtype>/av_stream

  • username: 用户名
  • password: 密码
  • ipaddress: 设备IP
  • port: 端口号默认为554，默认可不填写
  • videotype：视频编码格式，如：h264、mpeg4
  • ch: 通道号，起始为1。例如通道1，则为ch1
  • streamtype: 码流类型，主码流（main），辅码流（sub）

示例： rtsp://admin:admin@127.0.0.1:554/h264/ch1/main/av_stream 示例： rtsp://admin:admin@127.0.0.1:554/mpeg4/ch2/sub/av_stream

海康-预览取流-新版规则 rtsp://<username>:<password>@<ipaddress>:<port>/Streaming/Channels/<id>(?parm1=value1&parm2=value2)

  • username: 用户名
  • password: 密码
  • ipaddress: 设备IP
  • port: 端口号默认为554，默认可不填写
  • id：通道号+0+码流类型 码流类型：1-主码流、2-子码流、3-第三码流；如 1202 表示第12通道子码流
  • parms 其他入参 如 transportmode=unicast (默认单播）transportmode=multicast (多播)

示例：rtsp://admin:admin@127.0.0.1:554/Streaming/Channels/101

海康-回放取流 rtsp://<username>:<password>@<ipaddress>:<port>/Streaming/tracks/<id>(?parm1=value1&parm2=value2)

  • username: 用户名
  • password: 密码
  • ipaddress: 设备IP
  • port: 端口号默认为554，默认可不填写
  • id：通道号+0+码流类型 码流类型：1-主码流、2-子码流、3-第三码流；如 1202 表示第12通道子码流
  • parms 其他入参 如 starttime=20131013t093812z&endtime=20131013t104816z ；具体格式是YYYYMMDD”T”HHmmSS.fraction”Z”，Y是年，M是月，D是日，T是时间分格符，H是小时，M是分，S是秒，Z是可选的、表示Zulu(GMT) 时间

示例：rtsp://admin:admin@127.0.0.1:554/Streaming/tracks/101?starttime=20180902t123812z&endtime=20180902t124816z

可以使用VLC进行试播:

视频编码格式必须为H264

按需直播

其中，需要特别提到“按需直播”选项，勾选按需直播选项就表示，有人通过LiveNVR观看的时候，LiveNVR才会向源端拉取直播音视频数据进行直播分发，没人看的时候，就会自动停止从设备拉流以节省网络资源，本选项默认为否，不按需直播的情况下，手机客户端、微信客户端会有一个比较好的体验；

Onvif发现以及探测

LiveNVR支持Onvif发现以及探测，在配置时选择Onvif，勾选Onvif探测，点击探测IP输入框时，会出现发现的Onvif摄像机，选中要配置的摄像机

通过官方工具校验onvif是否探测出结果

我们可以通过“ONVIF Device Test Tool工具” 来自主排查探测不出结果是的原因否在于LiveNVR;

ONVIF Device Test Tool 使用；

1.打开该软件，选择本机的IP为192.168.1.130（自动显示），点击Discover Devices按钮后，将支持Onvif协议的同一个局域网内的前端设备搜索的地址搜索出来，显示在下方，右上方为获取的每个设备的相应信息。

2.选择其中一台设备测试，点击check按钮，读取响应的IPC信息，如下方所示。

3.点击Get按钮，可以读取IPC的视频流信息，见右边的大框里。

备注：如果该工具可以顺利完成上述步骤探测出结果，LiveNVR依然探测不出结果，请联系技术人员

输入Onvif登陆用户名密码，点击探测，会将探测到的摄像机参数填充进配置窗口

对于有音频需求的可以通过勾选“开启音频”来进行设置：默认没有音频，有需要，勾选上并保存配置即可

通道启用

配置完成后，将需要启用的摄像机设置成启用（也可以通过配置页面来通道启用）

视频广场

点击视频广场页面，刚才配置的摄像机就会出现在列表中

观看视频

点击即可观看实时视频

使用分享页

为方便客户在网页中集成播放功能, 我们单独提供了可供 HTML iframe 集成的分享页, 形如:

http://ip:port/play.html?channel=xx

其中 URL 参数:

  • channel 通道号

  • aspect 配置只显示视频播放区域, 同时指定宽高比, 可选, wxh, 例如 640x360, 即16:9, 当 aspect=fullscreen 时, 整页显示播放器

  • share 是否显示分享, 可选, yes/no, 默认值为 yes

  • fluent 是否以流畅模式播放, 可选, yes/no, 默认值为 yes

  • autoplay 是否自动播放, 可选, yes/no, 默认值为 yes

  • controls 是否显示播放器控制栏, 可选, yes/no, 默认值为 yes

  • stretch 是否拉伸显示, 可选, yes/no, 默认值为 no

  • muted 是否播放器静音, 可选, yes/no, 默认值为 yes

  • protocol 播放流格式, 可选, rtmp/hls/flv/ws_flv, 默认 auto check

Onvif控制

如果是Onvif类型接入的摄像机，同时摄像机也支持云台控制，则可以在网页页面上进行云台控制、焦距缩放等调用：

为啥我的页面上没有这个控制按钮：因为在这个摄像机通道配置中，摄像机接入类型必须是 Onvif 类型，摄像机才能有控制功能，前端页面的按钮才会显示出来；

对于有录像需求的用户，4.0版本LiveNVR在之前版本录像的基础上进一步完善了录像功能，新增了录像计划功能。具体操作方式：

录像及查询

通道配置页面拥有录像开启和保存时间配置选项，根据自身计划选择对应录像时间

拥有便捷的录像查看界面

拥有时间轴和录像列表两种回看模式同时支持对应的录像文件下载

参数配置

本地配置页面用于配置LiveNVR运行参数，包括RTMP端口、快照时间间隔、播放页面是否需要用户权限验证等

注意：这里的配置尽量不要改动，例如RTMP端口，改动了LiveNVR还需要改动nginx目录中的conf/liveqing.conf配置文件，变动RTMP分发的端口才行


客户端观看

LiveNVR独立运行，通过端口映射方式，将LiveNVR服务对外需要的10800和10935两个端口通过路由器进行端口映射到公网，再通过公网地址进行访问就可以了；

高级配置(仅限开发运维人员使用)

注：本节描述内容仅限专业开发人员，请勿随意配置！

  • LiveNVR提供一套完备接口供开发者调用，接口文档查看方式：浏览器访问 IP:10800/apidoc；

  • 通常情况下LiveNVR前端自动适配了PC Web采用了低延时的RTMP直播协议播放，其他平台采用的都是H5标准的HLS直播协议的，如果在PC上也需要采用纯H5无插件播放的方式，我们可以修改LiveNVR.ini中的flash_stream_type字段为 1 来限定直播协议为HLS：

      flash_stream_type=0

服务器硬件配置

服务器配置

接入其他服务-方案拓展

接入LiveNVS

说明

接入LiveNVS是LiveNVR的方案拓展，根据项目需求选择，非必须。

可以通过LiveNVS管理多个LiveNVR服务。

在LiveNVR服务页面中配置LiveNVR 接入

接入LiveQing云平台

说明

接入云平台是LiveGBS服务的方案拓展，根据项目需求选择，非必须。

LiveNVR可以将通道接入到LiveQing，通过LiveQing的云平台服务实现：云端录像存储、计划等。

1. LiveQing流媒体服务安装启动

2. 云平台服务-设备接入->添加设备

3. 获取LiveNVR接入配置

云平台服务-设备接入->编辑

4. 配置livenvr.ini

直接将copy的几行复制到 livenvr.ini配置文件末尾即可

5. 启动 | 重启LiveNVR服务

重启操作：停止后再启动

6. 接入设备状态查询（上线约15s）

7. LiveNVR设备查询（注册上来约60秒）

这个时间间隔可以在liveqing.ini 中配置，iot_sync_duration= 60， 默认是60秒

8. 开启云端录像

默认是不开启的，可以点击开启

开启后会自动在 云直播服务-鉴权直播 页面中创建

9. 停止云端录像