gstreamer-rs

GStreamer（视频库）的 Rust 绑定。文档可以在这里找到。

这些绑定提供了一个安全的 API，可用于与 GStreamer 交互，例如编写基于 GStreamer 的应用程序和 GStreamer 插件。

绑定主要是基于 GStreamer 项目提供的基于 gir 和 GObject-Introspection API 元数据的元数据自动生成的。

目录

1. 安装
   1. Linux/BSDs
   2. macOS
   3. Windows
2. 入门指南
3. 许可证
4. 贡献

安装

要构建 GStreamer 绑定或依赖于它们的任何内容，您需要至少安装 GStreamer 1.14 和 gst-plugins-base 1.14。此外，一些示例/教程需要各种 GStreamer 插件可用，这些插件可以在 gst-plugins-base、gst-plugins-good、gst-plugins-bad、gst-plugins-ugly 和/或 gst-libav 中找到。

Linux/BSDs

您需要使用您的发行版的软件包管理器安装上述包，或从源代码构建它们。

在 Debian/Ubuntu 上，可以使用以下命令安装：

$ apt-get install libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev \
      gstreamer1.0-plugins-base gstreamer1.0-plugins-good \
      gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly \
      gstreamer1.0-libav libgstrtspserver-1.0-dev libges-1.0-dev

上述库的最低版本要求是 >= 1.14。如果您构建 gstreamer-player 子 Crates 或任何依赖于 gstreamer-player 的示例，您必须确保除了上述包之外，还安装了 libgstreamer-plugins-bad1.0-dev。有关详细信息，请参阅 Cargo.toml 文件，

$ apt-get install libgstreamer-plugins-bad1.0-dev

其他发行版的包名应类似。请提交一个带有您说明的拉取请求。

macOS

您可以通过Homebrew或安装GStreamer项目提供的二进制文件来安装GStreamer及其插件。

我们建议使用官方的GStreamer二进制文件而不是Homebrew，尤其是由于Homebrew中的GStreamer目前存在问题。

GStreamer二进制文件

您需要从GStreamer网站下载两个.pkg文件并进行安装，例如gstreamer-1.0-1.20.4-universal.pkg和gstreamer-1.0-devel-1.20.4-universal.pkg。

安装后，您还需要按照以下方式设置环境变量PATH

$ export PATH="/Library/Frameworks/GStreamer.framework/Versions/1.0/bin${PATH:+:$PATH}"

请注意，GStreamer中的pkg-config应该在PATH中的第一个，因为其他版本都有各种问题，会导致问题。

Homebrew

Homebrew只有在明确启用的情况下才会安装各种插件，因此可能需要一些额外的--with-*标志。

$ brew install gstreamer gst-plugins-base gst-plugins-good \
      gst-plugins-bad gst-plugins-ugly gst-libav gst-rtsp-server \
      gst-editing-services --with-orc --with-libogg --with-opus \
      --with-pango --with-theora --with-libvorbis --with-libvpx \
      --enable-gtk3

请确保这些库的版本大于等于1.14。

Windows

您可以通过MSYS2中的pacman或安装GStreamer项目提供的二进制文件来安装GStreamer及其插件。

我们建议使用官方的GStreamer二进制文件而不是MSYS2。

GStreamer二进制文件

您需要从GStreamer网站下载适用于您平台的两个.msi文件并进行安装，例如gstreamer-1.0-x86_64-1.20.4.msi和gstreamer-1.0-devel-1.20.4.msi。请确保选择与您的Rust工具链（即MinGW或MSVC）匹配的版本。

安装后，按照以下方式设置环境变量``PATH``

# For a UNIX-style shell:
$ export PATH="c:/gstreamer/1.0/msvc_x86_64/bin${PATH:+:$PATH}"

# For cmd.exe:
$ set PATH=C:\gstreamer\1.0\msvc_x86_64\bin;%PATH%

请确保更新到您实际安装GStreamer和相应工具链的位置。

请注意，GStreamer中的pkg-config.exe应该在PATH中的第一个，因为其他版本都有各种问题，会导致问题。

MSYS2 / pacman

$ pacman -S glib2-devel pkg-config \
      mingw-w64-x86_64-gstreamer mingw-w64-x86_64-gst-plugins-base \
      mingw-w64-x86_64-gst-plugins-good mingw-w64-x86_64-gst-plugins-bad \
      mingw-w64-x86_64-gst-plugins-ugly mingw-w64-x86_64-gst-libav \
      mingw-w64-x86_64-gst-rtsp-server

请确保这些库的版本大于等于1.14。

请注意，包含在MSYS2中的pkg-config版本在编译GStreamer时存在已知问题，因此您可能需要安装另一个版本。一个选择是pkg-config-lite。

入门

API参考可以在这里找到，然而它只提供了Rust API参考，并没有解释任何概念。

要开始进行GStreamer开发，最好的方法是遵循GStreamer网站上的文档，特别是应用程序开发手册。虽然以C语言为中心，但它解释了GStreamer的所有基本概念，并且代码示例应该相对容易翻译成Rust。API基本上是相同的，函数/结构体名称是相同的，并且（希望）一切都将变得更加方便和安全。

此外，GStreamer网站上还有教程。其中许多已经被移植到Rust，代码可以在教程目录中找到。

有关GStreamer的各个方面以及如何从Rust使用它的更多示例可以在示例目录中找到。

可以在gst-plugins-rs存储库中找到用Rust编写的各种GStreamer插件。

许可证

gstreamer-rs和其中包含的所有crates都受以下许可证之一许可：

• Apache许可证2.0版，(LICENSE-APACHE或https://apache.ac.cn/licenses/LICENSE-2.0)
• MIT许可证 (LICENSE-MIT或http://opensource.org/licenses/MIT)

任选其一。

GStreamer本身根据较少的通用公共许可证版本2.1或（根据您的选择）任何更高版本许可：https://gnu.ac.cn/licenses/lgpl-2.1.html

贡献

欢迎以拉取请求的形式提供各种类型的贡献。

除非您明确说明，否则您有意提交给gstreamer-rs的任何贡献，根据Apache-2.0许可证的定义，应如上所述双重许可，不附加任何额外条款或条件。