> ## 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 应用

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

<Note>
  目前,Qdemo 应用不支持通过 GUI 启动器图标启动。请使用设备终端启动 Qdemo 应用。QDemo 仅在 server 构建中提供。
</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 平铺网格中播放,形成 4 路视频墙显示。 |

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

## 前提条件

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

## 使用 Qdemo 运行示例应用

<Steps>
  <Step title="连接鼠标、键盘和 HDMI 显示器,然后为设备通电">
    将鼠标、键盘和 HDMI 显示器连接到设备,然后为其通电。
  </Step>

  <Step title="打开目标设备 shell">
    ```shell theme={null}
    ssh ubuntu@<IP address of the target device>
    ```
  </Step>

  <Step title="安装所需的依赖项">
    ```shell theme={null}
    sudo apt-get install -y libgstreamer1.0-dev gstreamer1.0-libav gstreamer1.0-alsa gstreamer1.0-gtk3
    ```

    ```shell theme={null}
    sudo apt-get install -y python3-gi-cairo gir1.2-gtk-3.0
    ```
  </Step>

  <Step title="创建所需的文件夹并设置所有者">
    创建 media、labels、models 和 data 文件夹,并将所有者更改为 ubuntu:ubuntu:

    ```shell theme={null}
    sudo mkdir -p /etc/media/ /etc/labels/ /etc/models/ /etc/data/
    ```

    ```shell theme={null}
    sudo chown -R ubuntu:ubuntu /etc/media/ /etc/labels/ /etc/models/ /etc/data/
    ```
  </Step>

  <Step title="下载所需的资源">
    ```shell theme={null}
    wget -P /etc/media/ https://raw.githubusercontent.com/qualcomm/sample-apps-for-qualcomm-linux/refs/heads/main/scripts/download_artifacts.sh
    ```

    ```shell theme={null}
    wget -P /etc/media/ https://raw.githubusercontent.com/qualcomm/sample-apps-for-qualcomm-linux/refs/heads/main/qualcomm-linux/artifacts/qdemo/Qdemo.gif
    ```

    ```shell theme={null}
    wget -P /etc/media/ https://raw.githubusercontent.com/qualcomm/sample-apps-for-qualcomm-linux/refs/heads/main/qualcomm-linux/artifacts/qdemo/Qdemo.png
    ```
  </Step>

  <Step title="从设备终端启动 Qdemo 应用">
    ```shell theme={null}
    gst-gui-launcher-app.py
    ```

    **Experience Application Demo** 窗口将弹出。
  </Step>

  <Step title="选择 Wi-Fi 以连接到网络">
    只有 AI 示例应用需要 Wi-Fi 连接。对于多媒体应用,可跳过此步骤。

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/qualcomm-prod/zh/AI-Developer-Workflow-Ubuntu/_images/qdemo-wifi.png" alt="Qdemo 应用中的 Wi-Fi 选择" />
  </Step>

  <Step title="在 Source 列表中选择所需的摄像头">
    并非所有应用都需要摄像头。如果连接了 USB 摄像头,请从列表中选择它。
    默认选择为 **On-Device-Camera**。
  </Step>

  <Step title="选择一个应用并点击 Start">
    在 **Applications** 列表中,选择一个应用并点击 **Start**。

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

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

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

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/qualcomm-prod/zh/AI-Developer-Workflow-Ubuntu/_images/rb3-sample-output-object-detection_app.png" alt="Qdemo 中 ObjectDetection 应用的示例输出" />
  </Step>

  <Step title="关闭输出窗口以停止示例应用">
    关闭输出窗口以停止示例应用。
  </Step>

  <Step title="选择 Exit 以关闭 Qdemo 应用">
    选择 **Exit** 以关闭 Qdemo 应用。
  </Step>
</Steps>