Files
ipchub/docs/quickstart.md
2020-12-21 14:55:30 +08:00

96 lines
3.1 KiB
Markdown
Executable File
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

## 1. 安装
即拷即用,根据自己的操作系统版本拷贝相应的可执行文件。
## 2. 配置
服务器需要配置自己的摄像头拉流。
默认配置拉流的路由信息在routetable.json中详细参考配置文档说明。
以下是一个典型的例子:
``` json
[
{
"pattern": "/group/door",
"url": "rtsp://admin:888888@192.168.110.250:8554/H264MainStream",
"keepalive":true
},
{
"pattern": "/hr/",
"url": "rtsp://admin:admin@192.168.110.145:1554",
"keepalive": false
}
]
```
我们配置了两个路由:
+ /group/door
集团大门直接连接到摄像头
+ /hr/
人力资源部门的摄像头路由到下级的服务器中hr的服务器包含/door/video1和/door/video2
## 3. 使用
服务器提供了多种访问终端摄像头的方式,包括:
+ rtsp
+ websocket-rtsp
+ wspwebsocket 代理模式)
+ http-flv
+ websocket-flv
+ http-hls
下面我们分别使用不同的方式访问上面两个路由的摄像头
### 3.1 使用rtsp访问
```
ffplay -rtsp_transport tcp rtsp://localhost:1554/group/door -fflags nobuffer
ffplay -rtsp_transport udp rtsp://localhost:1554/group/door -fflags nobuffer
ffplay -rtsp_transport udp_multicast rtsp://localhost:1554/group/door -fflags nobuffer
```
上面分别使用了 TCP、UDP、multicast 等三种方式访问
要访问hr的/door/video1只要将/group/door换成/hr/door/video1即可
```
ffplay -rtsp_transport tcp rtsp://localhost:1554/hr/door/video1 -fflags nobuffer
```
rtsp://localhost:1554/hr/door/video1 请求在服务器内自动变成去拉取rtsp://admin:admin@192.168.110.145:1554/door/video1
### 3.2 使用websocket-rtsp
打开demo地址http://localhost:1554/demos/rtsp
输入ws://localhost:1554/ws/group/door 即可访问
### 3.3 使用wsp访问
和上面一样打开demo地址http://localhost:1554/demos/wsp
输入rtsp://localhost:1554/group/door 即可访问
### 3.4 使用http-flv访问
打开demo地址http://localhost:1554/demos/flv
输入http://locaolhost:1554/streams/group/door.flv 即可访问
由于 Chrome 对长连接的流限制为6个因此如果使用 Chrome 打开更多建议使用websocket-flv
### 3.5 使用 websocket-flv访问
打开demo地址http://localhost:1554/demos/flv
输入ws://locaolhost:1554/ws/group/door.flv 即可访问
### 3.6 使用 http-hls访问
由于 iOS的Safari不支持上述任何http访问模式请使用 http-hls
在浏览器输入: http://localhost:1554/streams/group/door.m3m8 即可访问
**注意:** 由于http-hls的段文件默认被放在内存中占用大量的内存如系统内存不足请配置存储路径。
## 4. 需要授权的情况
除rtsp外其他使用token进行访问
如果 http-flv,
输入http://locaolhost:1554/streams/group/door.flv?token=7f97509e321a18ccf281607f4c0bd4fb
其中 token 通过登录api获得
对于配置用户参考配置和Api文档
## 5. 浏览器支持情况
wsp、http-flv、websocket-flv等浏览器访问支持
+ Firefox v.42+
+ Chrome v.23+
+ OSX Safari v.8+
+ MS Edge v.13+
+ Opera v.15+
+ Android browser v.5.0+
+ IE Mobile v.11+
不支持 iOS Safari 和 IE