「PipeWire」の版間の差分

2021年3月19日 (金) 14:53時点における版

PipeWire は新しい低レベルマルチメディアフレームワークです。映像と音声を最小の遅延で再生/キャプチャすることを目的としていて、PulseAudio、JACK、ALSA、Gstreamerをベースとしたアプリケーションと互換性があります。

このフレームワークのデーモンは (PulseAudio と JACKの機能を持った) オーディオサーバーとしても、ビデオキャプチャサーバーとしても設定できます。

また PipeWire は Flatpak のようなコンテナをサポートしており、audio や video ユーザーグループに依存するのではなく、Flatpak や Wayland にスクリーンや音声を録音する許可を求める Polkit のようなセキュリティモデルを使用しています。

インストール

公式リポジトリの pipewire パッケージをインストールします。

Pipewire は systemd/ユーザーを使用してサーバーの管理とソケットアクティベーションを行います。起動時の動作やログの確認方法などの詳細は systemd/ユーザーを参照してください。

必要に応じて pipewire-docs をインストールしてドキュメントを確認することもできます。 pipewire-alsa、pipewire-pulse、pipewire-jack などの他のパッケージは PulseAudio/JACKの代わりに PipeWire を使用したい場合を除き必要ありません。 multilib サポートのために lib32-pipewire^AUR、lib32-pipewire-jack^AUR も利用できます。

使用方法

WebRTC 画面共有

ほとんどのブラウザは WebRTC を使用しているとき (例えば Google ハングアウトで) デスクトップ (や個々のアプリケーション) をキャプチャするのに X11 に依存していました。 Wayland ではセキュリティ上の理由から画面共有は異なる方法で処理されます。 PipeWire はきめ細かなアクセス制御を使用して Wayland 上のコンテンツを共有できます。

これには xdg-desktop-portal とそのバックエンドの1つが必要です。利用可能なバックエンドは次のとおりです:

GNOME の場合、xdg-desktop-portal-gtk
KDE の場合、xdg-desktop-portal-kde
wlroots ベースのコンポジター (例えば Sway dwl) の場合、xdg-desktop-portal-wlr

Firefox (バージョン84以降) はデフォルトでこの方法をサポートしていますが、Chromium (バージョン73以降) では、WebRTC PipeWireサポートを次のURLの実験的機能の設定を変更して有効にする必要があります:

chrome://flags/#enable-webrtc-pipewire-capturer

xdg-desktop-portal-wlr を動かすには pipewire-media-session をインストール[1]して XDG_CURRENT_DESKTOP 環境変数を設定[2]する必要があります:

export XDG_CURRENT_DESKTOP=sway

Chromium は現在 PipeWire 0.2 を使っていますが、Arch Linux では PipeWire 0.3 を提供しているので、画面共有を行うには libpipewire02 もインストールする必要があります。

ヒント: 複数のモニタがある場合に xdg-desktop-portal-wlr を使用してそれぞれのモニターを共有するには、ユニットのサービスファイルの ExecStart= オプションを編集して --output=Monitor フラグを追加してください。行全体は ExecStart=@libexecdir@/xdg-desktop-portal-wlr --output=eDP-1 のようになります。

唯一サポートされている機能はデスクトップ全体の共有で、特定のアプリケーション/ウィンドウの共有はサポートされていません。[3][4]

映像

ソフトウェアはまだ商業利用には適していませんが、試す分には問題ありません。GStreamer を使用して映像ストリームを処理するほとんどのアプリケーションは PipeWire GStreamer プラグインにより設定なしで動作するはずです。そのため既に cheese のようなアプリケーションは PipeWire を使用して映像入力を利用できます。

音声

PulseAudio や Jack と同様に PipeWire をオーディオサーバーとして使用できます。 PulseAudio サーバーの互換実装と JACK クライアント用の ABI 互換ライブラリを提供することで PulseAudio と Jack の両方を置き換えることを目的としています。詳細についてはこの記事を参照してください。

ALSA/レガシーアプリケーション

pipewire-alsa をインストールして ALSA API を使用するすべてのアプリケーションが PipeWire を使用するよう設定できます。

PulseAudio クライアント

pipewire-pulse をインストールします。このパッケージは pulseaudio と pulseaudio-bluetooth を置き換えます。パッケージがユーザーサービス pipewire-pulse.socket を自動的に有効化するので、通常それ以上の操作は不要です。システム起動時に PipeWire が正しく機能しない場合は、ユーザーサービス pipewire-pulse.service と pipewire.service が起動して実行されているか確認します。 Systemd/ユーザーを参照してください。

