# AI USB 摄像头
Source: [https://docs.qualcomm.com/doc/80-70020-50SC/topic/ai-usb-camera.html](https://docs.qualcomm.com/doc/80-70020-50SC/topic/ai-usb-camera.html)
**gst-ai-usb-camera-app** 从连接到 Qualcomm EVK 的 USB 网络摄像头传输视频流。该网络摄像头应可作为 /dev/videoX设备访问。此外，您还可以执行目标检测并预览结果。
您可以选择在 Wayland 上预览输出，或编码为视频文件，或通过 RTSP 进行实时流传输。
或者，您可以将 `enable-object-detection ` 设置为 *True* 以执行目标检测。
下图展示了处理 USB 摄像头输入以生成各种输出的 pipeline。
有关这些 pipeline 中使用的插件的更多信息，请参见 [Pipeline 流](https://docs.qualcomm.com/doc/80-70020-50SC/topic/ai-usb-camera.html#ai-usb-camera__section_jjq_bln_42c)。
Figure : gst-ai-usb-single-camera-app pipeline
Figure : 带目标检测的 gst-ai-usb-single-camera-app pipeline
## 示例模型和标签文件
| Runtime | 模型文件 | 标签文件 |
| --- | --- | --- |
| Qualcomm Neural Processing SDK |
- yolonas.dlc
- yolov5.dlc
- yolov8.dlc
|
- yolonas.labels
- yolov8.labels
- yolov5.labels
- yolox.labels
|
| LiteRT |
yolov8_det_quantized.tflite
- yolonas_quantized.tflite
- yolov5.tflite
- yolox_quantized.tflite
|
- yolonas.labels
- yolov8.labels
- yolov5.labels
- yolox.labels
|
| Qualcomm AI Engine Direct | *yolov8\_det\_quantized.bin* |
- yolonas.labels
- yolov8.labels
- yolov5.labels
- yolox.labels
|
| | | |
| | | |
## 前提条件
- 确保[下载并安装 eSDK](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-51/install-sdk.html#download-and-install-esdk-)（如果尚未安装）。
- 将模型和标签文件推送到设备以运行应用程序。相关说明，可参见[下载模型和标签文件](https://docs.qualcomm.com/doc/80-70020-50SC/topic/download-model-and-label-files.html)。
该应用程序支持 Qualcomm Neural Processing SDK、Qualcomm AI Engine Direct 和
LiteRT 模型。
- 要访问您的主机，请设置 SSH。有关说明，请参阅[使用 SSH 登录](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-254/how_to.html#use-ssh)。
Note: 如果已设置 SSH，则可以跳过此步骤。
- 从 Linux 主机推送模型文件：
scp root@:/etc/modelsCopy to clipboard
- 请注意，[下载的脚本](https://docs.qualcomm.com/doc/80-70020-50SC/topic/download-model-and-label-files.html)会将示例 video.mp4 视频下载到 /etc/media 目录。如果您使用的是自定义视频，请确保将视频推送到 /etc/media，并在应用程序的 config.JSON 文件中更新文件路径。
- 使用 HDMI 端口将显示器连接到设备。有关说明，请参见[设置 HDMI 显示器](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-18/samples.html)。
- 激活显示器：
export XDG_RUNTIME_DIR=/dev/socket/weston && export WAYLAND_DISPLAY=wayland-1Copy to clipboard
如果您遇到摄像头或显示器问题，请参阅[摄像头故障排查](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-17/troubleshooting.html)和[显示器故障排查](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-18/debug.html)。
- 确保 USB 网络摄像头已连接至设备。
Note: 如果设备未检测到 USB 摄像头，请下载所需的固件。请参阅[下载 PCIe 转 USB 控制器固件](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-8/pcie.html#download-pcie-to-usb-controller-firmware)。
## 运行应用程序
示例应用程序使用 /etc/configs/config-usb-camera-app.json文件读取输入参数。确保使用 config JSON 文件运行应用程序。
要创建自己的 config JSON 文件，请使用 [config-usb-camera-app.json](https://git.codelinaro.org/clo/le/platform/vendor/qcom-opensource/gst-plugins-qti-oss/-/blob/imsdk.lnx.2.0.0.r2-rel/gst-sample-apps/gst-ai-usb-camera-app/config-usb-camera-app.json?ref_type=heads) 作为参考。
1. 使用以下格式的 /etc/configs/config-usb-camera-app.json文件：
{
"width": "",
"height": "",
"framerate": "",
"video-format": "",
"output": "