> ## 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.

# 使用 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          | 使用 Record live video 应用先前录制的 MP4 文件，以 2×2 拼贴网格播放，实现四分格视频墙显示。 |

有关可用应用的完整列表，请参见 [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-prod/WwC9kmcnKl9Ef7de/Key-Documents/AI-Developer-Workflow/_images/qdemo-screen.png?fit=max&auto=format&n=WwC9kmcnKl9Ef7de&q=85&s=dae8ab1f6b1b17cfcea39eb37fee1f60" alt="显示器上的 Qdemo 启动屏幕" width="720" height="480" data-path="Key-Documents/AI-Developer-Workflow/_images/qdemo-screen.png" />

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

   <img src="https://mintcdn.com/qualcomm-prod/WwC9kmcnKl9Ef7de/Key-Documents/AI-Developer-Workflow/_images/terminal-qdemo-screen.png?fit=max&auto=format&n=WwC9kmcnKl9Ef7de&q=85&s=a61b6fa6b8ed64994443a1c34081f075" alt="Qdemo 屏幕上的 Weston 终端图标" width="517" height="346" 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-prod/WwC9kmcnKl9Ef7de/Key-Documents/AI-Developer-Workflow/_images/rb3-qdemo-wi-fi.png?fit=max&auto=format&n=WwC9kmcnKl9Ef7de&q=85&s=62c1adf289b89461494438a6e7a12086" alt="Qdemo 应用中的 Wi-Fi 选择" width="605" height="525" 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-prod/WwC9kmcnKl9Ef7de/Key-Documents/AI-Developer-Workflow/_images/rb3-sample-output-object-detection_app.png?fit=max&auto=format&n=WwC9kmcnKl9Ef7de&q=85&s=a9a009ac2822cdcdbf72f40ad7073d9c" 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 应用。
