linkingvision

Size: px

Start display at page:

Download "linkingvision"

砾居
4 years ago
Views:

2 版本记录版本日期描述 /04/03 第一个版本 /04/25 r /05/05 r /07/014 r6.0 分开 API 和使用文档 h5stream 用户手册, 版本 1.00 页 2

3 h5stream 用户手册, 版本 1.00 页 3

4 内容 1.0 发布说明版本范围参考链接常用术语内容概述内网直播视频源支持运行平台支持直播协议支持视频加密支持云直播软件安装安装准备安装安装 license 配置视频源文件源配置 RTSP RTMP 源配置 ONVIF 源配置云推流模式配置云推流内网服务器配置推流云服务器配置用户管理用户密码修改 WEB 管理界面全认证默认开启标准协议标准协议 URL 规则 h5stream 用户手册, 版本 1.00 页 4

5 1.0 发布说明 1.1 版本 1.00 初始版本. 2.0 范围文档包含 h5stream 互联网直播方案的使用场景, 安装指南, 开发接口定义和使用并介绍了各种浏览器在各个操作提供平台上使用的最佳直播方案, 从而可以实现低延迟视频直播 3.0 参考链接 ONVIF h5stream 用户手册, 版本 1.00 页 5

6 4.0 常用术语 h5stream 用户手册, 版本 1.00 页 6

5.0 内容概述近几年来, 互联网高速发展, 特别是移动互联网, 各种各样的移动 APP 都基于 HTML5 开发 FLASH 技术由于各种各样的问题, 浏览器开始停止支持, 但传统的安防厂家都还在使用 ActiveX 播放视频,ActiveX 目前只支持 IE, 所以如何支持在各种各样的浏览器和 APP 上支持无插件的非 FLASH 的视频播放变得非常重要浏览器原生播放视频的方法各有不同,

7 5.0 内容概述近几年来, 互联网高速发展, 特别是移动互联网, 各种各样的移动 APP 都基于 HTML5 开发 FLASH 技术由于各种各样的问题, 浏览器开始停止支持, 但传统的安防厂家都还在使用 ActiveX 播放视频,ActiveX 目前只支持 IE, 所以如何支持在各种各样的浏览器和 APP 上支持无插件的非 FLASH 的视频播放变得非常重要浏览器原生播放视频的方法各有不同, 安防直播有个基本的要求就是低延迟, 需要延迟控制在 1 秒以内或者 500 毫秒以内这对 HTML5 视频直播技术带来很大的挑战随着云技术的普及, 视频远程播放, 远程分享也非常重要 H5STREAM 解决了 HTML5 原生视频和云视频直播问题,H5STREAM 支持 WEBRTC WEBSOCKET HLS RTMP 播放技术, 下表列举了各种浏览器支持的技术浏览器兼容技术 h5stream 用户手册, 版本 1.00 页 7

8 6.0 内网直播 H5STREAM 是一个支持 Windows Linux(CentOS ubuntu) macos 的直播平台内网直播 6.1 视频源支持 H5STREAM 支持将 MP4/AVI 文件做为视频源从而给用户测试带来很大的方便目前视频监控摄像机都支持 RTSP, 现在 RTMP 还有一定的市场占有率,H5STREAM 很好的支持 RTSP/RTMP 作为视频监控的标准 ONIVF,H5STREAM 也做了支持, 并且允许用户 RESTFUL 接口控制 ONIVF 云台 6.2 运行平台支持 H5STREAM 是一个跨平台的流媒体系统支持多种操作系统部署, 包括 Windows 7/8/10, CentOS ubuntu macos, 并且可以将 H5STREAM 运行在阿里云或者亚马逊 AWS 如果用户量比较大, 还可以基于 NGINX 部署流媒体集群 6.3 直播协议支持 RTMP/RTSP/HLS 是目前比较传统的流媒体协议, 在 H5STREAM 中有很好的支持, 新兴的 h5stream 用户手册, 版本 1.00 页 8

9 WEBSOCKET 和 WEBRTC 也在 H5STREAM 得到很好的支持, 从而可以高性能的解码和获得超低的延迟 6.4 视频加密支持 H5STREAM 支持在浏览器上无插件播放视频的同时, 所有的视频数据都会采用非对称加密, 充分保证的视频数据的安全 h5stream 用户手册, 版本 1.00 页 9

10 7.0 云直播如果用户需要远程访问直播视频, 如果使用传统的 NAT 端口映射或 DDNS, 既麻烦又不安全, H5STREAM 支持云推流的模式, 并且所有码流全部加密, 从而保证了通信安全云直播 h5stream 用户手册, 版本 1.00 页 10

11 8.0 软件安装 8.1 安装准备准备 8.2 安装 Windows 7/8/10, Windows Server 2008/2012/2016, Centos 7, ubuntu16.04, 64 位操作系统, 4G 内存 1 核 CPU 及以上下载安装包从如下链接中下载对应的安装包安装 Windows vs2017 运行支持包 ca89b/vc_redist.x64.exe 如果在 Windows 安装后无法运行, 请下载如下安装包, 注意需要 x64 版本 Visual C++ Redistributable Packages for Visual Studio Visual C++ Redistributable for Visual Studio 如果是 Windows 2012 还不能解决, 请参考如下链接手工运行解压产品包, 并运行 h5ss.bat h5stream 用户手册, 版本 1.00 页 11

12 产品发布包目录如果为 Centos 7 需要升级 libstdc++ 到 libstdc++.so 下载 libstdc++.so 并执行如下命令 cp libstdc++.so /usr/lib64/libstdc++.so.6 如果 /lib64/libstdc++.so.6 文件存在也需要执行如下命令 cp libstdc++.so /lib64/libstdc++.so.6 安装为服务 Windows 可以直接运行 regservice.bat 安装服务或者运行 unregservice.bat 取消安装服务 Centos 7 h5stream 用户手册, 版本 1.00 页 12

