# 使用定制训练模型运行示例应用程序

它以一个经过定制训练的 YoloV8 模型为例。

前提条件

1. 设置可扩展 SDK（eSDK）来开发应用程序/插件代码。

    如需了解更多设置 eSDK 以及下载和编译源代码的详细信息，请参阅 [Qualcomm Intelligent Multimedia 软件开发包 (IM SDK) 快速入门指南](https://docs.qualcomm.com/bundle/publicresource/topics/80-70022-51/introduction.html)。
2. 关于下载源代码和编译定制参考应用程序的说明，请参阅 [开发您自己的 AI/ML 应用程序](https://docs.qualcomm.com/doc/80-70022-15BY/topic/develop-your-own-application.html)。
3. [下载 Qualcomm Neural Processing SDK 的模型和标签文件](https://docs.qualcomm.com/doc/80-70022-15BY/topic/classify-objects-with-default-model.html#download-model-files)。

## 使用定制训练的 YoloV8 LiteRT 模型

Qualcomm IM SDK 示例程序使用 YoloV8 模型进行目标检测。此示例说明了如何尝试自定义经训练的 YoloV8 变体。

按以下步骤操作，通过现有示例程序来运行用户自己的定制训练的 YoloV8 模型。

1. 将示例程序中的现有模型替换为新模型。
2. 使用定制标签来修改标签文件。
3. 使用示例程序来运行修改后的模型。

### 修改标签

当使用 Qualcomm IM SDK 及其参考应用程序时，这些应用程序需要 JSON 格式的标签。您需要更新此标签文件中每个标签的 `<ID value>`、`<color value>` 和 `<label value>` 值。

标签文件中每个标签的格式应遵循下方所示的模板。

[
       {"id":  0, "color": "0x00FF00FF", "label": "person"}
    ]
    Copy to clipboard

例如：

[
       {"id":  0, "color": "0x00FF00FF", "label": "person"},
       {"id":  1, "color": "0x00FF00FF", "label": "bicycle"},
       {"id":  2, "color": "0x0000FFFF", "label": "car"},
       {"id":  3, "color": "0x00FF00FF", "label": "motorcycle"}
    ]
    Copy to clipboard

### 使用定制模型运行对象检测

如需使用 TFLite runtime 运行目标检测模型，可在命令行参数中指定定制训练模型以及定制标签文件，然后运行以下命令。

1. 将模型复制到设备。

scp yolov8_custom.tflite root@<IP address of the target device>:/etc/models/
        Copy to clipboard
2. 将标签复制到设备。

scp yolov8_custom.json root@<IP address of the target device>:/etc/labels/
        Copy to clipboard
3. 登录设备。

ssh root@<IP address of the target device>
        Copy to clipboard
4. 修改如图所示的 `/etc/configs/config_detection.json` 文件。

{
        "file-path": "/etc/media/video.mp4",
        "ml-framework": "tflite",
        "yolo-model-type": "yolov8",
        "model": "/etc/models/yolov8_custom.tflite",
        "labels": "/etc/labels/yolov8_custom.json",
        "threshold": 40,
        "runtime": "dsp"
        }
        Copy to clipboard
5. 运行以下命令启用 Weston 服务：

export XDG_RUNTIME_DIR=/dev/socket/weston && export WAYLAND_ DISPLAY=wayland-1
        Copy to clipboard
6. 运行示例应用程序。

gst-ai-object-detection --config-file=/etc/configs/config_detection.json
        Copy to clipboard

说明

- 要显示可用的帮助选项，请运行以下命令：

gst-ai-object-detection -h
        Copy to clipboard
- 要停止用例，请使用 <kbd class="kbd compound docutils literal notranslate"><kbd class="kbd docutils literal notranslate">CTRL</kbd>+<kbd class="kbd docutils literal notranslate">C</kbd></kbd>。

Last Published: Nov 05, 2025

[Previous Topic
使用默认模型对对象进行分类](https://docs.qualcomm.com/bundle/publicresource/80-70022-15BY/topics/classify-objects-with-default-model.md) [Next Topic
使用 Qualcomm Device Cloud 运行示例应用程序](https://docs.qualcomm.com/bundle/publicresource/80-70022-15BY/topics/sample-app-qdc.md)