在多个GStreamer Rust插件间共享元数据的实现问题

1. 创建共享元数据Crate #

新建一个库类型的Crate（比如命名为gst-my-shared-meta），专门负责元数据的注册与定义，确保全局仅注册一次：

Cargo.toml 配置 #

[package]
name = "gst-my-shared-meta"
version = "0.1.0"
edition = "2021"

[lib]
crate-type = ["cdylib", "rlib"] # 同时生成动态库和静态库，适配不同引用场景

[dependencies]
gstreamer = { version = "0.22", features = ["v1_20"] }
once_cell = "1.18" # 用于保证元数据仅注册一次

src/lib.rs 核心代码 #

use gstreamer::prelude::*;
use gstreamer::{gst_meta_api_type_register, MetaApiType};
use once_cell::sync::OnceCell;

// 全局静态变量，确保元数据API类型仅初始化一次
static SHARED_META_API_TYPE: OnceCell<MetaApiType> = OnceCell::new();

// 对外暴露获取已注册元数据类型的函数
pub fn get_shared_meta_api_type() -> MetaApiType {
    *SHARED_META_API_TYPE.get_or_init(|| {
        gst_meta_api_type_register(
            "SharedCustomMetaAPI", // 自定义元数据API名称
            &[], // 父API类型，按需填写
        ).expect("Failed to register shared meta API type")
    })
}

// 自定义元数据结构体示例
#[derive(Debug)]
pub struct SharedCustomMeta {
    pub custom_data: u64,
    pub timestamp: u64,
}

// 实现GStreamer的Meta trait
unsafe impl gstreamer::Meta for SharedCustomMeta {
    fn api_type() -> MetaApiType {
        get_shared_meta_api_type()
    }

    fn max_size() -> usize {
        std::mem::size_of::<Self>()
    }
}

2. 在插件Crate中引用共享库 #

每个需要使用该元数据的GStreamer插件，直接依赖这个共享元数据Crate即可，无需重复注册：

插件Cargo.toml 添加依赖 #

[dependencies]
gst-my-shared-meta = { path = "../gst-my-shared-meta" } # 本地路径，发布后可改用版本号
gstreamer = { version = "0.22", features = ["v1_20"] }
# 其他插件所需依赖...

插件代码中使用元数据 #

use gst_my_shared_meta::{get_shared_meta_api_type, SharedCustomMeta};
use gstreamer::buffer::{Buffer, BufferRef};

// 示例：向Buffer添加自定义元数据
fn add_custom_meta(buffer: &mut Buffer) {
    let meta = SharedCustomMeta {
        custom_data: 12345,
        timestamp: gstreamer::ClockTime::now().unwrap().nanoseconds(),
    };
    buffer.add_meta(meta).unwrap();
}

// 示例：从Buffer读取自定义元数据
fn read_custom_meta(buffer: &BufferRef) {
    if let Some(meta) = buffer.get_meta::<SharedCustomMeta>() {
        println!("Custom data: {}, Timestamp: {}", meta.custom_data, meta.timestamp);
    }
}

3. 编译与部署 #

1. 先编译共享元数据库：

   cd gst-my-shared-meta && cargo build --release
   

2. 再编译各个插件Crate：

   cd ../gst-plugin-your-plugin && cargo build --release
   

3. 确保共享库能被插件加载：
   • Linux：将共享库放到/usr/lib/x86_64-linux-gnu/gstreamer-1.0/，或者设置LD_LIBRARY_PATH指向共享库的target/release目录
   • macOS：设置DYLD_LIBRARY_PATH指向共享库目录

关键注意事项 #

• 所有插件和共享库必须使用相同版本的GStreamer依赖，避免ABI兼容性问题
• 元数据的结构体定义、API注册逻辑完全封装在共享库中，插件仅做调用，禁止重复注册
• 如果需要跨插件传递元数据，通过共享库定义的结构体可保证内存布局全局一致

内容的提问来源于stack exchange，提问作者vesuvisian