github.com/cnotch/ipchub@v1.1.0/docs/quickstart.md (about)

     1  ## 1. 安装
     2  即拷即用,根据自己的操作系统版本拷贝相应的可执行文件。
     3  
     4  ## 2. 配置
     5  服务器需要配置自己的摄像头拉流。
     6  默认配置拉流的路由信息在:routetable.json中;详细参考配置文档说明。
     7  
     8  以下是一个典型的例子:
     9  ``` json
    10  [
    11  	{
    12          "pattern": "/group/door",
    13          "url": "rtsp://admin:888888@192.168.110.250:8554/H264MainStream",
    14          "keepalive":true
    15      },
    16      {
    17          "pattern": "/hr/",
    18          "url": "rtsp://admin:admin@192.168.110.145:1554",
    19  		"keepalive": false
    20  	}
    21  ]
    22  ```
    23  
    24  我们配置了两个路由:
    25  + /group/door : 集团大门直接连接到摄像头
    26  + /hr/ : 人力资源部门的摄像头路由到下级的服务器
    27      假设下级服务器有 /door/video1 和 /door/video2 两个摄像头,那么你可以通过 .../hr/door/video1 和 .../hr/door/video2 访问它们。
    28  
    29  ## 3. 访问流媒体
    30  服务器提供了多种访问终端摄像头的方式,包括:
    31  + rtsp
    32  + websocket-rtsp
    33  + http-flv
    34  + websocket-flv
    35  + http-hls
    36  
    37  下面我们分别使用不同的方式访问上面两个路由的摄像头。
    38  
    39  ### 3.1 使用rtsp访问
    40  ```
    41  ffplay -rtsp_transport tcp  rtsp://localhost:1554/group/door -fflags nobuffer
    42  ffplay -rtsp_transport udp  rtsp://localhost:1554/group/door -fflags nobuffer
    43  ffplay -rtsp_transport udp_multicast  rtsp://localhost:1554/group/door -fflags nobuffer
    44  ```
    45  上面分别使用了 TCP、UDP、multicast 等三种 rtsp 播放模式。
    46  
    47  要访问hr的/door/video1,只要将/group/door换成/hr/door/video1即可。
    48  
    49  ```
    50  ffplay -rtsp_transport tcp  rtsp://localhost:1554/hr/door/video1 -fflags nobuffer
    51  ```
    52  
    53  rtsp://localhost:1554/hr/door/video1 请求在服务器内自动变成去拉取rtsp://admin:admin@192.168.110.145:1554/door/video1。
    54  
    55  ### 3.2 使用websocket-rtsp
    56  打开demo地址:http://localhost:1554/demos/rtsp
    57  
    58  输入:ws://localhost:1554/ws/group/door 即可访问。
    59  
    60  ### 3.3 使用http-flv访问
    61  打开demo地址:http://localhost:1554/demos/flv
    62  
    63  输入:http://locaolhost:1554/streams/group/door.flv 即可访问。
    64  
    65  **注意:**由于 Chrome 对长连接的流限制为6个,因此如果使用 Chrome 打开更多建议使用websocket-flv。
    66  
    67  ### 3.4 使用 websocket-flv访问
    68  打开demo地址:http://localhost:1554/demos/flv
    69  
    70  输入:ws://locaolhost:1554/ws/group/door.flv 即可访问。
    71  
    72  ### 3.5 使用 http-hls访问
    73  由于 iOS的Safari不支持上述任何http访问模式,请使用 http-hls
    74  
    75  在浏览器输入: http://localhost:1554/streams/group/door.m3m8 即可访问。
    76  
    77  **注意:** 由于http-hls的段文件默认被放在内存中,占用大量的内存;如系统内存不足,请配置存储路径。
    78  
    79  ### 3.6 访问 h265 flv
    80  打开demo地址:http://localhost:1554/demos/flv265
    81  
    82  输入:http://locaolhost:1554/streams/group/door.flv 即可访问。
    83  
    84  ## 4. 需要授权的情况
    85  除rtsp外,其他使用token进行访问。
    86  如果 http-flv,
    87  输入:http://locaolhost:1554/streams/group/door.flv?token=7f97509e321a18ccf281607f4c0bd4fb
    88  
    89  其中 token 通过登录api获得的相关信息请参考[配置文档](config.md) 和 [Api 文档](apis.md)。
    90  
    91  ## 5. 浏览器支持情况
    92  http-flv、websocket-flv、websocket-rtsp等浏览器访问,支持:
    93  + Firefox v.42+
    94  + Chrome v.23+
    95  + OSX Safari v.8+
    96  + MS Edge v.13+
    97  + Opera v.15+
    98  + Android browser v.5.0+
    99  + IE Mobile v.11+
   100  
   101  不支持 iOS Safari 和 IE。