# USB 摄像头
Source: [https://docs.qualcomm.com/doc/80-70018-50SC/topic/usb-camera.html](https://docs.qualcomm.com/doc/80-70018-50SC/topic/usb-camera.html)
**gst-ai-usb-camera-app** 从连接到 Qualcomm EVK 的 USB 网络摄像头传输视频流。该网络摄像头应可作为 /dev/videoX 设备访问。您可以执行目标检测并预览结果，该过程也可以在不进行 AI 推理的情况下处理 USB 摄像头的输入。
AI USB 摄像头应用程序使用 /etc/config/config-usb-camera-app.json 文件读取输入参数。
您可以选择使用或不使用 AI 推理来运行此应用。要使用 AI 推理运行此应用程序，请参见 [AI USB 摄像头](https://docs.qualcomm.com/doc/80-70018-50SC/topic/ai-usb-camera.html)。
图中显示了处理 USB 摄像头输入以生成各种输出的 pipeline。
有关这些 pipeline 中使用的插件的更多信息，请参见 [Pipeline 流](https://docs.qualcomm.com/doc/80-70018-50SC/topic/usb-camera.html#use-camera__section_sy3_wd2_ncc)。
Figure : gst-usb-single-camera-app pipeline
## 运行应用程序
运行应用程序前，请完成[前提条件](https://docs.qualcomm.com/doc/80-70018-50SC/topic/ai-usb-camera.html#ai-usb-camera__section_thv_3jy_kbc)。
要在不使用 AI 推理的情况下运行此示例应用程序，请执行以下操作：
1. 使用 [AI USB 摄像头](https://docs.qualcomm.com/doc/80-70018-50SC/topic/ai-usb-camera.html) 中的 config-usb-camera-app.json 文件。
2. 在 config-usb-camera-app.json 文件中，将 `enable-object-detection` 设置为 `FALSE`。
3. 将文件推送到目标设备上的 /etc/configs/ 目录。
4. 运行 gst-ai-usb-camera-app 应用程序：
gst-ai-usb-camera-app --od-config-file=/etc/config/config-usb-camera-app.jsonCopy to clipboard
要显示可用的帮助选项，请在 SSH shell 中运行以下命令：
gst-ai-usb-camera-app -hCopy to clipboard
要停止用例，请按 CTRL + C。
## 预期输出
下表列出了每个用例的预期输出：
Table : gst-ai-usb-single-camera-app 的预期输出 - 不使用 AI
| 用例 | 输出 |
| :--- | :--- |
| 预览 | 摄像头流的预览。请参见 [Figure : gst-usb-single-camera-app 应用程序的预期输出 - 预览](https://docs.qualcomm.com/doc/80-70018-50SC/topic/usb-camera.html#use-camera__fig_ihh_tqq_5bc)。 |
| 保存 MP4 和 YUV 数据 | 将输出保存到 /etc/ 文件夹路径中的文件中。 |
| RTSP | 在远程显示器上查看输出。 |
Figure : gst-usb-single-camera-app 应用程序的预期输出 - 预览
## Pipeline 流
下表列出了USB摄像头流 pipeline 中使用的插件：| Pipeline | 说明 |
| --- | --- |
| 将摄像头 YUV 数据 dump 到 filesink |
- v4l2src 采集摄像头实时流。
- qtivtransform 转换流数据。
- Capsfilter 用于对原始视频数据实施约束。
- Filesink 用于将 YUV 数据 dump 到文件中。
|
| 在显示器上预览 |
- v4l2src 采集摄像头实时流。
- qtivtransform 转换流数据。
- Capsfilter 用于对原始视频数据实施约束。
- 数据将发送到 Wayland 显示器接收端（Waylandsink）进行实时预览。
|
| 视频编码 |
- v4l2src 采集摄像头实时流。
- qtivtransform 转换流数据。
- Capsfilter 用于对原始视频数据实施约束。
- v4l2h264enc 使用 H.264 格式对视频进行编码。
- H264parse 用于渲染视频。
- Mp4mux 用于将视频复用到 MP4 容器中。
- Filesink 用于将视频写入文件。
|
| 视频编码和 RTSP 流传输 |
- qtiqmmfsrc 采集摄像头实时流。
- qtivtransform 转换流数据。
- Capsfilter 用于对原始视频数据实施约束。
- v4l2h264enc 使用 H.264 格式对视频进行编码。
- H264parse 用于渲染视频。
- qtirtspbin 用于将流加载至 RTSP。
|
**Parent Topic:** [运行摄像头示例应用程序](https://docs.qualcomm.com/doc/80-70018-50SC/topic/camera-sample-applications.html)
Last Published: Nov 12, 2025
[Previous Topic
单路摄像头流传输](https://docs.qualcomm.com/bundle/publicresource/80-70018-50SC/topics/gst-camera-single-stream-example.md) [Next Topic
多摄像头流传输](https://docs.qualcomm.com/bundle/publicresource/80-70018-50SC/topics/gst-multi-camera-stream-example.md)