groundlight/stream

Groundlight Stream Processor

一个容器化的Python应用，使用Groundlight https://github.com/groundlight/python-sdk%E5%A4%84%E7%90%86%E6%9D%A5%E8%87%AA%E8%A7%86%E9%A2%91%E6%96%87%E4%BB%B6%E3%80%81%E8%AE%BE%E5%A4%87%E6%88%96%E6%B5%81%E7%9A%84%E5%B8%A7%E3%80%82

目录

• Groundlight Stream Processor
  • 目录
  • 下载
  • 使用方法
  • 示例
    • 使用本地MP4文件运行
    • 使用*** URL
    • 连接RTSP流
  • 延伸阅读

下载

在任何安装了Docker的系统上都可以轻松使用此应用。

shell
$ docker pull docker.xuanyuan.run/groundlight/stream

使用方法

命令行选项如下所示：

shell
$ docker run -it groundlight/stream -h
usage: python -m stream -t TOKEN -d DETECTOR [options]

Groundlight Stream Processor

一个命令行工具，用于从视频源捕获帧并将其发送到Groundlight检测器进行分析。

支持多种输入源，包括：
- 视频设备（网络摄像头）
- 视频文件（mp4等）
- RTSP流
- YouTube视频
- 图像目录
- 图像URL

选项：
  -h, --help            显示此帮助消息并退出
  -t TOKEN, --token TOKEN
                        用于身份验证的Groundlight API令牌。
  -d DETECTOR, --detector DETECTOR
                        要发送ImageQueries的检测器ID。
  -e ENDPOINT, --endpoint ENDPOINT
                        要目标的API端点。例如，可以指向边缘端点代理服务器（https://github.com/groundlight/edge-endpoint）。
  -s STREAM, --stream STREAM
                        视频源。设备ID、文件名或URL。默认为设备ID '0'。
  -x {infer,device,directory,rtsp,youtube,file,image_url}, --streamtype {infer,device,directory,rtsp,youtube,file,image_url}
                        源类型。默认为'infer'，将尝试根据--stream设置此值。
  -f FPS, --fps FPS     捕获的帧率（0表示最大速率）。默认为1 FPS。
  -v, --verbose         启用调试日志。
  -m, --motion          启用运动检测，默认禁用。
  -r THRESHOLD, --threshold THRESHOLD
                        运动检测阈值（变化的像素百分比）。默认为1%。
  -p POSTMOTION, --postmotion POSTMOTION
                        检测到运动后捕获的秒数。默认为1秒。
  -i MAXINTERVAL, --maxinterval MAXINTERVAL
                        即使没有运动，帧之间的最大间隔秒数。默认为1000秒。
  -w RESIZE_WIDTH, --width RESIZE_WIDTH
                        调整宽度（像素）。
  -y RESIZE_HEIGHT, --height RESIZE_HEIGHT
                        调整高度（像素）。
  -c CROP, --crop CROP  裁剪区域，指定为每个维度的分数（0-1）（例如'0.25,0.2,0.8,0.9'）。

使用您自己的API令牌和检测器ID开始发送帧并获取预测和标签：

shell
docker run docker.xuanyuan.run/groundlight/stream \
    -t api_29imEXAMPLE \
    -d det_2MiD5Elu8bza7sil9l7KPpr694a \
    -s https://www.youtube.com/watch?v=210EXAMPLE \
    -f 1

示例

使用本地MP4文件运行

要处理本地MP4文件的帧，需要将主机上的文件挂载到Docker容器中。操作步骤如下：

1. 将您的MP4文件（例如video.mp4）放在主机上的目录中，例如/path/to/video。
2. 运行Docker容器，挂载包含视频文件的目录：

shell
docker run -v /path/to/video:/videos docker.xuanyuan.run/groundlight/stream \
    -t api_29imEXAMPLE \
    -d det_2MiD5Elu8bza7sil9l7KPpr694a \
    -s /videos/video.mp4 \
    -f 1

此命令将主机上的/path/to/video目录挂载到容器内的/videos目录。-s参数设置为容器内MP4文件的路径（/videos/video.mp4）。

使用*** URL

通过将视频URL传递给-s参数，可以使用*** URL将帧发送到检测器：

shell
# 国际空间站的实时视频（NASA官方流）
YOUTUBE_URL="https://www.youtube.com/watch?v=xAieE-QtOeM"

docker run docker.xuanyuan.run/groundlight/stream \
    -t api_29imEXAMPLE \
    -d det_2MiD5Elu8bza7sil9l7KPpr694a \
    -s "${YOUTUBE_URL}" \
    -f 1

将YOUTUBE_URL替换为您感兴趣的***视频URL。

连接RTSP流

要连接来自摄像头或其他源的RTSP流，您需要特定于设备的RTSP URL。查看本文档前面的说明以获取您的摄像头的RTSP URL。

获取RTSP URL后，将其传递给-s参数：

shell
docker run docker.xuanyuan.run/groundlight/stream \
    -t api_29imEXAMPLE \
    -d det_2MiD5Elu8bza7sil9l7KPpr694a \
    -s "rtsp://username:password@camera_ip_address:554/path/to/stream" \
    -f 1

将RTSP URL替换为您的摄像头或流设备特定的URL。

延伸阅读

• https://github.com/groundlight/stream
• 摄像头类型 展示了如何获取许多流行摄像头品牌的RTSP流URL。
• 开发说明 讨论了此代码的构建和维护方式。