跳到主要内容

🧪 运行示例应用

本指南面向探索AI和多媒体功能的开发人员和工程师设计，概述了前提条件、设置步骤和故障排除提示，以确保顺利执行和最佳性能。 下面的每个标签页都提供了针对特定用例的详细说明。

🎯 开发者目标​

  • 通过各种用例和设备功能获得快速的开箱即用体验
  • 在Ubuntu上使用高Qualcomm® 智能多媒体产品(QIMP) SDK运行示例应用程序

👤 适用人群​

  • 探索多媒体功能的AI开发者和应用工程师。

✅ 前提条件​

在目标设备上​

  • 已刷入Ubuntu操作系统
  • 具有适当权限的终端访问。
  • 运行install_ppa_pkgs.sh脚本以安装必要的软件包

💡 提示： 在启动示例应用之前，确保您的系统满足所有前提条件。

分步说明​

步骤1：下载并运行工件脚本​

此脚本将自动获取运行示例应用程序所需的所有组件，包括：

  • 模型
  • 标签
  • 媒体文件

📦 脚本详情​

您可以在SSH终端/SBC终端上运行以下命令

cd /home/ubuntu 
curl -L -O https://raw.githubusercontent.com/quic/sample-apps-for-qualcomm-linux/refs/heads/main/download_artifacts.sh
sudo chmod +x download_artifacts.sh 
sudo ./download_artifacts.sh -v GA1.5-rel -c QCS6490

📘 说明​

  • 使用-v参数定义您要使用的版本（例如，GA1.5-rel）。
  • 使用-c参数定义您的设备使用的芯片组（例如，QCS6490）。

步骤2：验证模型/标签/媒体文件​

在启动任何示例应用程序之前，确保所需文件已就位。

✅ 检查以下目录：​

  • 模型文件 → /etc/models/
  • 标签文件 → /etc/labels/
  • 媒体文件 → /etc/media/

📌 注意： 这些文件对于AI和多媒体应用程序的正常运行至关重要。如果缺失，请重新运行工件下载脚本。

步骤3：示例应用程序​

输入源 – 媒体文件；输出源 - Waylandsink​
模型精度 - 量化模型；运行时 - TFLite；使用的脚本 - JSON​

对于多媒体示例应用程序，请确保已连摄像头（前提条件）​

示例应用名称详情AI Hub模型（默认）
gst-ai-classification图像分类Inception_v3
gst-ai-pose-detection姿态检测hrnet_pose
gst-ai-segmentation图像分割Deeplabv3_plus_mobilenet
gst-ai-monodepth视频单目深度midas
gst-ai-face-detection人脸检测face_det_lite
gst-camera-single-stream-example单摄像头流NA
gst-multi-camera-example多摄像头流NA
gst-activate-deactivate-streams-runtime-example在运行中激活-停用流NA

使用SSH/SBC终端启动您的示例应用程序。

📌 注意： 如果终端是root用户，则需要设置以下环境。否则对于Ubuntu用户则不需要。 export XDG_RUNTIME_DIR=/run/user/$(id -u ubuntu)

示例​

gst-ai-classification

要显示可用的帮助选项，请在SSH shell中运行以下命令：

gst-ai-classification -h

步骤5:​

按CTRL + C停止用例。

参考文档：​

要进一步探索示例应用程序，请参阅高通智能多媒体SDK（IM SDK）参考指南。高通智能多媒体SDK（IM SDK）参考​