04 sudo mkdir -p /usr/lib/systemd/system/ sudo apt install systemd service Linux 性能提升配置 #sudo vi /etc/security/limits.

13 拷贝发布包到 /opt/h5ss cp h5ss.service /usr/lib/systemd/system/ systemctl enable h5ss.service systemctl start h5ss.service Ubuntu sudo mkdir -p /usr/lib/systemd/system/ sudo apt install systemd 拷贝发布包到 /opt/h5ss cp h5ss.service /usr/lib/systemd/system/ systemctl enable h5ss.service systemctl start h5ss.service Linux 性能提升配置 #sudo vi /etc/security/limits.conf 在文件最后加入下面几行 root soft nofile root hard nofile * soft nofile * hard nofile h5stream 用户手册, 版本 1.00 页 13

#sudo vi /etc/sysctl.conf 在文件最后加入下面一行 fs.file-max = 655350 #sudo sysctl -p 8.3 安装 license 在 logs/h5sslog.

14 #sudo vi /etc/sysctl.conf 在文件最后加入下面一行 fs.file-max = #sudo sysctl -p 8.3 安装 license 在 logs/h5sslog.log 中获取 Hostid, 让后把 Hostid 发送给 info@linkingvision.com, 等收到 h5ss.lic license 文件后, 把 h5ss.lic 文件放到 conf 目录下, 然后重新启动 h5ss 即可在生成 Hostid 时请关闭所有虚拟网卡并移走所有 USB 网卡 h5stream 用户手册, 版本 1.00 页 14

15 9.0 配置视频源在程序发布包里有个 conf/h5ss.conf 文件, 可以修改配置完成视频源配置, 当然也可以参考 RESTFUL 接口使用 API 进行配置修改下表列举了所有的配置项配置文件介绍 9.1 文件源配置在视频源配置中,strToken 是视频源的唯一标识, 请保持多视频源时该字符串不要相同在配置文件中修改 ntype 为 H5_FILE, strurl 视频文件路径,linkingvision 官方网站提供了测试视频源可以下载到本地文件源配置 h5stream 用户手册, 版本 1.00 页 15

https://localhost:8443/ h5stream 管理界面或者在 Chrome 中输入

16 修改好配置文件, 重新启动 h5ss.bat, 在 Chrome 中输入或者 h5stream 管理界面或者在 Chrome 中输入或者由于 HTTPS 服务器的证书是自搬的, 需要点击前往 HTTP 视频访问 h5stream 用户手册, 版本 1.00 页 16

17 HTTPS 视频访问如果需要指定特定协议访问, 请使用如下命令格式 RTSP RTMP 源配置在配置文件中把 ntype 修改为 H5_STREAM, 在 strurl 部分填入 RTSP RTMP 地址, 对于需要认证的 RTSP 源, 需要在 struser 和 strpasswd 中填入对应的用户名密码 RTSP 地址中内嵌的用户名密码将不会生效 RTSP/RTMP 源配置 h5stream 用户手册, 版本 1.00 页 17

18 9.3 ONVIF 源配置 ONVIF 配置选项比较多, 但是大部分都可以采用默认配置, 可以只关注下图中标注的部分 ntype 修改为 H5_ONVIF, 配置 ONIVF 用户名密码,ONIVF 设备地址和端口即可 ONVIF 源配置 h5stream 用户手册, 版本 1.00 页 18

10.0 云推流模式配置 10.1 云推流内网服务器配置在配置文件中找到 cloud 部分, 需要开启云模式, 并且配置一下端口, 是否是 HTTPS, 用户名和密码其中 47.75.117.15 为云端服务器的 IP 地址可以参考下图的配置 : 10.

19 10.0 云推流模式配置 10.1 云推流内网服务器配置在配置文件中找到 cloud 部分, 需要开启云模式, 并且配置一下端口, 是否是 HTTPS, 用户名和密码其中为云端服务器的 IP 地址可以参考下图的配置 : 10.2 推流云服务器配置默认云服务器不需要配置就可以接受本地服务器的连接如果在 Cloud 模式下使用 WEBRTC 由于云服务器一般本地没有公网 IP, 公网 IP 都是映射出来的, 需要设置 bcloudmode 和对应的公网 IP 云服务 WEBRTC 需要打开所有 TCP 的端口 ; 如果是阿里云, 需要打开安全组配置, 打开所有的 TCP 端口 h5stream 用户手册, 版本 1.00 页 19

20 11.0 用户管理 11.1 用户密码修改 md5 hash 在配置文件中的密码是 md5 hash, 默认密码是 12345, 如果需要修改密码的话也需要重新 11.2 WEB 管理界面全认证默认开启 h5s WEB 管理界面默认是允许匿名浏览视频的, 如果默认不允许匿名浏览视频的需要修改如下两个参数, http 中的 bauth 改成 true,user 中的 banonymousview 改成 false h5stream 用户手册, 版本 1.00 页 20

21 h5stream 用户手册, 版本 1.00 页 21

22 12.0 标准协议 12.1 标准协议 URL 规则所有通过配置文件和 API 加入到 h5s 的 src, 除了支持 js 视频播放库外, 还可以用 RTSP RTMP FLV HLS 客户端直接访问, 如下是以默认端口配置, 并且存在 token1 的 src 的对应的 url RTSP: rtsp://ip:8554/live/token1 RTMP: rtmp://ip:8935/live/token1 FLV: HLS: h5stream 用户手册, 版本 1.00 页 22