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

# 通过 Qdemo UI 体验 AI 应用

> 使用 Qdemo 在 Qualcomm Dragonwing IOT 平台上运行 AI 用例

<Note>
  Qdemo 应用目前不支持通过 GUI 启动器图标启动。请在设备终端中使用 `sudo` 启动 Qdemo 应用。
</Note>

Qualcomm Dragonwing™ 平台预装了 Qdemo,这是一个旨在运行 AI 用例的图形用户界面(GUI)应用。使用 Qdemo 应用探索开发套件的 AI 能力。

下表列出了可以使用 Qdemo 运行的 AI 示例应用。

**Qdemo 支持的示例应用**

| 应用                 | 描述                                                           |
| ------------------ | ------------------------------------------------------------ |
| Daisychain Pose    | 对来自摄像头的流执行级联的目标检测和姿态检测。                                      |
| FaceDetection      | 处理来自摄像头的输入,并使用 Qualcomm® AI Hub 检测模型进行人脸检测                   |
| Multistream        | 在来自摄像头或文件的输入流上展示 AI 推理(目标检测)。                                |
| ObjectDetection    | 对来自摄像头的流执行目标检测。                                              |
| Parallel-AI-Fusion | 对来自摄像头的输入流执行目标检测、图像分类、姿态检测和图像分割。                             |
| DashCamera         | 并排显示两个同步的摄像头画面。                                              |
| Record live video  | 从摄像头源录制实时视频,同时显示该视频流并将其保存为 H.264 编码的 MP4 文件(video\_out.mp4)。 |
| VideoTestSrc       | 使用 videotestsrc 渲染 GStreamer 测试图案,适用于在没有物理摄像头的情况下验证显示管线。     |
| VideoWall          | 以 2×2 平铺网格播放之前使用 Record live video 应用录制的 MP4 文件,实现四画面视频墙显示。  |

有关可用应用的完整列表,请参阅 [Qualcomm IM SDK 示例应用](https://imsdkdocs.qualcomm.com/sample-application/ai-sample-applications)。

## 前提条件

* **Qualcomm Linux 多媒体镜像**:设备必须刷写预构建的 Qualcomm Linux 多媒体专有镜像(`qcom-multimedia-proprietary-image`),其中包含 Qdemo 和 Qualcomm IM SDK。
* **HDMI 显示器**:连接到设备以查看 Qdemo 输出。
* **鼠标和键盘**:与 Weston 桌面和 Qdemo 应用交互所必需。
* **Wi-Fi 连接**:AI 示例应用需要从 GitHub 下载模型和标签。多媒体应用不需要。
* **USB 摄像头(可选)**:基于摄像头的示例应用所必需。如果已连接,请在 Qdemo 的 `Source` 列表中选择它。

<Note>
  对于摄像头应用,请在目标设备的终端中运行以下命令以启用 `qticamsrc`:

  ```shell theme={null}
  echo -n "camx" > /var/data
  efivar -n 882f8c2b-9646-435f-8de5-f208ff80c1bd-VendorDtbOverlays -w -f /var/data
  efivar -n 882f8c2b-9646-435f-8de5-f208ff80c1bd-VendorDtbOverlays -p
  sync
  reboot
  ```
</Note>

## 使用 Qdemo 运行示例应用

1. 将鼠标、键盘和 HDMI 显示器连接到设备,然后开机。

   显示器上会出现 **Qdemo 启动屏幕**。

   <img src="https://mintcdn.com/qualcomm-staging/uWQLnBcS9sxlZhgB/Key-Documents/AI-Developer-Workflow/_images/qdemo-screen.png?fit=max&auto=format&n=uWQLnBcS9sxlZhgB&q=85&s=5d8b592a308c6efb88afaed2b89e8596" alt="显示器上的 Qdemo 启动屏幕" width="1705" height="1206" data-path="Key-Documents/AI-Developer-Workflow/_images/qdemo-screen.png" />

2. 在 Qdemo 屏幕上选择 **Weston 终端图标**以打开设备 shell。

   <img src="https://mintcdn.com/qualcomm-staging/uWQLnBcS9sxlZhgB/Key-Documents/AI-Developer-Workflow/_images/terminal-qdemo-screen.png?fit=max&auto=format&n=uWQLnBcS9sxlZhgB&q=85&s=d39e88cab3102ddc1ac8fb0d6dead47c" alt="Qdemo 屏幕上的 Weston 终端图标" width="1705" height="1206" data-path="Key-Documents/AI-Developer-Workflow/_images/terminal-qdemo-screen.png" />

3. 以 root 用户身份登录:

   ```shell theme={null}
   su -p
   ```

   出现密码提示时,输入 `oelinux123`。

4. 从 Weston 终端启动 Qdemo 应用:

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

   将显示 **Experience Application Demo** 窗口。

5. 选择 **Wi-Fi** 以连接到网络。

   只有 AI 示例应用需要 Wi-Fi 连接。对于多媒体应用,请跳过此步骤。

   <img src="https://mintcdn.com/qualcomm-staging/uWQLnBcS9sxlZhgB/Key-Documents/AI-Developer-Workflow/_images/rb3-qdemo-wi-fi.png?fit=max&auto=format&n=uWQLnBcS9sxlZhgB&q=85&s=2e36dbab19d78611015d09a02343e89e" alt="Qdemo 应用中的 Wi-Fi 选择" width="857" height="1206" data-path="Key-Documents/AI-Developer-Workflow/_images/rb3-qdemo-wi-fi.png" />

6. 在 **Source** 列表中,选择所需的摄像头。

   并非所有应用都需要摄像头。如果已连接 USB 摄像头,请从列表中选择它。
   默认选择为 **On-Device-Camera**。

7. 在 **Applications** 列表中,选择一个应用并点击 **Start**。

   应用启动并在屏幕上显示输出。

   <Note>
     首次运行时,应用可能需要一分多钟才能启动,因为它要从 GitHub 下载 AI 模型和标签。
   </Note>

   以下是 ObjectDetection 应用的示例输出:

   <img src="https://mintcdn.com/qualcomm-staging/uWQLnBcS9sxlZhgB/Key-Documents/AI-Developer-Workflow/_images/rb3-sample-output-object-detection_app.png?fit=max&auto=format&n=uWQLnBcS9sxlZhgB&q=85&s=a851e02ca7f639706314fa6dc72a95b5" alt="Qdemo 中 ObjectDetection 应用的示例输出" width="975" height="548" data-path="Key-Documents/AI-Developer-Workflow/_images/rb3-sample-output-object-detection_app.png" />

8. 关闭输出窗口以停止示例应用。

9. 选择 **Exit** 以关闭 Qdemo 应用。
