µStreamer 使用教程
项目介绍
µStreamer 是一个轻量级且快速的 MJPEG-HTTP 流服务器,能够从任何 V4L2 设备向网络流式传输视频。它支持现代浏览器和大多数视频播放器,如 mplayer 和 VLC。µStreamer 是 Pi-KVM 项目的一部分,旨在以最高分辨率和 FPS 流式传输 VGA 和 HDMI 屏幕录制硬件数据。
项目快速启动
安装 µStreamer
首先,克隆 µStreamer 仓库:
git clone https://github.com/pikvm/ustreamer.git
cd ustreamer
然后,编译并安装 µStreamer:
make
sudo make install
启动 µStreamer
默认情况下,µStreamer 会尝试打开 /dev/video0
设备,并以 640x480 分辨率在 http://127.0.0.1:8080
上开始流式传输。你可以使用以下命令启动 µStreamer:
ustreamer --device=/dev/video0 --host=0.0.0.0 --port=8080
应用案例和最佳实践
在 Raspberry Pi 上使用 µStreamer
在 Raspberry Pi 上,你可以使用 µStreamer 进行硬件编码。以下是一个示例命令:
ustreamer \
--format=uyvy \
--encoder=m2m-image \
--workers=3 \
--persistent \
--dv-timings \
--drop-same-frames=30
使用 TC358743 捕获设备
如果你使用 TC358743 捕获设备,可以按照以下方式运行 µStreamer:
ustreamer \
--format=uyvy \
--encoder=m2m-image \
--workers=3 \
--persistent \
--dv-timings \
--drop-same-frames=30
典型生态项目
Pi-KVM
µStreamer 是 Pi-KVM 项目的关键组件之一,Pi-KVM 是一个基于 Raspberry Pi 的远程 KVM 解决方案,允许用户远程控制和管理计算机。Pi-KVM 利用 µStreamer 进行视频流式传输,提供高质量的远程控制体验。
Docker 支持
µStreamer 也支持在 Docker 容器中运行。以下是一个示例 Dockerfile:
FROM ubuntu:latest
RUN apt-get update && apt-get install -y \
git \
build-essential \
libjpeg-dev \
libv4l-dev \
&& git clone https://github.com/pikvm/ustreamer.git \
&& cd ustreamer \
&& make \
&& make install
EXPOSE 8080
CMD ["ustreamer", "--device=/dev/video0", "--host=0.0.0.0", "--port=8080"]
你可以使用以下命令构建并运行 Docker 容器:
docker build -t ustreamer .
docker run -p 8080:8080 ustreamer
通过这些步骤,你可以在 Docker 环境中快速部署 µStreamer。