PipeWire

PipeWire 是一个处理多媒体管道的服务器和用户空间 API。它包括：

• 提供视频源（如来自捕获设备或应用程序提供的流）并将其与客户端复用。
• 访问视频源以供使用。
• 生成音频和视频处理图。

图中的节点可以作为单独的进程实现，通过套接字通信并使用文件描述符传递来交换多媒体内容。

构建和安装

安装 PipeWire 的首选方式是使用你的发行版包管理系统进行安装。这可以确保 PipeWire 与系统的其他部分集成，以获得最佳体验。

如果你想自己构建和安装 PipeWire，请参阅 install 获取说明。

使用

PipeWire 最重要的目的是运行你喜欢的应用程序。

一些应用程序使用原生 PipeWire API，例如大多数合成器（gnome-shell、wayland 等）用于实现屏幕共享。这些应用程序将自动正常工作。

大多数音频应用程序可以使用 ALSA、JACK 或 PulseAudio 作为后端。PipeWire 提供了对这三种后端的支持。根据你的发行版配置，这应该会自动工作或通过下面显示的提供的脚本工作。

PipeWire 可以使用环境变量来控制应用程序的行为：

• PIPEWIRE_DEBUG=<级别> 增加调试级别（或使用 XEWIDT 中的一个，分别表示无、错误、警告、信息、调试或跟踪）。
• PIPEWIRE_LOG=<文件名> 将日志重定向到文件名
• PIPEWIRE_LOG_SYSTEMD=false 禁用向 systemd 日志记录
• PIPEWIRE_LATENCY=<分子/分母> 将延迟配置为分数。10/1000 配置为 10ms 延迟。通常这表示为采样率的分数，如 256/48000，表示在 48KHz 采样率下使用 256 个样本，延迟为 5.33ms。此功能不会尝试配置采样率。
• PIPEWIRE_RATE=<分子/分母> 为图配置速率。
• PIPEWIRE_QUANTUM=<分子/分母> 将延迟配置为分数和采样率。此功能将强制图的采样率为 分母，并强制指定 分子 作为缓冲区大小。
• PIPEWIRE_NODE=<id> 请求链接到指定节点。id 可以是目标节点的 node.name 或 object.serial。

使用工具

pw-cat 可用于播放和录制音频和 MIDI。使用 pw-cat -h 获取更多帮助。有一些别名如 pw-play 和 pw-record 可以使操作更容易：

$ pw-play /home/wim/data/01.\ Firepower.wav

运行 JACK 应用程序

根据系统的配置方式，你可以选择并行运行 PipeWire 和 JACK，或者让 PipeWire 完全接管 JACK 的功能。

在双模式下，JACK 应用程序默认使用 JACK 服务器。要将 JACK 应用程序定向到 PipeWire，你可以使用 pw-jack 脚本，如下所示：

$ pw-jack <应用程序名>

如果你已经用 PipeWire 完全替换了 JACK，pw-jack 将不起作用，可以省略。

JACK 应用程序将自动使用服务器选择的缓冲区大小。你可以通过设置 PIPEWIRE_LATENCY 环境变量来强制最大缓冲区大小（延迟），如下所示：

PIPEWIRE_LATENCY=128/48000 jack_simple_client

请求 jack_simple_client 以 128 个或更少样本的缓冲区运行。

运行 PulseAudio 应用程序

PipeWire 可以运行兼容 PulseAudio 的替代服务器。你不能同时使用两个服务器。通常，你的包管理器会使服务器产生冲突，因此你只能安装其中一个。

PulseAudio 应用程序仍然使用常规的 PulseAudio 客户端库，你只需要更改服务器实现即可。

可以通过检查以下命令的输出来验证服务器是否成功切换：

pactl info

它应该包含以下字符串：

...
服务器名称：PulseAudio（在 PipeWire 0.3.x 上）
...

您可以使用pavucontrol来更改配置文件和端口、调整音量或重定向音频流，就像使用PulseAudio一样。

运行ALSA应用程序

如果安装了PipeWire alsa模块，可以通过以下命令查看：

$ aplay -L

ALSA应用程序可以使用"pipewire:"设备来将PipeWire作为音频系统。

运行GStreamer应用程序

PipeWire包含两个名为"pipewiresrc"和"pipewiresink"的GStreamer元素。它们可以在管道中使用，例如：

$ gst-launch-1.0 pipewiresrc ! videoconvert ! autovideosink

或者播放哔哔声：

$ gst-launch-1.0 audiotestsrc ! pipewiresink

PipeWire还提供了设备监视器，因此

$ gst-device-monitor-1.0

会显示PipeWire设备，像cheese这样的应用程序会在可能的情况下自动使用PipeWire视频源。

检查PipeWire状态

要通过GUI检查和操作PipeWire图，您可以使用Helvum。

或者，您可以使用优秀的JACK工具之一，如"Carla"、"catia"、"qjackctl"等。 但是，您将无法看到所有功能，如视频端口。

"pw-mon"可以转储和监控PipeWire守护进程的状态。

"pw-dot"可以转储管道的图形，查看帮助以了解如何操作。

"pw-top"监控图形的实时状态。这对于查找正在运行的客户端及其使用的DSP资源量很有用。

"pw-dump"以JSON格式转储PipeWire守护进程的状态。这可用于查找PipeWire守护进程中对象的属性和参数。

还有一个更复杂的工具"pw-cli"用于检查服务器状态。此工具可以交互使用，也可以执行单个命令，例如获取服务器信息：

$ pw-cli info 0

文档

在这里可以找到教程和设计文档。

（不完整的）自动生成的API文档在这里。

Wiki可以在这里找到。

贡献

PipeWire是自由软件，并在开放环境中开发。它主要采用MIT许可证。查看LICENSE以了解更多关于例外情况的详细信息。

鼓励贡献者在gitlab上提交合并请求或报告错误。

在OFTC的#pipewire频道加入我们的IRC讨论。

我们遵守行为准则中的贡献者公约。

使用Liberapay捐赠。

获取帮助

您可以在IRC频道（见上文）寻求帮助。您也可以通过提出gitlab问题来询问问题。