Skip to content

Latest commit

 

History

History
69 lines (45 loc) · 3.93 KB

pipeline_client_visualization.md

File metadata and controls

69 lines (45 loc) · 3.93 KB
Raw

pipeline_client可视化

简介

sophon-pipeline配套客户端，用来显示实时流和检测结果。

下载安装

  • windows，可使用编译好的pipeline_client-winx64.zip，下载方式：
python3 -m dfss [email protected]:sophon-pipeline/pipeline_client-winx64.zip

使用条件

  • 客户端(pipeline_client运行的设备)和服务端(sophon-pipeline例程程序运行的设备)必须网络连通，可参考以下方式测试网络连通性：
    1. 端口号配置为一个未被占用的端口(可使用netstat等命令查看)；
    2. 输入 ping {ip}，测试网络的连通情况；
    3. 输入telnet {ip} {port}，测试网络的连通情况；
  • 运行可用pipeline_client可视化的例程(video_stitch、multi不使用pipeline_client)

参数说明

使用pipeline_client，需要正确配置视频流的参数。其中，参数说明如下：

参数 说明
input url 拉流地址。支持tcp、rtsp
Channel Num 拉流路数，默认为1
Use Same URL pipeline_client内部是否使用所填input url进行解析。默认为不使用。不建议使用此选项，如果需要使用此选项，需要对pipeline_client内部以及tcp、rtsp解析规则有所了解。
Stream Format 拉流的格式。默认为h264
Pixel Format 拉流的像素格式，默认为yuv420p
Width 拉流视频的宽度，默认为1920
Height 拉流视频的高度，默认为1080

运行

假设运行pipeline_client所在的设备ip为123.45.67.89，端口9527未被占用

TCP

  1. 必须先启动pipeline_client，填入本机的ip和端口：tcp://123.45.67.89:9527
  2. 服务端配置.json的output_path参数为tcp://123.45.67.89:9527，运行sophon-pipeline例程程序
  3. 稍等片刻，pipeline_client可见画面

RTSP

若使用rtsp，要配合一个rtsp server使用。先推流到rtsp server，pipeline_client再拉流。

rtsp server推荐使用：

开源仓库：https://github.com/bluenviron/mediamtx

或者直接下载release可执行程序：https://github.com/bluenviron/mediamtx/releases

注意：rtsp-simple-server、pipeline_client、sophon-pipeline例程程序运行的设备须网络连通。建议rtsp-simple-server和pipeline_client运行在同一台设备上。

具体步骤如下：(假设运行rtsp-simple-server和pipeline_client的设备ip为123.45.67.89)

  1. 启动rtsp server：./mediamtx，默认端口为8554，如果需要修改端口，请自行从.yml文件修改，请确保启动前该端口未被占用。
  2. 运行sophon-pipeline例程程序，推流到指定rtsp地址：.json的output_path参数配置为rtsp://123.45.67.89:8554/abc
  3. 运行pipeline_client，拉流地址指定为rtsp://123.45.67.89:8554/abc
  4. 稍等片刻，pipeline_client可见画面

注意：由于pipeline_client在解析rtsp地址时，在地址末尾会强制附带Channel Num信息，如果显示N路视频，上述实例地址将被解析出N个地址：rtsp://123.45.67.89:8554/abc_{X}，其中{X}为从0到N-1的自然数。如果显示1路视频，上述实例地址将被解析为rtsp://123.45.67.89:8554/abc_0，如果地址配置为rtsp://123.45.67.89:8554，那么pipeline_client将解析为rtsp://123.45.67.89:8554_0，pipeline_client将拉流失败。因此output必须配置为形如rtsp://{ip}:{port}/{string}，而不能只配置rtsp://{ip}:{port}。