> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs.qualcomm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Qualcomm® Qdemo

Qualcomm® Qdemo 应用程序提供了一个图形界面，用于探索由 Qualcomm Intelligent Multimedia Product（QIMP）SDK 驱动的多媒体和 AI 示例应用程序。Qdemo 专为在基于 Ubuntu 的 Dragonwing 开发板上工作的开发者设计，无需手动编写 GStreamer 代码即可快速评估 AI 管线和多媒体能力。得益于 QIMP 的零拷贝架构，这些应用程序利用 GPU 和 NPU 加速展示了实时性能。QIMP SDK 处理视频采集、缩放、裁剪、推理和渲染等任务——全部通过 GStreamer 插件进行编排，例如：

* `qtivtransform`：在 GPU 上加速颜色转换、裁剪和缩放。
* `qtimltflite`：在 NPU 上执行 TensorFlow Lite 模型。

这样的设置使开发者可以专注于评估性能和能力，而不是底层实现。

要开始在您的 Dragonwing 设备上探索 Qdemo，请按照以下分步说明安装所需的依赖项、配置系统并启动图形界面。

**前提条件：**\
在启动 Qdemo 之前，请确保目标设备满足以下所有前提条件：

* 完成设备设置
* 确保 IQ‑9075 设备正在运行 Ubuntu Server 操作系统
* **已启用 SBC 模式**，并连接了鼠标、键盘和显示器
* 已连接 **CSI 或 USB 摄像头**
* 设置 Wi-Fi 或以太网并启用 SSH 访问
* 如果尚未安装 PPA 软件包，请执行**安装所需软件包**步骤。

## 安装所需软件包

要安装所需的预构建软件包，请参阅[**🔗安装所需软件包**](../devices/iq9075-evk/Install_required_software_packages)章节，并运行提供的"Install PPA Packages"脚本。

## 安装依赖项

打开终端，安装 QDemo 所需的以下软件包：

```shell theme={null}
sudo apt-get install -y libgstreamer1.0-dev gstreamer1.0-libav gstreamer1.0-alsa gstreamer1.0-gtk3
sudo apt-get install -y python3-gi-cairo gir1.2-gtk-3.0
```

## 创建必要的文件夹并下载工件

```shell theme={null}
sudo mkdir -p /etc/media /etc/labels /etc/models /etc/data
sudo chown -R ubuntu:ubuntu /etc/media/ /etc/labels/ /etc/models/ ubuntu:ubuntu /etc/data/
wget -P /etc/media/ https://raw.githubusercontent.com/quic/sample-apps-for-qualcomm-linux/refs/heads/main/scripts/download_artifacts.sh
wget -P /etc/media/ https://raw.githubusercontent.com/quic/sample-apps-for-qualcomm-linux/refs/heads/main/artifacts/qdemo/Qdemo.gif
wget -P /etc/media/ https://raw.githubusercontent.com/quic/sample-apps-for-qualcomm-linux/refs/heads/main/artifacts/qdemo/Qdemo.png  
```

## 从 SBC 终端启动 GUI

```shell theme={null}
gst-gui-launcher-app.py
```

<img src="https://mintlify.s3.us-west-1.amazonaws.com/qualcomm-prod/images/run-sample-applications/QDemo.jpg" alt="" />

## 选择 Wi-Fi 以连接到 Wi-Fi 网络

## Qdemo 支持的示例应用程序列表

您可以将 Source 选择为"On-Device-Camera"或"USB-Camera"，并运行以下示例应用程序：

| 示例应用               | 详情                                        |
| ------------------ | ----------------------------------------- |
| Record live video  | 录制摄像头画面并保存最长 30 秒的视频。                     |
| DashCamera         | 多摄像头流                                     |
| VideoWall          | 对 MP4 AVC（H.264）视频进行并发播放，并在视频墙显示器上进行合成    |
| ObjectDetection    | 目标检测                                      |
| Parallel AI Fusion | 对来自摄像头的输入流执行目标检测、目标分类、姿态检测和图像分割。          |
| Face Detection     | 处理来自摄像头的输入，并使用 Qualcomm® AI Hub 检测模型生成预览。 |
| Daisychain Pose    | 对从摄像头流式传输的图像执行级联的目标检测和分类。                 |
| Multistream        | 对来自摄像头或文件的输入流展示 AI 推理（目标检测）。              |

## 运行 Qdemo 支持的 Multistream 示例应用程序

下方截图显示了 Multistream Qdemo 示例应用程序以八路流运行的输出——一路实时流和七路视频流：

<img src="https://mintlify.s3.us-west-1.amazonaws.com/qualcomm-prod/images/run-sample-applications/Qdemo_multistream.jpg" alt="" />

<Note>
  **注意：**  在 Wayland 输出上，请拉伸 Gtk+ Cairo 渲染器，以确保示例应用程序输出正确显示。
</Note>