変更を適用するには、再起動または再ログインしてください。

置き換えが機能しているかどうかを確認するには、次のコマンドを実行して出力を確認してください:

$ pactl info

...
Server Name: PulseAudio (on PipeWire 0.3.16)
...

JACK クライアント

pipewire-jack をインストールします。pw-jack を使用して JACK クライアントを起動すると、元の libjack* ではなく PipeWire が提供する互換ライブラリが使用されます:

pw-jack application

カスタムバッファサイズを要求することもできます。PIPEWIRE_LATENCY環境変数を バッファサイズ/サンプルレート (ブロックのレイテンシ(秒)を意味します) に設定します:

PIPEWIRE_LATENCY="128/48000" pw-jack application

また pipewire-jack-dropin^AUR をインストールするか、jack か jack 2 をアンインストールして JACK クライアントが互換ライブラリを自動的に読み込むようにもできます。

ldd を使用して JACK アプリケーションが正しいライブラリにリンクしていることを確認します。

$ ldd /usr/bin/qjackctl | grep -i libjack

libjack.so.0 => /usr/lib/pipewire-0.3/jack/libjack.so.0 (0x00007f7e5080a000)

Bluetooth デバイス

PipeWire は pipewire-pulse パッケージがインストールされている場合 Bluetooth オーディオデバイスを制御します。具体的には、メディアセッションデーモンは /etc/pipewire/media-session.d/with-pulseaudio が存在する時に自動的にその bluez5 モジュールを有効にします。

ネイティブ JACK 上で PipeWire を実行する

PipeWire はネイティブ JACK デーモン上の JACK クライアントとして実行することもできます。詳細は JACK and PipeWire を参照してください。

音声のポストプロセッシング

PulseEffects

PulseEffects は GTK ユーティリティで、多数のエフェクトとフィルタを個々の入出力ストリーム(アプリケーションの音声出力やマイクの入力など)に提供します。注目すべきエフェクトには、入出力イコライザー、出力ラウドネス等化、ベースエンハンスメント、入力ディエッサー、ノイズ抑制プラグインなどがあります。GitHub ページにエフェクトの一覧があります。

PipeWire で PulseEffects を使用するには、pulseeffects または pulseeffects-git^AUR をインストールします。

ノート: これにより、pipewire-pulse がインストールされ PulseAudio が PipeWire に置き換えられます。詳細は FS#69437 を参照してください。古いバージョンについては PulseAudio#PulseEffects を参照してください。

プリセット設定のコレクションについては、コミュニティープリセットを参照してください。

トラブルシューティング

PipeWire にマイクが検出されない

PipeWire の alsa-monitor モジュールは、デフォルトで alsa-card-profiles を使用してデバイスを検出します。これでうまくいかない場合は、/etc/pipewire/media-session.d/alsa-monitor.conf の rules -> 最初のルール -> actions -> update-props の api.alsa.use-acp を false にするか、または api.alsa.use-ucm を true にしてみてください:

