guidelines-gstreamer-plugin

# 开发定制 GStreamer 插件在尝试编写自己的 GStreamer 插件之前，您需要先熟悉核心概念。 **实施新的 GStreamer 插件的工作流** 如需实现定制插件，您需要： - 决定是从现有的基本模板类继承还是直接从 GstElement 主干类继承。 - 指定 pads、elements 和 caps (capabilities)。 - 实现 init、set\_caps、set\_property、transform 等关键函数。 - 注册插件。主要教程、指南和资源 - 教程： [https://gstreamer.freedesktop.org/documentation/tutorials/index.html?gi-language=c](https://gstreamer.freedesktop.org/documentation/tutorials/index.html?gi-language=c) - 插件编写者指南： [https://gstreamer.freedesktop.org/documentation/plugin-development/index.html?gi-language=c](https://gstreamer.freedesktop.org/documentation/plugin-development/index.html?gi-language=c) - 其他文档： [https://gstreamer.freedesktop.org/documentation/additional/index.html?gi-language=c](https://gstreamer.freedesktop.org/documentation/additional/index.html?gi-language=c) - API 参考： [https://gstreamer.freedesktop.org/documentation/libs.html?gi-language=c](https://gstreamer.freedesktop.org/documentation/libs.html?gi-language=c) - Caps 功能： [https://gstreamer.freedesktop.org/documentation/gstreamer/gstcapsfeatures.html?gi-language=c](https://gstreamer.freedesktop.org/documentation/gstreamer/gstcapsfeatures.html?gi-language=c) - Caps 协商： [https://gstreamer.freedesktop.org/documentation/plugin-development/advanced/negotiation.html?gi-language=c](https://gstreamer.freedesktop.org/documentation/plugin-development/advanced/negotiation.html?gi-language=c) 要点开发新插件时请记住以下要点： - 继承和基类 - 每个 GStreamer 插件要么从基本模板类继承，要么直接从 GstElement 主干类继承。 - GstElement 类可用作一个最小的框架，而开发者负责实现事件处理、查询、缓存管理和其他核心功能。 - 当现有的基本模板类均不符合插件的要求时，开发者可以使用 GstElement 类开始进行开发。 - 基本模板类 - GStreamer 提供了诸多基本模板类，用于处理大多数事件和查询；但是，这些基类不能管理对缓存的处理操作。 - 缓存管理 - 根据所选的基类，开发者必须实施缓存管理并重写相关的虚方法。 - 有些方法有默认实现，而其他方法则仅有虚函数。 - 功能 - Caps 在 GstPadTemplates 上公开，用以指定 pad 支持的媒体类型。 - Pads 采用 caps 来交换有关其支持的格式的信息。连接 pads 的 caps 交集决定了通信所采用的实际数据格式。 - 基类的优点 - 基类提供了虚方法，开发者可以使用定制实现重写这些方法。 - 利用现有基类的功能，开发者可以专注于插件设计所需的特定定制。注释 - 这些说明基于 `imsdk.lnx.2.0.0.r1-rel` 版本。 - 本指南适用于经验丰富的开发者，他们可通过在现有插件的基础上构建 Qualcomm IM SDK 插件来处理不受支持的用例（例如超分辨率）。 - 创建定制 GStreamer 插件是一项进阶任务，只能由经验丰富的 GStreamer 开发者完成。 - 在开源领域和官方 GStreamer 门户上，提供了有关此任务的大量教程。 - 可将本指南用作模板并使用开源资源来了解如何开发定制插件。 Last Published: Oct 23, 2025 [Previous Topic 为定制模型添加后处理支持](https://docs.qualcomm.com/bundle/publicresource/80-70018-15BY/topics/add-postprocessing-support-custom-model.md) [Next Topic 开发超分辨率插件](https://docs.qualcomm.com/bundle/publicresource/80-70018-15BY/topics/development-process-for-new-plugin.md)