...
update-props = {
    api.alsa.use-acp = false
...

次に PipeWire を再起動し使用可能なデバイスを確認します:

$ pw-record --list-targets

Available targets ("*" denotes default): 62
	58: description="Built-in Audio" prio=1872
	60: description="Built-in Audio" prio=2000
*	62: description="Built-in Audio (Loopback PCM)" prio=1984

Bluetooth デバイスに接続しても音が出ない

2020-12-07 の時点で、Bluetooth デバイスを接続しても音が出ない場合は、デフォルトのシンクに切り替えるか、シンク入力を正しいシンクに移動する必要があります。 pactl list sinks で使用可能なシンクの一覧を表示し、pactl set-default-sink でデフォルトのシンクを Bluetooth デバイスに切り替えます。これはこのようなスクリプトを使って udev で自動化できます。

この問題については、この Reddit スレッドを参照してください。スクリプトの作成者によると、ヘッドセットプロファイル (HSP) にまだ問題がある可能性があります。

音量が小さい

PulseAudio を Pipewire で置き換えた後、正しく音が出ても、再起動後に音量が極端に小さくなることがあります。

alsamixer を開き、F6 を押して適切なサウンドカードを選び ALSA のボリュームが100%であることを確認してください。 alsactl は再起動後もこの設定を維持するはずです。

increasing RLIMIT_MEMLOCK

Dec 13 11:11:11 HOST pipewire-pulse[99999]: Failed to mlock memory 0x7f4f659d8000 32832: This is not a problem but for best performance, consider increasing RLIMIT_MEMLOCK

realtime-privileges をインストールし realtime グループに自分のユーザーを追加します。

あるいは memlock を 64kB から 128kB に増やすことで、この問題を解決できるようです。systemd/ユーザーで pipewire-pulse を実行している場合は /etc/security/limits.d/username.conf に次の行を追加します:

username	soft	memlock	64
username	hard	memlock	128

外付けサウンドカードが再接続後に有効にならない

~/.config/pipewire-media-session/default-profile にデフォルトプロファイル off のエントリがあれば削除します。それでも解決しない場合は ~/.config/pipewire-media-session/ からすべてのファイルを削除し、systemctl --user restart pipewire.service で PipeWire を再起動します。

音が出ないまたは pactl info が Failure: Connection refused と表示する

これはアプリケーションが PipeWire-Pulse サービスに接続できていないことを意味します。/etc/pipewire/pipewire-pulse.conf が存在し空でないことを確認し、systemctl --user restart pipewire-pulse.service で PipeWire-Pulse を再起動して下さい。

それでも解決しない場合は strace -f -o /tmp/pipe.txt pactl info を実行し、pastebin に /tmp/pipe.txt を貼り付けて、IRC (Freenode #pipewire) かメーリングリストで相談してください。

Bluetooth の音声の品質が低い

Feb 17 18:23:01 HOST pipewire[249297]: (bluez_input.18:54:CF:04:00:56.a2dp-sink-60) client too slow! rate:512/48000 pos:370688 status:triggered

Bluetooth で再生が途切れる場合は systemctl --user status pipewire.service を実行してみてください。このようなエラーが表示される場合は pactl list sinks で現在選択されているコーデックを確認し、/etc/pipewire/media-session.d/bluez-monitor.conf の bluez5.codecs を sbc aac ldac aptx aptx_hd のいずれかに変更してみてください。変更を適用するには systemctl --user restart pipewire.service で PipeWire を再起動する必要があります。

/etc/pipewire/media-session.d/bluez-monitor.conf

...
properties = {
  ...
  bluez5.codecs = [sbc]
...

PipeWire の更新 (git / >=0.3.23) と再起動後デバイスが検出されない

コミット 012a68f8[5] の時点で新しい systemd サービスが追加されデフォルトでは無効になっています。これはシステムの再起動時に pipewire-media-session が実行されないことを意味します。サービスを有効にするには systemctl --user enable --now pipewire-media-session.service を実行します。

システムの管理者やパッケージマネージャが更新後に設定ファイルの変更を整理していない場合、pipewire.service によって pipewire-media-session の別のプロセスが実行されている可能性があります。確認するには systemctl --user status pipewire.service を実行してください。

pipewire および pipewire-media-session が実行中と表示される場合は、システム設定かユーザ設定、あるいは両方を更新します。

/etc/pipewire/pipewire.conf または ~/.config/pipewire/pipewire.conf

context.exec = {
  ...
  # 次の行はコメントアウトする必要があります
  #"/usr/bin/pipewire-media-session" = { args = "" }
  ...
}

再生開始時に音声に遅延が発生する

これは非アクティブ時のノードのサスペンドが原因です。遅延が発生する領域に応じて /etc/pipewire/media-session.d/*-monitor.conf を編集し、プロパティ session.suspend-timeout-seconds を 0 に変更してサスペンドを無効にするか、他の値を試して動作を確認してみてください。/etc/pipewire/media-session.conf の suspend-node の行をコメントアウトすることもできます。変更を適用するには pipewire と pipewire-pulse systemd サービスの両方を再起動するか、システムを再起動してください。

複数のストリームの再生開始時に音声が途切れる

この問題は通常 journalctl -b を実行し、次のような行を探すことで診断できます:

pipewire-pulse[21740]: pulse-server 0x56009b9d5de0: [Nightly] UNDERFLOW channel:0 offset:370676 underrun:940

公式 PipeWire トラブルシューティングガイドによると、この問題を解決するには /etc/pipewire/media-session.d/alsa-monitor.conf を編集し、api.alsa.headroom = 0 という行のコメントを外し、値を 1024 に変更します。

参照

Wiki — PipeWire Wiki on Freedesktop GitLab
Pipewire Update Blog Post — PipeWire の2018年1月時点での進捗が書かれた記事
PipeWire Late Summer Update 2020 — 2020年9月からの記事