ArchWiki - 利用者の投稿記録 [ja]

利用者:DreamChaser

2025-06-03T13:57:59Z

DreamChaser:

技術者ではないので専門用語には疎いです。
半年くらい放置されている未翻訳記事があったら翻訳しようかなと思っています。

ArchWiki翻訳の備忘録
<nowiki>"{{=}}"となっている箇所を"="に修正し、改行になっているところは{{テンプレート|1=<nowiki/>単語1=単語2}}、それ以外は{{テンプレート|1=単語1=単語2}}を追加する。</nowiki>
テンプレートとはノートやヒント、警告などを指す。

プレビューを見ておかしい箇所がないか探す。

<nowiki>[[start]]は起動、[[restart]]は再起動、[[enable]]は有効化、[[stop]]は停止。</nowiki>
<nowiki>テンプレートの{{Note|}}や{{Tip|}}は翻訳せずにそのまま使う。</nowiki>
() "" , :など全角文字があるものは翻訳の際に全角になってしまうことがあるので注意。

末尾の"see also"は慣例的に「参照」と訳す。
"Tips and Tricks"も同じく「ヒントとテクニック」と訳す。
翻訳状況のテンプレを末尾に入れる。
<nowiki>{{TranslationStatus|英語版の記事タイトル|西暦月日|英語版のバージョン（右上の Tools >Permanent_link から確認できる）}}</nowiki>
一例を下に示す。
<nowiki>{{TranslationStatus|Waydroid|2024-09-28|816118}}</nowiki>

文中では、ですます体だが、目次の見出しはなるべく名詞で終わるようにし、トラブルシューティングの項では「する」「ない」などとする。
アルファベットやカタカナ前後の半角空白に注意する。英単語のみ前後に半角空白を入れる。行頭には空白を入れない。またカタカナでは行わない。

<nowiki>[[カーネルパラメータ]] {{ic|ibt=off}} ＞テンプレートエラー</nowiki>

利用者:DreamChaser

2025-06-03T13:54:35Z

DreamChaser:

技術者ではないので専門用語には疎いです。
半年くらい放置されている未翻訳記事があったら翻訳しようかなと思っています。

ArchWiki翻訳の備忘録
<nowiki>"{{=}}"となっている箇所を"="に修正し、改行になっているところは{{テンプレート|1=<nowiki/>単語1=単語2}}、それ以外は{{テンプレート|1=単語1=単語2}}を追加する。</nowiki>
テンプレートとはノートやヒント、警告などを指す。

プレビューを見ておかしい箇所がないか探す。

<nowiki>[[start]]は起動、[[restart]]は再起動、[[enable]]は有効化、[[stop]]は停止。</nowiki>
テンプレートの{{Note|}}や{{Tip|}}は翻訳せずにそのまま使う。</nowiki>
() "" , :など全角文字があるものは翻訳の際に全角になってしまうことがあるので注意。

末尾の"see also"は慣例的に「参照」と訳す。
"Tips and Tricks"も同じく「ヒントとテクニック」と訳す。
翻訳状況のテンプレを末尾に入れる。
<nowiki>{{TranslationStatus|英語版の記事タイトル|西暦月日|英語版のバージョン（右上の Tools >Permanent_link から確認できる）}}</nowiki>
一例を下に示す。
<nowiki>{{TranslationStatus|Waydroid|2024-09-28|816118}}</nowiki>

文中では、ですます体だが、目次の見出しはなるべく名詞で終わるようにし、トラブルシューティングの項では「する」「ない」などとする。
アルファベットやカタカナ前後の半角空白に注意する。英単語のみ前後に半角空白を入れる。行頭には空白を入れない。またカタカナでは行わない。

<nowiki>[[カーネルパラメータ]] {{ic|ibt=off}} ＞テンプレートエラー</nowiki>

PipeWire

2024-10-17T14:42:45Z

DreamChaser: auioとなっていた箇所をaudioに修正

[[Category:マルチメディア]]
[[en:PipeWire]]
[[fi:PipeWire]]
[[pt:PipeWire]]
[[ru:PipeWire]]
[[zh-hans:PipeWire]]
{{Related articles start}}
{{Related|PipeWire/サンプル}}
{{Related|WirePlumber}}
{{Related articles end}}
[https://pipewire.org PipeWire] は新しい低レベルマルチメディアフレームワークです。
映像と音声を最小の遅延で再生/キャプチャすることを目的としていて、[[PulseAudio]]、[[JACK]]、[[ALSA]]、[[GStreamer]] をベースとしたアプリケーションと互換性があります。

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

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

== インストール ==

公式リポジトリから {{Pkg|pipewire}} パッケージを [[インストール]] してください。[[multilib]] に対応した {{Pkg|lib32-pipewire}} もあります。

Pipewire は [[systemd/ユーザー]] を使ってサーバーを管理し、ソケットを自動で起動します。

オプションとして、{{Pkg|pipewire-docs}} をインストールすると、ドキュメントを確認することができます。

Pipewire は、他のオーディオサーバーと置き換えることができます。詳しくは [[PipeWire#オーディオ|オーディオ]] を参照してください。

=== セッションマネージャー ===

[[JACK]] と同様、PipeWire は内部で接続ロジックを実装していません。新しいストリームを監視し、適切な出力デバイスやアプリケーションに接続する負担は、セッションマネージャーとして知られる外部のコンポーネントに任されています。

現在、推奨のセッションマネージャーは1つだけで次になります:
* {{App|[[WirePlumber]]| 強力なマネージャであり、現在の推奨品です。モジュール設計に基づいており、実際の管理機能を実装する Lua プラグインがあります。|https://pipewire.pages.freedesktop.org/wireplumber/|{{Pkg|wireplumber}}}}

次のセッションマネージャーはサポート外になっており WirePlumber を推奨しています:

* {{App|PipeWire Media Session|いくつかの基本的なデスクトップのユースケースに対応した非常にシンプルなセッションマネージャです。これは主にテスト用と新しいセッションマネージャを構築するための例として実装されました。|https://gitlab.freedesktop.org/pipewire/media-session|{{Pkg|pipewire-media-session}}}}

PipeWire のインストール時に、どちらかを選ぶように指示されます。後で適切なパッケージをインストールすることで、もう一方のオプションと衝突しますが、置き換えることで切り替えが可能です。

=== GUI ===

* {{App|Helvum|PipeWire 用の GTK 製のパッチベイ。 JACK のツールの catia にインスパイアされた。|https://gitlab.freedesktop.org/ryuukyu/helvum|{{pkg|helvum}}}}
* {{App|qpwgraph|Qt-based Graph/Patchbay for PipeWire, inspired by the JACK tool QjackCtl.|https://gitlab.freedesktop.org/rncbc/qpwgraph|{{Pkg|qpwgraph}}}}

== 設定 ==

PipeWire パッケージは、初期設定ファイルを{{ic|/usr/share/pipewire}} に用意しています。パッケージのアップデートで変更内容が上書きされてしまうので、これらのファイルを直接編集するべきではありません。PipeWire を設定するには、ファイルを {{ic|/usr/share/pipewire}} からシステム全体の代替場所 {{ic|/etc/pipewire}} か、ユーザーの場所 {{ic|~/.config/pipewire}} にコピーしてください。[https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/Config-PipeWire#configuration-file-pipewireconf]

=== プロファイル ===

Pipewire では、PulseAudio のプロファイルに加えて、pavucontrol で選択可能なカスタムの ''Pro Audio'' プロファイルが提供されています。その効果はこちらで解説しています:https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/FAQ#what-is-the-pro-audio-profile

== 使用方法 ==

=== 音声 ===

PulseAudio や JACK と同様に PipeWire をオーディオサーバーとして使用できます。 PulseAudio サーバーの互換実装と JACK クライアント用の ABI 互換ライブラリを提供することで PulseAudio と JACK の両方を置き換えることを目的としています。詳細については[https://blogs.gnome.org/uraeus/2020/09/04/pipewire-late-summer-update-2020/ この記事]を参照してください。

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

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

==== PulseAudio クライアント ====

{{pkg|pipewire-pulse}} をインストールします。このパッケージは {{pkg|pulseaudio}} と {{pkg|pulseaudio-bluetooth}} を置き換えます。再起動するか、ログインし直すか、{{ic|pulseaudio.service}} を[[停止]]して、{{ic|pipewire-pulse.service}} ユーザーユニットを実行すると効果がわかります。

パッケージがユーザーサービス {{ic|pipewire-pulse.socket}} を自動的に有効化するので、通常それ以上の操作は不要です。置き換えが機能しているかどうかを確認するには、次のコマンドを実行して出力を確認してください:

{{hc|$ pactl info|2=
...
Server Name: PulseAudio (on PipeWire ''x.y.z'')
...
Default Sink: alsa_output.{bus}-{device}.{profile}
Default Source: alsa_input.{bus}-{device}.{profile}
...
}}

{{man|1|pactl}} は、依存関係として ''pipewire-pulse'' とともにインストールされる PulseAudio クライアントライブラリパッケージ ({{pkg|libpulse}}) によって提供されます。

===== 全体または個別のチャンネルの音量を設定する =====

出力チャンネルのボリュームを調整するには、{{ic|pactl get-sink-volume {sink}}} を使用して、''Default Sink:'' (上記) または ''Name'' の値を使用して ''sink'' を指定する必要があります。:
'' (下記)、デフォルトのシンクデバイス (''@DEFAULT_SINK@'')、または ''Sink #'' (例: 以下の ''1''):
{{hc|$ pactl list sinks {{!}} grep -B1 -A9 State:|2=
Sink #1
State: RUNNING
Name: alsa_output.pci-0000_2d_00.4.analog-surround-51
...
Driver: PipeWire
...
Mute: no
Volume: front-left: 65536 / 100% / 0.00 dB, front-right: 65536 / 100% / 0.00 dB, rear-left: 65536 / 100% / 0.00 dB, rear-right: 65536 / 100% / 0.00 dB, front-center: 65536 / 100% / 0.00 dB, lfe: 65536 / 100% / 0.00 dB
balance 0.00
}}
ヒント: オーディオが再生されている場合、他のデバイスとして ''実行中'' の {{man|1|grep}} は ''一時停止'' されます。

''バランス'' 比率は自動的に計算されます。デフォルトのデバイスの全体のボリュームを設定するには、次のコマンドを使用します: {{bc|pactl set-sink-volume @DEFAULT_SINK@ 75%}}
個別のチャンネルを設定するには、各チャンネルのボリュームを個別に指定します:
{{bc|pactl set-sink-volume @DEFAULT_SINK@ 100% 75% 100% 75% 100% 100%}}

''ソース'' 入力も同様に処理されます。さらに詳しい設定 (モジュールなど) については、[https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/Migrate-PulseAudio Migrate PulseAudio] および [https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/Config-PulseAudio Pipewire-Pulse Configuration] を参照してください。

==== JACK クライアント ====

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

pw-jack ''application''

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

PIPEWIRE_LATENCY="128/48000" pw-jack ''application''

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

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

{{hc|1=$ ldd /usr/bin/qjackctl {{!}} grep -i libjack|2=
libjack.so.0 => /usr/lib/pipewire-0.3/jack/libjack.so.0 (0x00007f7e5080a000)
}}

==== Bluetooth デバイス ====

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

===== プロファイルの自動選択機能 =====

{{Pkg|pipewire-media-session}} は、入力ストリームが必要なときに、HSP/HFP と A2DP プロファイルを自動的に切り替えます。これを有効にするには、{{ic|bluez5.autoswitch-profile}} プロパティを {{ic|true}} にセットしてください。

{{hc|/etc/pipewire/media-session.d/bluez-monitor.conf (or ~/.config/pipewire/media-session.d/bluez-monitor.conf|output=
...
rules = [
{
...
actions = {
update-props = {
...
bluez5.autoswitch-profile = true
...
}}

これらの機能は、[[WirePlumber]] ではまだ [https://gitlab.freedesktop.org/pipewire/wireplumber/-/issues/90 実装中] です。

==== PipeWire ネイティブパッチセット ====

グラフィカルな視覚化と接続の作成のための Helvum はありますが、それ以外はまだ入っていません。以下は、ワイヤセットの保存、ワイヤセットの読み込み、すべての接続の解除を行う bash スクリプトです。保存と読み込みには、コマンドラインパラメータでファイル名を指定します。

{{hc|pw-savewires|<nowiki>
#!/bin/bash

if [[ "$#" -ne 1 ]]; then
echo
echo 'usage: pw-savewires filename'
echo
exit 0
fi

rm $1 &> /dev/null
while IFS= read -r line; do
link_on=`echo $line | cut -f 4 -d '"'`
link_op=`echo $line | cut -f 6 -d '"'`
link_in=`echo $line | cut -f 8 -d '"'`
link_ip=`echo $line | cut -f 10 -d '"'`
echo "Saving: " "'"$link_on:$link_op"','"$link_in:$link_ip"'"
echo "'"$link_on:$link_op"','"$link_in:$link_ip"'" >> $1
done < <(pw-cli dump short link)
</nowiki>}}

{{hc|pw-loadwires|<nowiki>
#!/bin/python

import sys
import csv
import os

if len(sys.argv) < 2:
print('\n usage: pw-loadwires filename\n')
quit()

with open(sys.argv[1], newline='') as csvfile:
pwwreader = csv.reader(csvfile, delimiter=',', quotechar='"')
for row in pwwreader:
print('Loading: ' + row[0] + ' --> ' + row[1])
process = os.popen('pw-link ' + row[0] + ' ' + row[1])
</nowiki>}}

{{hc|pw-dewire|<nowiki>
#!/bin/bash
while read -r line; do
echo 'Dewiring: ' $line '...'
pw-link -d $line
done < <(pw-cli dump short link {{!}} grep -Eo '^[0-9]+')
</nowiki>}}

==== ネットワーク上のコンピューターとオーディオ機器を共有する ====

PipeWire 自体はネットワーク透過型ではありませんが、そのパルス実装は [https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/Config-PulseAudio#network-support ネットワークストリーミング] をサポートしています。ネットワーク上のコンピュータ間でオーディオを共有する簡単な方法は、[[Avahi]] デーモンを使って検出することです。
オーディオを共有するすべてのコンピュータで {{ic|avahi-daemon.service}} が実行されていることを確認してください。

ローカルのオーディオデバイスを共有するために、ホスト上で適切なモジュールをロードしてください。

pactl load-module module-native-protocol-tcp listen=''192.168.1.10'' # Use the local IP address
pactl load-module module-zeroconf-publish

次に、クライアントにディスカバリモジュールをロードします。

pactl load-module module-zeroconf-discover

===== AirPlay レシーバーにオーディオをストリーミングする =====

[[Wikipedia:ja:AirPlay#Receivers|AirPlay Receiver]] を装ったデバイスにオーディオをストリーミングすることが可能です。この機能を有効にするには、[https://docs.pipewire.org/page_module_raop_discover.html RAOP Discover モジュール] をロードします。

$ pactl load-module module-raop-discover

専用の設定ファイルを作成することで、このモジュールを自動的にロードすることもできます。

{{hc|/etc/pipewire/pipewire.conf.d/raop-discover.conf (or ~/.config/pipewire/pipewire.conf.d/raop-discover.conf)|2=
context.modules = [
{
name = libpipewire-module-raop-discover
args = { }
}
]
}}

一部のスピーカーの AirPlay 実装 (Sonos AirPlay 2 スピーカーなど) では、ソースデバイスで着信 UDP トラフィック用にポート 6001 および 6002 を開く必要がある場合があります。

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

PipeWire はネイティブ JACK デーモン上の JACK クライアントとして実行することもできます。詳細は [https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/JACK JACK and PipeWire] を参照してください。

==== PipeWire シンクとして ALSA dmix デバイスを使用する ====

PipeWire サーバー(またはユーザーごとに複数) を [[Advanced Linux Sound Architecture#Dmix|ALSA dmix デバイス]] を介して ALSA に出力することが可能です。これにより、ALSA を主要な音声出力システムとして使用しながら、Bluetooth ヘッドフォンなどの ALSA 以外のデバイスを使用することができるようになります。

===== ALSA dmix セットアップ =====

{{ic|PCH}} と {{ic|HDMI}} の 2 枚のカードがあるとします。

{{hc|/proc/asound/cards|
0 [PCH ]: HDA-Intel - HDA Intel PCH
HDA Intel PCH at 0xdff40000 irq 146
1 [HDMI ]: HDA-Intel - HDA ATI HDMI
HDA ATI HDMI at 0xdfe60000 irq 147
}}

PCM は次のようになります。

{{hc|/proc/asound/pcm|
00-00: ALC1220 Analog : ALC1220 Analog : playback 1 : capture 1
00-02: ALC1220 Alt Analog : ALC1220 Alt Analog : capture 1
01-03: HDMI 0 : HDMI 0 : playback 1
01-07: HDMI 1 : HDMI 1 : playback 1
01-08: HDMI 2 : HDMI 2 : playback 1
01-09: HDMI 3 : HDMI 3 : playback 1
01-10: HDMI 4 : HDMI 4 : playback 1
01-11: HDMI 5 : HDMI 5 : playback 1
}}

ALSA 設定が次のようになっているとします。

{{hc|/etc/asound.conf|
ctl.!default {
type hw
card PCH
}

pcm.!default {
type plug
slave.pcm "'''dmix:PCH,0'''"
}

pcm.dhdmi {
type plug
slave.pcm "'''dmix:HDMI,9'''"
}
}}

この特定の例では、dmix デバイスは {{ic|dmix:PCH,0}} と {{ic|dmix:HDMI,9}} になります。

===== PipeWire dmix セットアップ =====

まず、{{ic|alsa_monitor.enable()}} をコメントアウトして、{{ic|wireplumber}} によるハードウェア ALSA デバイスの監視と追加を停止します。

{{hc|/etc/wireplumber/main.lua.d/90-enable-all.lua (or ~/.config/wireplumber/main.lua.d/90-enable-all.lua)|
...
-- Load devices
'''-- alsa_monitor.enable()'''
v4l2_monitor.enable()
libcamera_monitor.enable()
...
}}

ここで、dmix デバイスを使用するように {{ic|pipewire}} を設定します。デフォルトの設定ファイル ({{ic|/usr/share/pipewire/pipewire.conf}}) には [https://gitlab.freedesktop.org/pipewire/pipewire/-/blob/0.3.59/src/daemon /pipewire.conf.in#L219-239 コメントアウトされた例] をベースとして使用できます。

独自の要素を {{ic|context.objects}} 配列に追加します。

{{hc|/etc/pipewire/pipewire.conf.d/alsa-dmix.conf (or ~/.config/pipewire/pipewire.conf.d/alsa-dmix.conf)|output=
context.objects = [
# We do not start with dmix, but with an input device.
# Do not forget to add an input device.
# On a friend's Laptop, I saw Zoom having a nervous
# breakdown and endlessly crying because no input device
# was configured! You have been warned.
{ factory = adapter
args = {
factory.name = api.alsa.pcm.source
node.name = "alsa-mic-internal" # name of pulse device (mpv)
node.description = "Mic Internal" # name of pulse device (pavucontrol)
media.class = "Audio/Source"
api.alsa.path = "'''hw:PCH,0'''"
}
}
# Okay, now we add our dmix PCMs
{ factory = adapter
args = {
factory.name = api.alsa.pcm.sink # sink for dmix
node.name = "alsa-dmix-internal" # name of pulse device (mpv)
node.description = "PCM Internal" # name of pulse device (pavucontrol)
media.class = "Audio/Sink" # Sink for dmix
api.alsa.path = "'''dmix:PCH,0'''"
}
}

{ factory = adapter
args = {
factory.name = api.alsa.pcm.sink # sink for dmix
node.name = "alsa-dmix-hdmi" # name of pulse device (mpv)
node.description = "PCM HDMI" # name of pulse device (pavucontrol)
media.class = "Audio/Sink" # Sink for dmix
# remember this is a non-default dmix from /etc/asound.conf
api.alsa.path = "'''dmix:HDMI,9'''"
}
}
]
}}

ユーザー (非 root) として、{{ic|wpctl status}} の出力を確認し、{{ic|wpctl set-default ''ID''}} でデフォルトの入力(ソース) と出力 (シンク) のデバイスを好みのものに設定します。{ic|''ID''}} はシンク/ソース名の前の数字です。

これで、構成を完全にテストすることができます。

==== デバイスプロファイルの切り替え ====

{{ic|snd_hda_intel}} などの一部のハードウェアオーディオデバイスは、デバイスが実行されているプロファイルによって機能が異なります。{{ic|snd_hda_intel}} の場合、HDMI とアナログ出力用に個別のプロファイルがあります。

WirePlumber で HDMI に切り替える:

{{hc|
$ wpctl set-profile <device-ID> 3
$ wpctl status
|output=
...
├─ Sinks:
│ * 53. Built-in Audio Digital Stereo (HDMI) [vol: 1.00]
...
}}

WirePlumber でアナログに切り替える:

{{hc|
$ wpctl set-profile <device-ID> 1
$ wpctl status
|output=
...
├─ Sinks:
│ * 51. Built-in Audio Analog Stereo [vol: 0.60]
...
}}

=== WebRTC 画面共有 ===

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

{{Tip|WebRTC 画面共有が機能しているかどうか、[https://mozilla.github.io/webrtc-landing/gum_test.html Mozilla の GetUserMedia WebRTX テストページ]でテストしましょう。}}

{{Note|1={{Pkg|xdg-desktop-portal}} 1.10.0 では、D-Bus インターフェースの仕様と実装の不一致が修正されました。[https://github.com/flatpak/xdg-desktop-portal/pull/609] そのため、一部のクライアントは xdg-desktop-portal 1.10.0 またはそれ以降で動作しないかもしれません。}}

Firefox (バージョン84以降) と Chromium (バージョン110以降) はデフォルトでこの方法をサポートしていますが、Chromium の古いバージョン (バージョン73以降) では、URL {{ic|chrome://flags/#enable-webrtc-pipewire-capturer}} で対応する (実験的) フラグを設定するか、CLI 引数 {{ic|1=--enable-features=WebRTCPipeWireCapturer}} を用いて、[https://bugs.chromium.org/p/chromium/issues/detail?id=682122 WebRTC PipeWire サポート] を有効化する必要があります。

{{Pkg|obs-studio}} (バージョン27以降) は、新しい PipeWire キャプチャソースを使用することにより、この方法をサポートしています。

=== 映像 ===

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

{{Pkg|pipewire-v4l2}} を使用すると、{{ic|pw-v4l2}} スクリプトを使用してライブラリをプリロードすることも可能になります ({{ic|/lib/pipewire-0.3/v4l2/libpw-v4l2.so}}) は、v4l2 呼び出しをインターセプトし、PipeWire 経由でビデオをルーティングします。

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

=== Pipewire モジュールフィルターチェーン ===

Pipewire には {{ic|[https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/Filter-Chain filter-chain]}} という内部モジュールがあり、音声の入出力を処理するノードを作成することができます。参照してください。
/usr/share/pipewire/filter-chain/ を参照してください。
イコライザー、バーチャルサラウンドサウンド、LADSPA プラグイン、チャンネルミキシングなどの例を紹介します。

==== システム全体のパラメトリックイコライゼーション ====

設定ファイルを {{ic|.config}} フォルダにコピーします。
mkdir -p ~/.config/pipewire/pipewire.conf.d
cp /usr/share/pipewire/filter-chain/sink-eq6.conf ~/.config/pipewire/pipewire.conf.d/
次に、{{ic|sink-eq6.conf}} を編集して、必要なパラメータを組み込みます。ヘッドフォンの場合、これらは [https://old.reddit.com/r/oratory1990/wiki/index Oratory1990 のデータベース] から入手できます。そこにリストされていない場合は、[https://github.com/jaakkopasanen/AutoEq/tree/master/results/ AutoEQ project]

プリアンプが必要な場合は、{{ic|eq_band_1}} を変更して、{{ic|bq_highshelf}} フィルタを周波数 0Hz でマイナスゲイン (-120 〜 +20dB のゲインをサポート) で適用します。
label = bq_highshelf
control = { "Freq" = 0 "Q" = 1.0 "Gain" = -7.5 }

6 バンドを超える場合は、{{ic|nodes}} リストと対応する {{ic|links}} にさらにエントリを追加して、1 つのフィルタ ":Out" を次のフィルタ ":In" に接続します。たとえば、11 に増やします。バンド (プリアンプ + 10):
{ output = "eq_band_6:Out" input = "eq_band_7:In" }
{ output = "eq_band_7:Out" input = "eq_band_8:In" }
{ output = "eq_band_8:Out" input = "eq_band_9:In" }
{ output = "eq_band_9:Out" input = "eq_band_10:In" }
{ output = "eq_band_10:Out" input = "eq_band_11:In" }

Pipewire を再起動し、デフォルトのサウンド出力デバイスとして "Equalizer Sink" を選択します。これは、すべてのアプリケーションに適用されます。

=== EasyEffects ===

EasyEffects (以前は PulseEffects と呼ばれていました) は多数のエフェクトとフィルタを個々の入出力ストリーム (アプリケーションの音声出力やマイクの入力など) に提供する GTK 製のユーティリティです。注目すべきエフェクトには、入出力イコライザー、出力ラウドネス等化、ベースエンハンスメント、入力ディエッサー、ノイズ抑制プラグインなどがあります。[https://github.com/wwmm/easyeffects GitHub ページ]にエフェクトの一覧があります。

EasyEffects を使用するには、{{pkg|easyeffects}} をインストールします。プリセット設定集については、[https://github.com/wwmm/easyeffects/wiki/Community-presets コミュニティープリセット]を参照してください。

{{Note|PulseEffects の古いバージョンについては [[PulseAudio#PulseEffects]] を参照してください。}}

=== NoiseTorch ===

{{aur|noisetorch}} はノイズ抑制に使用できます。ビルド済み ({{aur|noisetorch-bin}}) や開発版 ({{aur|noisetorch-git}}) のパッケージもあります。

起動すると選択したマイクにモジュールを読み込むことができます。声が出力される閾値を調整することができます。実際の声が削除されない最大のレベルに設定するべきです。

=== Noise suppression for voice ===

{{pkg|noise-suppression-for-voice}} をインストールし、以下のいずれかのオプションを使用します:

* 以下の行を {{ic|context.exec}} セクションに追加する:

{{hc|/etc/pipewire/pipewire.conf (or ~/.config/pipewire/pipewire.conf)|output=
...
context.exec = [
...
{ path = "/usr/bin/pipewire" args = "-c /usr/share/pipewire/filter-chain/source-rnnoise.conf" }
...
}}

* https://github.com/werman/noise-suppression-for-voice#pipewire に従う

そして、オーディオ設定でノイズキャンセルソースをデフォルトとして設定します。この機能を使う前に、アプリケーションを再起動する必要があるかもしれません。

=== JamesDSP ===

[https://github.com/Audio4Linux/JDSP4Linux#readme JamesDSP for Linux] ({{AUR|jamesdsp}} として入手可能) は PipeWire と PulseAudio のためのオープンソースのサウンドエフェクトを提供します。LADSPA や Calf などに依存することなく、独自のエフェクトエンジンを使用しています。JamesDSP は当初 Android デバイス用のオーディオエフェクトプロセッサーとして公開されました。

=== LADSPA、LV2、VST プラグイン ===

LADSPA、LV2、VSTのプラグインを使用したい場合は、カスタム PulseAudio null シンクと Carla Jack ホストを利用できます。{{pkg|pipewire-pulse}} と {{pkg|pipewire-jack}} と {{pkg|carla}} をインストールします。はじめに {{ic|default_null_sink}} という名前の PulseAudio の null シンクを作成します。

pactl load-module module-null-sink object.linger=1 media.class=Audio/Sink sink_name=default_null_sink channel_map=FL,FR

{{ic|pw-jack carla-rack}} で PipeWire を使用する Carla を起動します。''Rack'' タブで使いたいプラグインを全て追加します。プラグインのタイプが ''stereo'' であることを確認してください。適用する順番を変えることができます。EasyEffectsのようにリストの最初のプラグインが最初に入力の音声ストリームを受け取ります。その後 ''Patchbay'' タブに移動し {{ic|default_null_sink}} の L/R monitor を Carla input に接続し、Carla output を出力したいデバイス (スピーカーやイヤホンや HDMI 出力など) の playback に接続します。設定をフォルダに保存します ({{ic|~/Documents/carla_sink_effects.carxp}} など)。

Firefox で動画を見ている時など、アプリケーションが音声を再生している時に効果を試すことができます。2つの方法があります。一つは Carla の ''Patchbay'' タブで Firefox の接続を全て外し {{ic|default_null_sink}} の L/R output に接続する方法です。もう一つは {{pkg|pavucontrol}} を使用し Firefox の音声ストリームを {{ic|default_null_sink}} に変更する方法です (この方法は同じアプリケーションの次回起動時に同じ接続先を使用するはずです)。

これらの設定を起動時に適用するには、まず2つの systemd ユーザーサービスを作成します:

{{hc|~/.config/systemd/user/jack-carla-rack.service|output=
[Unit]
Description=Load Carla Rack JACK host

[Service]
PassEnvironment="PIPEWIRE_LINK_PASSIVE=true"
Type=exec
ExecStart=/usr/bin/pw-jack carla-rack -n

[Install]
WantedBy=default.target
}}
{{hc|~/.config/systemd/user/pulseaudio-null-sink@.service|output=
[Unit]
Description=Load %i Pulseaudio null sink
Before=jack-carla-rack.service
After=pipewire-pulse.service

[Service]
Type=oneshot
ExecStart=/usr/bin/pactl load-module module-null-sink object.linger=1 media.class=Audio/Sink sink_name=%i channel_map=FL,FR
ExecStop=/usr/bin/pactl unload-module module-null-sink
RemainAfterExit=yes

[Install]
WantedBy=default.target
}}

''jack-carla-rack'' サービスの ''Environment'' を Carla の設定ファイルのフルパスを指定するよう上書きします:

{{hc|~/.config/systemd/user/jack-carla-rack.service.d/override.conf|output=
Environment="CARLA_CONFIG_FILE=/home/username/Documents/carla_sink_effects.carxp"
ExecStart=
ExecStart=/usr/bin/pw-jack carla-rack -n $CARLA_CONFIG_FILE
}}

最後に、作成したサービスを有効化します。''pulseaudio-null-sink'' サービスには {{ic|default_null_sink}} 引数をつけてください:

systemctl --user enable pulseaudio-null-sink@default_null_sink.service
systemctl --user enable jack-carla-rack.service

{{Note|システム設定で {{ic|default_null_sink}} をデフォルトデバイスに設定すると、全てのアプリケーションが {{ic|default_null_sink}} にリダイレクトされ、音量の変更がスピーカーではなく {{ic|default_null_sink}} に対して行われるようになります。スピーカーの音量を変更したい場合は、デフォルトデバイスをスピーカーから変更せずにアプリケーションの出力先を pavucontrol で {{ic|default_null_sink}} に変更してください (PipeWire の互換性レイヤーは次回起動時も出力先を覚えています)。}}

== トラブルシューティング ==

=== オーディオ ===

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

PipeWire の {{ic|alsa-monitor}} モジュールは、デフォルトで {{Pkg|alsa-card-profiles}} を使ってデバイスを検出します。これがうまくいかない場合は、{{ic|api.alsa.use-acp}} をオフにするか、オプションで {{ic|api.alsa.use-ucm}} をオンにすることを試してみてください。

{{Pkg|pipewire-media-session}} を使用している場合。
{{hc|/etc/pipewire/media-session.d/alsa-monitor.conf (or ~/.config/pipewire/media-session.d/alsa-monitor.conf)|output=
...
rules = [
{
...
actions = {
update-props = {
...
api.alsa.use-acp = false
...
}}

それ以外の場合は、{{Pkg|wireplumber}} を使用している場合。
{{hc|/etc/wireplumber/main.lua.d/50-alsa-config.lua (or ~/.config/wireplumber/main.lua.d/50-alsa-config.lua)|output=
...
alsa_monitor.rules = {
{
...
apply_properties = {
-- Use ALSA-Card-Profile devices. They use UCM or the profile
-- configuration to configure the device and mixer settings.
-- ["api.alsa.use-acp"] = true,

-- Use UCM instead of profile when available. Can be
-- disabled to skip trying to use the UCM profile.
["api.alsa.use-ucm"] = true,
...
}}

その後、pipewire を再起動し、利用可能なデバイスを確認します。

{{hc| 1=
$ pw-record --list-targets
|2=
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
}}

==== 新しいデバイスを接続したときにサウンドが自動的に切り替わらない ====

新しく接続されたデバイスに自動的に切り替えるには、次のファイルを作成します。:

{{hc|/etc/pipewire/pipewire-pulse.conf.d/switch-on-connect.conf (or ~/.config/pipewire/pipewire-pulse.conf.d/switch-on-connect.conf)|output=
# override for pipewire-pulse.conf file
pulse.cmd = [
{ cmd = "load-module" args = "module-always-sink" flags = [ ] }
{ cmd = "load-module" args = "module-switch-on-connect" }
]
}}

==== サウンドが自動的に Bluetooth ヘッドフォンに切り替わらない ====

{{ic|pactl load-module module-switch-on-connect}} を実行し、ログイン時に自動的にそのコマンドが実行されるようにデスクトップ環境を設定してください。詳しくは [https://gitlab.freedesktop.org/pipewire/wireplumber/-/issues/89 wireplumber issue #89] を見てください。

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

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

この問題については、この [https://www.reddit.com/r/archlinux/comments/jydd02/pipewirepulse_03164_in_testing_now_replaces/gd3m7fu/?context=3 Reddit スレッド]を参照してください。スクリプトの作成者によると、ヘッドセットプロファイル (HSP) にまだ問題がある可能性があります。

==== 音量が小さい ====

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

{{ic|alsamixer}} を開き、{{ic|F6}} を押して適切なサウンドカードを選び ALSA のボリュームが100%であることを確認してください。{{ic|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

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

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

username soft memlock 64
username hard memlock 128

==== サンプリングレートを変更する ====

PipeWire のデフォルトでは、グローバルサンプルレートは 48kHz に設定されています。これを変更したい場合(より高い値をサポートする DAC を所有しているなど)、設定ファイル {{ic|/etc/pipewire/pipewire.conf}} の {{ic|1=default.clock.rate = 48000}} 行を編集することで行うことができます。例えば、192kHz にしたい場合は、{{ic|48000}} を {{ic|1=default.clock.rate = 192000}} にコメントを解除して変更します。

PipeWire は、DAC がサポートする出力サンプルレートを変更することもできます。設定するには、{{ic|1=default.clock.allowed-rates = [ 48000 ]}} という行をコメント解除して設定します。例えば、{{ic|[ 44100 48000 88200 96000 ]}} とします。サンプルレートは、カードがアイドルのときに再生されるオーディオストリームのサンプルレートに従います。

どの出力サンプルレートとサンプルフォーマットが DAC に送られたデータであるかを確認するには(おそらく桁を変更する必要があります)。
cat /proc/asound/card0/pcm0p/sub0/hw_params
どの入力サンプルレートを使用しているかを確認するには、{{ic|pcm0p}} を {{ic|pcm0c}} に変更します。({{ic|c}} は "capture" の略、{{ic|p}} は "playback" の略です).

==== 許容されるサンプルレートの変更 ====

PipeWire は、DAC がサポートする出力サンプルレートを動的に変更することもできます。サンプルレートは、再生中のオーディオストリームのサンプルレートに従います。

{{hc|/etc/pipewire/pipewire.conf (or ~/.config/pipewire/pipewire.conf)|output=
...
context.properties = {
...
'''default.clock.allowed-rates = [ ''sample_rate_1'' ''sample_rate_2'' ''sample_rate_3'' ... ]'''
...
}}
たとえば、{{ic|[ 44100 48000 88200 96000 ]}} です。DAC でサポートされている値については、ハードウェアのマニュアルを参照してください。

開発者の [https://gitlab.freedesktop.org/pipewire/pipewire/-/issues/1523] によると: "PipeWire は最大16の異なるサンプルレートを許容し、可能な限り切り替えます。" つまり、上記の設定では、'''再サンプリングは行われない'''ということです。

DAC に送信されるデータがどの出力サンプルレートとサンプルフォーマットであるかを確認するには (おそらく桁を変更する必要があります):

$ cat /proc/asound/card0/pcm0p/sub0/hw_params

どの入力サンプルレートが使用されているかを確認するには、{{ic|pcm0p}} を {{ic|pcm0c}} に変更します ({{ic|c}} は "capture" の略で、{{ic|p}} は "playback" の略です)

==== 音質 (リサンプリング品質) ====

PulseAudio を {{ic|1=resample-method = speex-float-10}} または {{ic|soxr-vhq}} で使用していた場合、コメントを解除して {{ic|1=resample.XXX}} を変更することを検討するとよいかもしれません。{{ic|1=resample.quality = 4}} を {{ic|10}} または最大値 {{ic|15}} に変更することを検討してください。(存在しない場合は {{ic|/usr/share/pipewire/}} からコピーしてください)。PipeWire の再起動を忘れないでください (sudo なし): {{ic|systemctl --user restart pipewire.service pipewire-pulse.socket}} (設定変更を適用させたい場合は、{{ic|pipewire-pulse.socket}}を絶対に忘れないでください)。

{{ic|10}} と {{ic|15}} では、品質の差はほとんどありませんが、CPU 負荷は 2〜3 倍になっています。また、{{ic|4}}, {{ic|10}}, {{ic|15}} のレイテンシーの差はまだ誰も調べていません。Ryzen 2600 で 44100→48000Hz で {{ic|1= resample.quality = 15}} にすると {{ic|pipewire}} や {{ic|pipewire-pulse}} プロセスが 1CPUコア4.0% の負荷となる。

リサンプラーの比較はこちら:https://src.infinitewave.ca/(18KHz以上、120dB以上は注意)。speeex は ''Xiph.org Speex'' と記載されています。

PipeWire は Spa と呼ばれる独自のリサンプリングアルゴリズムを使用しています。SoX の {{ic|sox}}、Speex の {{ic|speexenc}} と同様、PipeWire にはそのスタンドアロン版があります。{{ic|spa-resample}} 使い方は
spa-resample -q 15 -f s24 -r 48000 input16bit44100orAnythingElse.wav output24bit48000hz.wav

自分で sink を作れば、他のリサンプラーを使うことも可能でしょう。あるいは、音楽プレーヤーのプラグインを使うこともできます(例えば、Qmmp には SoX プラグインがあります)

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

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

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

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

それでも解決しない場合は {{ic|strace -f -o /tmp/pipe.txt pactl info}} を実行し、pastebin に {{ic|/tmp/pipe.txt}} を貼り付けて、IRC (OFTC の [ircs://irc.oftc.net/pipewire #pipewire]) かメーリングリストで相談してください。

==== Bluetooth の音声の品質が低い====

Bluetooth で再生が途切れる場合は {{ic|systemctl --user status pipewire.service}} を実行してみてください。次のようなエラーが表示される場合は、

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

{{ic|pactl list sinks}} で現在選択されているコーデックを確認し、{{ic|/etc/pipewire/media-session.d/bluez-monitor.conf}} の {{ic|bluez5.codecs}} を {{ic|sbc aac ldac aptx aptx_hd}} のいずれかに変更してみてください。

{{hc|/etc/pipewire/media-session.d/bluez-monitor.conf|output=
...
properties = {
...
bluez5.codecs = [sbc]
...
}}

mSBC サポートの有効化を試すには (Sony 1000XM3 のマイクの問題を修正します):

{{hc|/etc/pipewire/media-session.d/bluez-monitor.conf|output=
...
rules = [
...
actions = {
...
update-props = {
...
bluez5.msbc-support = true
...
}}

変更を適用するには {{ic|systemctl --user restart pipewire.service}} で PipeWire を再起動する必要があります。

==== 再生開始時に明らかな音声の遅延やポップノイズ/音割れが発生する ====

これは、非アクティブ時のノードの一時停止が原因です。

{{pkg|pipiwire-media-session}} を使用:

これを無効にするには、遅延が発生する場所に応じて {{ic|/etc/pipewire/media-session.d/*-monitor.conf}} を編集し、プロパティ {{ic|session.suspend-timeout-seconds}} を 0 に変更します。無効にするか、他の値を試して、何が機能するかを確認します。

または、{{ic|/etc/pipewire/media-session.d/media-session.conf}} の行 {{ic|suspend-node}} をコメントアウトすることもできます。

[[再起動]] して {{ic|pipewire.service}} と {{ic|pipewire-pulse.service}} の両方の変更を適用して下さい。

{{pkg|wireplumber}} で、新しいファイルを作成してデフォルト設定を上書きします:

{{hc|~/.config/wireplumber/main.lua.d/51-disable-suspension.lua
(or /etc/wireplumber/main.lua.d/51-disable-suspension.lua)|2=
table.insert (alsa_monitor.rules, {
matches = {
{
-- Matches all sources.
{ "node.name", "matches", "alsa_input.*" },
},
{
-- Matches all sinks.
{ "node.name", "matches", "alsa_output.*" },
},
},
apply_properties = {
["session.suspend-timeout-seconds"] = 0, -- 0 disables suspend
},
})
}}

Bluetooth デバイスの場合は、次の設定も使用します (ファイルの場所が異なることに注意してください):

{{hc|~/.config/wireplumber/bluetooth.lua.d/51-disable-suspension.lua
(or /etc/wireplumber/bluetooth.lua.d/51-disable-suspension.lua)|2=
-- Note: bluez_monitor, not alsa_monitor
table.insert (bluez_monitor.rules, {
matches = {
{
-- Matches all sources.
-- Note: bluez_input, not alsa_input
{ "node.name", "matches", "bluez_input.*" },
},
{
-- Matches all sinks.
-- Note: bluez_output, not alsa_output
{ "node.name", "matches", "bluez_output.*" },
},
},
apply_properties = {
["session.suspend-timeout-seconds"] = 0, -- 0 disables suspend
},
})
}}

{{ic|pipewire.service}} と {{ic|wireplumber.service}} を再起動して、変更を適用します。

サスペンドを完全に無効にする代わりに、タイムアウト値を、ソースがサスペンドされるまでに必要な遅延秒数に変更することもできます。

==== 複数のストリームの再生が開始されると音声が途切れる ====

この問題は通常、{{ic|pipewire-pulse.service}} [[systemd/ユーザー|ユーザーユニット]] の [[journal]] を読み取り、次のような行を見つけることで診断できます。

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

[https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/Troubleshooting#underrununderflow-and-broken-pipe-errors 公式 PipeWire トラブルシューティングガイド] によると、{{pkg|pipewire-media-session}} のこの問題を解決するには:

{{hc|/etc/pipewire/media-session.d/alsa-monitor.conf (or ~/.config/pipewire/media-session.d/alsa-monitor.conf|2=
api.alsa.headroom = 1024
}}

{{pkg|wireplumber}} を使用する場合:

{{hc|/etc/wireplumber/main.lua.d/50-alsa-config.lua (or ~/.config/wireplumber/main.lua.d/50-alsa-config.lua)|2=
apply_properties = {
["api.alsa.headroom"] = 1024,
},
}}

カーネルページのロックやスケジューリングの遅延が原因で音声の途切れが発生する場合は、[[ゲーム#カーネルパラメータを調整して応答時間を安定化させる|カーネルパラメータを調整して応答時間を安定化させる]] を参照してください。

==== 音がひずむ ====
* マイクについては、{{ic|alsamixer}} を起動し、問題があるサウンドカードを選択し、{{ic|Mic Boost}} や {{ic|Internal Mic Boost}} の値を下げてみてください。
* {{ic|/etc/pipewire/pipewire.conf}} の {{ic|1=default.clock.rate = 48000}} のコメントを外して、値を {{ic|44100}} に下げてみてください。

==== スタンバイ後に音声の問題が発生する ====

スリープから復帰した際に音が消えたり壊れたりする場合は、ALSA を最初期化すると改善するかもしれません:

# alsactl init

==== USB DAC(例:Schiit 社製 DAC)で高レイテンシー ====

サンプルレートやフォーマットを変更することで、Schiit Hel 2 などの一部の DAC でレイテンシーを減らすことができるかもしれません [https://www.reddit.com/r/osugame/comments/msifdd/usb_dacamp_and_audio_lag/] ''pipewire-media-session'' のマッチングルールを使用すると、デバイスのプロパティを設定することができます [https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/Config-pipewire-media-session#matching-rules]
''pipewire-media-session'' の {{ic|alsa-monitor.conf}} のデフォルト設定を {{ic|/etc/pipewire/media-session.d}} か {{ic|~/.config/pipewire/media-session.d}} にコピーしてください。
そして、以下のような新しいルールブロックを追加してください。

{{hc|/etc/pipewire/media-session.d/alsa-monitor.conf
~/.config/pipewire/media-session.d/alsa-monitor.conf|output=
rules = {
...
{
matches = [
{
node.name = "alsa_output.<name of node>"
}
]
actions = {
update-props = {
audio.format = "S24_3LE"
audio.rate = 96000
# Following value should be doubled until audio doesn't cut out or other issues stop occurring
api.alsa.period-size = 128
}
}
}
...
}
}}

{{ic|alsa_output.<node name>}} ノードは {{ic|pw-top}} で取得することができます。

DAC は異なるフォーマットやサンプルレートをサポートしているかもしれません。[[ALSA]] に問い合わせることで、あなたの DAC が何をサポートしているかを確認することができます。

まず、DAC のカード番号を取得します。

{{hc|$ aplay -l|
...
card 3: S2 [Schiit Hel 2], device 0: USB Audio [USB Audio]
Subdevices: 0/1
Subdevice #0: subdevice #0
...
}}

つまり、この例ではカード3ということになります。
サポートされているすべてのサンプルレートとフォーマットを取得します。

{{hc|$ cat /proc/asound/cardX/streamX|
...
Playback:
...
Interface 1
Altset 1
Format: S16_LE
Channels: 2
Endpoint: 0x05 (5 OUT) (ASYNC)
Rates: 44100, 48000, 88200, 96000, 176400, 192000, 352800, 384000
Data packet interval: 125 us
Bits: 16
...
Interface 1
Altset 2
Format: S24_3LE
Channels: 2
Endpoint: 0x05 (5 OUT) (ASYNC)
Rates: 44100, 48000, 88200, 96000, 176400, 192000, 352800, 384000
Data packet interval: 125 us
Bits: 24
...
Interface 1
Altset 3
Format: S32_LE
Channels: 2
Endpoint: 0x05 (5 OUT) (ASYNC)
Rates: 44100, 48000, 88200, 96000, 176400, 192000, 352800, 384000
Data packet interval: 125 us
Bits: 32
...
...
}}

この場合、{{ic|S16_LE, S24_3LE, S32_LE}} はサポートされているフォーマットで、{{ic|44100, 48000, 88200, 96000, 176400, 192000, 352800, 384000}} はすべてのフォーマットでサポートされているサンプルレートとなります。

==== 音量が 30% になるまで USB DAC から音が出ない ====

USB DAC の中には、ある一定の音量に達するまで音が出なくなるものがあります [https://gitlab.freedesktop.org/pipewire/pipewire/-/issues/1117] 一般的にこれは約 25%〜30% で、最初の音量が不快なほど大きくなり、低い音量を維持することができなくなります。解決策としては、{{ic|["api.alsa.soft-mixer"]}} を {{ic|true}} に設定して、ハードウェアミキサーの音量コントロールを無視することが挙げられます。

{{Pkg|wireplumber}} でこれを実現するには、{{ic|/usr/share/wireplumber/main.lua.d/50-alsa-config.lua}} 設定に次を使用して構成フラグメントを追加します。 {{ic|table.insert}}:

{{hc|~/.config/wireplumber/main.lua.d/51-volume-fix.lua|output=

table.insert (alsa_monitor.rules, {
matches = {
{
-- This matches all cards.
{ "device.name", "matches", "alsa_card.*" },
},
},
-- Apply properties on the matched object.
apply_properties = {
-- Don't use the hardware mixer for volume control. It
-- will only use software volume. The mixer is still used
-- to mute unused paths based on the selected port.
["api.alsa.soft-mixer"] = true,
}
})
}}

次に、pipewire を再起動します。{{ic|alsamixer}} でマスターボリュームを設定し、{{ic|# alsactl store}} で設定を保存します。これで、ボリュームミキサーを通常どおり使用できるようになります。

==== リアルタイムオーディオが動作しない ====

{{ic|RTKit error: org.freedesktop.DBus.Error.AccessDenied}} が {{ic|systemctl --user status pipewire.service}} の出力に表示された場合、pipewire daemon の優先度がリアルタイムに変更されていないことを示します。この問題については、[https://gitlab.freedesktop.org/pipewire/pipewire/-/issues/1069] を参照してください。

==== 同じサウンドカード上の複数のシンクへの同時出力 ====

{{ic|/usr/share/alsa-card-profile/mixer/profile-sets/default.conf}} のコピーを作成し、アップデート後も変更が持続するようにします。ここでは、アナログと HDMI の2つのデフォルトマッピングを結合したプロファイルを定義しています。

{{hc|/usr/share/alsa-card-profile/mixer/profile-sets/multiple.conf|2=
[General]
auto-profiles = no

[Mapping analog-stereo]
device-strings = front:%f
channel-map = left,right
paths-output = analog-output analog-output-lineout analog-output-speaker analog-output-headphones analog-output-headphones-2
paths-input = analog-input-front-mic analog-input-rear-mic analog-input-internal-mic analog-input-dock-mic analog-input analog-input-mic analog-input-linein analog-input-aux analog-input-video analog-input-tvtuner analog-input-fm analog-input-mic-line analog-input-headphone-mic analog-input-headset-mic
priority = 15

[Mapping hdmi-stereo]
description = Digital Stereo (HDMI)
device-strings = hdmi:%f
paths-output = hdmi-output-0
channel-map = left,right
priority = 9
direction = output

[Profile multiple]
description = Analog Stereo Duplex + Digital Stereo (HDMI) Output
output-mappings = analog-stereo hdmi-stereo
input-mappings = analog-stereo
}}

ここで、PipeWire の media-session に、新しい card-profile を使用してデバイスをマッチングするように設定します。識別情報は、{{ic|$ pw-cli dump device}} で見つけることができます。

{{hc|/etc/pipewire/media-session.d/alsa-monitor.conf|2=
rules = [
{
matches = [ { alsa.card_name = "HDA Intel PCH" } ]
actions = {
update-props = {
api.alsa.use-acp = true
device.profile-set = "multiple.conf"
device.profile = "multiple"
api.acp.auto-profile = false
api.acp.auto-port = false
}
}
}
]
}}

==== Discord から通知音が鳴らない ====

min.quantum が低すぎることが原因かもしれませんので、700以上に設定してみてください。pipewire-pulse.conf の pulse.rules セクションに以下のルールを追加することで、Discord 専用にオーバーライドすることが可能です。

{{hc|/etc/pipewire/pipewire-pulse.conf (or ~/.config/pipewire/pipewire-pulse.conf)|output=
...
pulse.rules = [
...
{
# Discord notification sounds fix
matches = [ { application.process.binary = "Discord" } ]
actions = {
update-props = {
pulse.min.quantum = 1024/48000 # 21ms
}
}
}
...
}}

==== PipeWire で FMOD ゲームがクラッシュする ====

[[Wikipedia:Pillars_of_Eternity|Pillars of Eternity]] のような古いバージョンの [[Wikipedia:FMOD|FMOD オーディオエンジン]] を使っているゲームの中には、PulseAudio バイナリが存在しないと {{ic|pulseaudio --check}} を呼び出してクラッシュするものがあります。回避策としては、{{ic|/bin/pulseaudio}}を{{ic|/bin/true}}にシンボリックリンクすることです[https://gitlab.freedesktop.org/pipewire/pipewire/-/issues/1514]

# ln -s /bin/true /bin/pulseaudio

PulseAudio を再インストールする場合は、シンボリックリンクを削除する必要があることに注意してください。

==== 自動切り替えが機能しない ====

自動切り替えが機能しない場合、[[WirePlumber]] の状態に問題がある可能性があります。[https://gitlab.freedesktop.org/pipewire/wireplumber/-/issues/191#note_1252549 this comment] が提案しているように、[[WirePlumber]] のローカル状態を削除し、デーモンを再起動することで改善されるかどうか確認することができます。

$ rm -r ~/.local/state/wireplumber/

次に、{{ic|wireplumber.service}} [[systemd/ユーザー|ユーザーユニット]] を [[ヘルプ:読み方# systemd ユニットのコントロール|再起動]] します。

==== リアルタイムプライオリティの欠落/サスペンド後の負荷によるクラックリング ====

rtkit の [https://github.com/heftig/rtkit/issues/13 2011年] からのバグにより、サスペンドイベントが発生すると PipeWire のリアルタイム優先度が取り消され、元に戻らなくなります。この原因となる保護を無効にするには、{{ic|rtkit-daemon.service}} を [[編集]] してください:

{{hc|/etc/systemd/system/rtkit-daemon.service.d/override.conf|2=
[Service]
ExecStart=
ExecStart=/usr/lib/rtkit-daemon --no-canary
}}

次に、メディアセッションサービスとともに、{{ic|rtkit-daemon.service}} ユニットと {{ic|pipewire.service}} ユーザーユニットを再起動します。

==== RAOP デバイス (Sonos など) へのストリーミング中に音が出ない ====

[[Avahi]] または [[systemd-resolved]] を使用して mDNS ホスト名解決を設定します。

==== KDE Plasma でサウンドデバイスが表示されない ====

PipeWire クライアント (デスクトップ環境を含む) は、[https://specations.freedesktop.org/basedir-spec/basedir-spec-latest.html#variables XDG_RUNTIME_DIR] [[環境変数]] に依存して PipeWire デーモンに接続する場合があります。[https://docs.pipewire.org/page_daemon.html] ログイン直後にサウンドデバイスが表示されない場合は、この変数が手動で間違ったパスに設定されている可能性があります。

これは PipeWire を手動で再起動することで解決できますが、Chromium で画面共有できない ({{ic|pipewire context failed}} により) など、他の問題が依然として発生する可能性があります。{{ic|XDG_RUNTIME_DIR}} は {{man|8|pam_systemd}} によって自動的に設定されるため、初期化ファイルに設定されているインスタンスをすべて削除する必要があります。

=== ビデオ ===

==== OBS(など)がウィンドウ/スクリーンを要求しても何も表示されない ====

{{Pkg|xdg-desktop-portal}} と {{Pkg|xdg-desktop-portal-gtk}} または {{Pkg|xdg-desktop-portal-kde}} がインストールされていることが確実なら、デーモンの実行状態を確認してください。

OBS では、すべてがうまくいっていれば、{{ic|stdout}} にこのように表示されるはずです。

...
info: [pipewire] desktop selected, setting up screencast
info: [pipewire] created stream 0x5632d7456850
info: [pipewire] playing stream...

マルチモニタ環境では、{{Pkg|slurp}} パッケージを使用すると、すべての画面をキャプチャすることができます。

== 参照 ==

* [https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/home Wiki] — PipeWire Wiki on Freedesktop GitLab
* [https://blogs.gnome.org/uraeus/2018/01/26/an-update-on-pipewire-the-multimedia-revolution-an-update/ Pipewire Update Blog Post] — PipeWire の2018年1月時点での進捗が書かれた記事
* [https://blogs.gnome.org/uraeus/2020/09/04/pipewire-late-summer-update-2020/ PipeWire Late Summer Update 2020] — 2020年9月からの記事

Waydroid

2024-09-28T14:45:10Z

DreamChaser: テンプレートや用語の訂正などを含む

[[Category:サンドボックス]]
[[Category:仮想化]]
[[Category:Android]]
[[en:Waydroid]]

{{Related articles start}}
{{Related|Anbox}}
{{Related|Linux Containers}}
{{Related articles end}}

{{Style|Need to improve style.}}

[https://waydro.id Waydroid] は、通常の Linux システム上で完全な Android システムを起動するコンテナベースな手法です。

== 前提条件 ==

=== CPU 要件 ===

要件は CPU アーキテクチャによって異なります。詳しくは [https://developer.android.com/ndk/guides/abis#sa テーブル]で確認することができます。

必要な CPU 命令があるかどうかは、{{ic|cat /proc/cpuinfo}} で確認することができます。

=== GPU 要件 ===

Waydroid は現在 Intel GPU で最適に動作します。そのまますぐに使用できるはずです。

すべての AMD GPU はサポートされています。もし Waydroid が動作しない場合は、新しい Waydroid イメージ(イメージはRadeon 680M で動作します)をビルドするか、以下の NVIDIA の手順を試してみてください。

NVIDIA GPU は現在動作しませんが、2 つの回避策があります:

# 可能であれば統合グラフィックカードに切り替えます
# ソフトウェアレンダリングを使用します ([[#ソフトウェアレンダリング]] を参照)

=== Wayland セッションマネージャ ===

Waydroid は [[Wayland]] セッションマネージャーでのみ動作しますので、Wayland セッションであることを確認してください。

X11 を使用している場合でも、多くの Wayland セッションマネージャーはネストされたセッションをサポートしていることに注意してください (そのため、X11 セッション内で実行できます)。最も単純な例は {{pkg|cage}} です。

=== カーネルモジュール ===

まず、binder モジュールが付属しているカーネルを実行する必要があります。これらは Arch Linux のデフォルトカーネル ({{Pkg|linux}}) の一部ではないため、これらのモジュールを同梱するカーネルをインストールする必要があります。

また、他のカーネルを使用するために、ブートローダーを設定する必要がある場合もあります。新しいカーネルでブートローダーを起動する方法については、wiki ページを参照してください。他のカーネル (のバージョン) での起動は、Linux システムの再起動が必要になる数少ないケースの 1 つです。 Waydroid を起動する前に、これらのモジュールを使用してカーネルを起動する必要があります。

互換性のあるカーネルを入手するには、複数の方法があります。

==== Linux-Zen を使用する ====

{{Pkg|linux-zen}} カーネルには、必要なモジュールが含まれています。これは、カーネルをコンパイルする必要がなく (コンパイルには時間がかかります)、定期的に更新バージョンを受け取るため、最も快適な方法と言えます。

==== DKMS モジュール ====

{{aur|binder_linux-dkms}} をインストールし、モジュールオプション {{ic|1=devices=binder,hwbinder,vndbinder}} を指定して [[カーネルモジュール]] {{ic|1=binder_linux}} をロードします ([https://github.com/waydroid/waydroid/issues/904#issuecomment-1869579022 バグレポート]を参照)。

{{bc|1=<nowiki/>
$ sudo modprobe binder-linux device=binder,hwbinder,vndbinder
}}

カーネル 5.18 以降での問題を回避するには、[[カーネルパラメータ]] {{ic|1=ibt=off}} を使用する必要もあります。 [https://bbs.archlinux.org/viewtopic.php?id=293566 {{ic|1=/dev/binderfs}} マウント時のセグメンテーション違反] を参照してください。

==== カーネルをビルドする ====

あるいは、必要なオプションを指定して {{Pkg|linux}} カーネル、または他のカーネルパッケージ (>=5.7) を再コンパイルすることもできます。 [[カーネル#コンパイル]] も参照してください。

最小限のカーネルをビルドするときは、次の要件に留意してください。
* IPv6 のサポート。カーネルに IPv6 ネットワークが組み込まれていない場合、Waydroid では IPv4 接続が行われません。
* Netlink ソケット ({{ic|1=CONFIG_NF_CT_NETLINK=y}})。
* PSI ({{ic|1=CONFIG_PSI=y}})。
* ループブロック・デバイス ({{ic|1=CONFIG_BLK_DEV_LOOP=m}}) - Waydroid を起動する前に、{{ic|loop}} モジュールをロードする必要があります。

コンパイルオプションを設定する場合、以下の 2 つのオプションを使用できます。
''binder'' と ''binderfs'' です。両方の手順を以下に示します。

===== binder を使用する =====

このモジュールは、カーネルにコンパイルすることも ({{ic|y}})、モジュールにコンパイルすることも ({{ic|m}})、まったくコンパイルしないこともできます ({{ic|n}})。また、構成内のすべての組み合わせが可能であるわけではなく、一部のオプションには他のオプションが必要になります。

以下の構成オプションは、binder をモジュールとしてコンパイルしますが、最後のオプションは、binder モジュールがロードされるときに、{{ic|/dev/}} ディレクトリに 3 つのデバイスが作成されることを指定します。

{{bc|1=
CONFIG_ANDROID=y
CONFIG_ANDROID_BINDER_IPC=m
CONFIG_ANDROID_BINDERFS=n
CONFIG_ANDROID_BINDER_DEVICES="binder,hwbinder,vndbinder"
}}

AUR からカーネルをビルドする場合、次の手順で構成を更新できます。

# {{ic|makepkg --nobuild}} を実行します。これにより、ダウンロードされたソースが検証および展開され、{{ic|prepare()}} 関数が実行されます。
# カーネルディレクトリの下部にある {{ic|.config}} ファイル (ファイル名にドットを含む) を編集します。
# {{ic|prepare()}} 関数の最後にあるのは、おそらくコンフィグ ({{ic|make olddefconfig}}かもしれません) からの情報を使用して makefile を再生成するコマンドです。それを {{ic|build()}} 関数に移動するか、自分で実行します。
# {{ic|makepkg --noextract}} を実行します。これは、{{ic|makepkg --nobuild}} が中断された場所から再開します。

===== bindingfs を使用する =====

binder カーネルモジュールは、複数のユーザーに問題を引き起こすことが知られています。これらの問題に対処するために、binderfs が作成されました。カーネルをコンパイルするときに、古い方法と新しい方法のどちらかを選択する必要があります。以下のオプションでは、代わりに bindingfs を使用します。

カーネルソースには、構成オプションを設定するための簡単なスクリプトも付属しています。コンフィグを手動で編集する場合と同様に、依存関係のチェックは行われません。 {{ic|.config}} ファイルと同じディレクトリにある場合は、次のコマンドを実行できます：

{{bc|
$ scripts/config --enable CONFIG_ANDROID
$ scripts/config --enable CONFIG_ANDROID_BINDER_IPC
$ scripts/config --enable CONFIG_ANDROID_BINDERFS
$ scripts/config --set-str CONFIG_ANDROID_BINDER_DEVICES ""
}}

AUR からカーネルをビルドする場合、これらの行を [[PKGBUILD]] の適切な場所 (通常は {{ic|prepare()}}) に挿入するだけで十分です。

==== binder デバイスのセットアップ ====

Waydroid パッケージの最新バージョンがあることを確認してください。これは Waydroid が自動的に処理します。

== インストール ==

{{AUR|waydroid}} を [[インストール]] します。

必要に応じて、{{AUR|waydroid-image}} または {{AUR|waydroid-image-gapps}} をインストールして、AUR を通じて必要な Android イメージを入手します。ただし、Waydroid 自体にイメージのダウンロードを処理させることをお勧めします。

Waydroid を初期化した後、最新の Android イメージがまだ利用できない場合は自動的にダウンロードされます。

# waydroid init

GAppsを利用して初期化するには：

# waydroid init -s GAPPS -f

次に、{{ic|waydroid-container.service}}を[[起動/有効化]]します。

これで Waydroid が動作するはずです。

== 使い方 ==

{{ic|waydroid-container.service}} が [[起動]] していることを確認してから、次を実行します：

$ waydroid session start

Waydroid セッションがアクティブになりました。対話コマンドの例を次に示します：

GUI を起動します：

$ waydroid show-full-ui

シェルを起動します：

# waydroid shell

アプリケーションをインストールします：

$ waydroid app install $path_to_apk

アプリケーション一覧を取得します：

$ waydroid app list

アプリケーションを実行します：

$ waydroid app launch $package_name

== ネットワーク ==

ネットワークはそのまま動作するはずですが、そうでない場合は、[[インターネット共有#パケット転送を有効にする|パケット転送]] がカーネルで有効になっていることを確認し、''Waydroid session start'' の実行 "前" にファイアウォールで次のルールを許可する必要があるかもしれません。

{{pkg|ufw}} を例として挙げます。

* DNS トラフィックを許可する必要があります:
** {{bc|# ufw allow 67}}
** {{bc|# ufw allow 53}}
* パケット転送を許可する必要があります:
** {{bc|# ufw default allow FORWARD}}

{{pkg|firewalld}} の場合は、次のコマンドを使用できます。

* DNS:
** {{bc|1=# firewall-cmd --zone=trusted --add-port=67/udp}}
** {{bc|1=# firewall-cmd --zone=trusted --add-port=53/udp}}
* パケット転送:
** {{bc|1=# firewall-cmd --zone=trusted --add-forward}}
* waydroid インターフェイスを信頼するプログラムに追加します:
** {{bc|1=# firewall-cmd --zone=trusted --add-interface=waydroid0}}

{{Note|waydroid によって作成されたインターフェース {{ic|waydroid0}} は自動的に firewalld ゾーン {{ic|trusted}} に置かれることを想定しています。そうでない場合は、上記のコマンドを調整するか、インターフェース {{ic|waydroid0}} を {{ic|trusted}} に移動してください。再起動後も変更を維持するには、{{bc|# firewall-cmd --runtime-to-permanent}} も必要になる場合があります。}}

== ヒントとテクニック ==

=== ソフトウェアレンダリング ===

以下をすでに実行していることを確認してください：

# waydroid init

(詳細については、[[#インストール]] セクションを参照してください)

次に、以下を追加します。

{{hc|/var/lib/waydroid/waydroid_base.prop|<nowiki>
ro.hardware.gralloc=default
ro.hardware.egl=swiftshader
</nowiki>}}

最後に、{{ic|waydroid-container.service}} を [[再起動]] します。

=== 表示領域の寸法設定 ===

waydroid ウィンドウのサイズを設定するには、次のコマンドを使用して好みに合わせてサイズに調整します。

$ waydroid prop set persist.waydroid.width 576
$ waydroid prop set persist.waydroid.height 1024

次に、{{ic|waydroid-container.service}} を [[再起動]] します。

== トラブルシューティング ==

問題が発生した場合は、公式の Issue Tracker を参照してください: [https://github.com/waydroid/waydroid/issues Waydroid issue tracker]。

=== 一般的なヒント ===

Waydroid は開発が速いため、問題が発生した場合に、最初に行うべき手順のリストを次に示します。

# Waydroid パッケージが最新であることを確認してください。
# 以下を実行して、最新の Waydroid イメージがあることを確認してください。 {{bc|# waydroid upgrade}}
# Waydroid をリセットします。 {{ic|waydroid-container.service}} を [[停止]] し、{{bc|# waydroid init -f}} を実行して、サービスを再度 [[起動]] します。
# ちょっとしたクリーンアップを行うこともできます。 {{bc|# rm -rf /var/lib/waydroid /home/.waydroid}} {{bc|$ rm -rf ~/waydroid ~/.share/waydroid ~/.local/share/applications/*aydroid* ~/.local/share/waydroid}}を実行します。
::{{Tip| [https://github.com/waydroid/waydroid/commit/eef036b3f814a9fc4869ebfe6c9d2bd51fa19f26 2021-9-xx] 以降にインストールした場合は、{{ic|/home/.waydroid/}} を削除する必要はありません。}}

=== ARM アプリと互換性がない ===

Casualsnek の [https://github.com/casualsnek/waydroid_script スクリプト] を使用して、変換レイヤーをインストールします。

変換レイヤーの最適化のため、AMD CPU では libndk を使用し、Intel CPU では libhoudini を使用することをお勧めします。ただし、アプリによっては、ある変換レイヤーでは機能し、別の翻訳レイヤーでは機能しないものもあります。したがって、ゲームが動作しない場合やパフォーマンスが低下する場合は、両方を試す必要がある場合があります。

''libndk arm translation をインストール''

# python3 main.py install libndk

''libhoudini arm translation をインストール''

# python3 main.py install libhoudini

=== 画面回転するとアプリが使えなくなる ===

[https://github.com/waydroid/waydroid/issues/70 Issue 70] を参照してください。

「F11」をクリックして、現在のアプリをウィンドウモードに切り替えます。

=== クリップボードマネージャーサービスの起動に失敗する ===

{{aur|python-pyclip}} とその依存関係をグラフィカルセッションにインストールします (X11 の場合は {{pkg|xclip}}、Wayland の場合は {{pkg|wl-clipboard}})。

=== 物理キーボードが動作しない場合がある ===

左の {{ic|Alt}} キーを押してください。

=== dnsmasq: failed to open pidfile /run/waydroid-lxc/dnsmasq.pid: Permission denied ===

AppArmor ルールが設定されていない可能性があります。次のルールを追加します。

{{hc|/etc/apparmor.d/usr.sbin.dnsmasq|
@{run}/waydroid-lxc/r,
@{run}/waydroid-lxc/* rw,
}}

=== Waydroid シェル内のコマンド出力にアクセスできない、または見つからない ===

Arch ベースのディストリビューションには、[[Linux コンテナ#基本的な使用方法| lxc-attach の動作中に表示される恐れのあるバグ]] があり、これにより、{{ic|adbd}} または {{ic|settings}} のような {{ic|waydroid shell}} 内のコマンドでこの問題が発生する可能性があります。

この問題を回避するには、{{ic|waydroid shell}} コマンドを次のように置き換えることが考えられます。
# lxc-attach -P /var/lib/waydroid/lxc/ -n waydroid --clear-env

=== WARNING: Service manager /dev/binder has died ===

[https://github.com/waydroid/waydroid/issues/136 Isuue 136] を参照してください。

[https://docs.kernel.org/accounting/psi.html PSI] を有効にする必要があります。

{{ic|1=psi=1}} を [[カーネルパラメータ|カーネルコマンドライン]] に追加します。

Liquorix カーネル([https://github.com/damentz/liquorix-package/commit/2dd0b878dbd27bdc5e796a7bd7384676df9e6764 Waydroid では動作しません])は、PSI と互換性のない特定のスケジューラーを使用するため、注意してください。

=== multi-GPU systemを使用すると表示がおかしくなる ===

現在、Waydroid はホストコンポジターが実行されているのと同じ GPU 上で実行する必要があります。これを修正する 2 つの方法は、{{ic|/var/lib/waydroid/lxc/waydroid/config_nodes}} を編集して正しい GPU になるようにするか、コンポジターが実行される GPU を変更するかのいずれかです。

== 参照 ==

* [https://github.com/waydroid/waydroid Waydroid GitHub repo]
* [https://docs.waydro.id/ Waydroid documentation]
* [https://matrix.to/#/#waydroid:connolly.tech Waydroid Matrix group]
* [https://t.me/WayDroid Waydroid Telegram group]

{{TranslationStatus|Waydroid|2024-09-28|816118}}

Waydroid

2024-09-28T13:06:09Z

DreamChaser: 最新版への翻訳・加筆

[[Category:サンドボックス]]
[[Category:仮想化]]
[[Category:Android]]
[[en:Waydroid]]

{{Related articles start}}
{{Related|Anbox}}
{{Related|Linux Containers}}
{{Related articles end}}

{{Style|Need to improve style.}}

[https://waydro.id Waydroid] は、通常の Linux システム上で完全な Android システムを起動するコンテナベースな手法です。

== 前提条件 ==

=== CPU 要件 ===

要件は CPU アーキテクチャによって異なります。詳しくは [https://developer.android.com/ndk/guides/abis#sa テーブル]で確認することができます。

必要な CPU 命令があるかどうかは、{{ic|cat /proc/cpuinfo}} で確認することができます。

=== GPU 要件 ===

Waydroid は現在 Intel GPU で最適に動作します。そのまますぐに使用できるはずです。

すべての AMD GPU はサポートされています。もし Waydroid が動作しない場合は、新しい Waydroid イメージ(イメージはRadeon 680M で動作します)をビルドするか、以下の NVIDIA の手順を試してみてください。

NVIDIA GPU は現在動作しませんが、2 つの回避策があります:

# 可能であれば統合グラフィックカードに切り替えます
# ソフトウェアレンダリングを使用します ([[#ソフトウェアレンダリング]] を参照)

=== Wayland セッションマネージャ ===

Waydroid は [[Wayland]] セッションマネージャーでのみ動作しますので、Wayland セッションであることを確認してください。

X11 を使用している場合でも、多くの Wayland セッションマネージャーはネストされたセッションをサポートしていることに注意してください (そのため、X11 セッション内で実行できます)。最も単純な例は {{pkg|cage}} です。

=== カーネルモジュール ===

まず、binder モジュールが付属しているカーネルを実行する必要があります。これらは Arch Linux のデフォルトカーネル ({{Pkg|linux}}) の一部ではないため、これらのモジュールを同梱するカーネルをインストールする必要があります。

また、他のカーネルを使用するために、ブートローダーを設定する必要がある場合もあります。新しいカーネルでブートローダーを起動する方法については、wiki ページを参照してください。他のカーネル (のバージョン) での起動は、Linux システムの再起動が必要になる数少ないケースの 1 つです。 Waydroid を起動する前に、これらのモジュールを使用してカーネルを起動する必要があります。

互換性のあるカーネルを入手するには、複数の方法があります。

==== Linux-Zen を使用する ====

{{Pkg|linux-zen}} カーネルには、必要なモジュールが含まれています。これは、カーネルをコンパイルする必要がなく (コンパイルには時間がかかります)、定期的に更新バージョンを受け取るため、最も快適な方法と言えます。

==== DKMS モジュール ====

{{aur|binder_linux-dkms}} をインストールし、モジュールオプション {{ic|devices{{=}}binder,hwbinder,vndbinder}} を指定して [[カーネルモジュール]] {{ic|binder_linux}} をロードします ([https://github.com/waydroid/waydroid/issues/904#issuecomment-1869579022 バグレポート]を参照)。

{{bc|
$ sudo modprobe binder-linux device{{=}}binder,hwbinder,vndbinder
}}

カーネル 5.18 以降での問題を回避するには、[[カーネルパラメータ]] {{ic|ibt{{=}}off}} を使用する必要もあります。 [https://bbs.archlinux.org/viewtopic.php?id=293566 {{ic|/dev/binderfs}} マウント時のセグメンテーション違反] を参照してください。

==== カーネルをビルドする ====

あるいは、必要なオプションを指定して {{Pkg|linux}} カーネル、または他のカーネルパッケージ (>=5.7) を再コンパイルすることもできます。 [[カーネル#コンパイル]] も参照してください。

最小限のカーネルをビルドするときは、次の要件に留意してください。
* IPv6 のサポート。カーネルに IPv6 ネットワークが組み込まれていない場合、Waydroid では IPv4 接続が行われません。
* Netlink ソケット ({{ic|CONFIG_NF_CT_NETLINK{{=}}y}})。
* PSI ({{ic|CONFIG_PSI{{=}}y}})。
* ループブロック・デバイス ({{ic|CONFIG_BLK_DEV_LOOP{{=}}m}}) - Waydroid を起動する前に、{{ic|loop}} モジュールをロードする必要があります。

コンパイルオプションを設定する場合、2 つのオプションを使用できます。
''binder'' と ''binderfs'' です。両方の手順を以下に示します。

===== binder を使用する =====

このモジュールは、カーネルにコンパイルすることも ({{ic|y}})、モジュールにコンパイルすることも ({{ic|m}})、まったくコンパイルしないこともできます ({{ic|n}})。また、構成内のすべての組み合わせが可能であるわけではなく、一部のオプションには他のオプションが必要になります。

以下の構成オプションは、binder をモジュールとしてコンパイルしますが、最後のオプションは、binder モジュールがロードされるときに、{{ic|/dev/}} ディレクトリに 3 つのデバイスが作成されることを指定します。

{{bc|1=
CONFIG_ANDROID=y
CONFIG_ANDROID_BINDER_IPC=m
CONFIG_ANDROID_BINDERFS=n
CONFIG_ANDROID_BINDER_DEVICES="binder,hwbinder,vndbinder"
}}

AUR からカーネルをビルドする場合、次の手順で構成を更新できます。

# {{ic|makepkg --nobuild}} を実行します。これにより、ダウンロードされたソースが検証および展開され、{{ic|prepare()}} 関数が実行されます。
# カーネルディレクトリの下部にある {{ic|.config}} ファイル (ファイル名にドットを含む) を編集します。
# {{ic|prepare()}} 関数の最後にあるのは、おそらくコンフィグ ({{ic|make olddefconfig}}かもしれません) からの情報を使用して makefile を再生成するコマンドです。それを {{ic|build()}} 関数に移動するか、自分で実行します。
# {{ic|makepkg --noextract}} を実行します。これは、{{ic|makepkg --nobuild}} が中断された場所から再開します。

===== bindingfs を使用する =====

binder カーネルモジュールは、複数のユーザーに問題を引き起こすことが知られています。これらの問題に対処するために、binderfs が作成されました。カーネルをコンパイルするときに、古い方法と新しい方法のどちらかを選択する必要があります。以下のオプションでは、代わりに bindingfs を使用します。

カーネルソースには、構成オプションを設定するための簡単なスクリプトも付属しています。コンフィグを手動で編集する場合と同様に、依存関係のチェックは行われません。 {{ic|.config}} ファイルと同じディレクトリにある場合は、次のコマンドを実行できます：

{{bc|
$ scripts/config --enable CONFIG_ANDROID
$ scripts/config --enable CONFIG_ANDROID_BINDER_IPC
$ scripts/config --enable CONFIG_ANDROID_BINDERFS
$ scripts/config --set-str CONFIG_ANDROID_BINDER_DEVICES ""
}}

AUR からカーネルをビルドする場合、これらの行を [[PKGBUILD]] の適切な場所 (通常は {{ic|prepare()}}) に挿入するだけで十分です。

==== binder デバイスのセットアップ ====

Waydroid パッケージの最新バージョンがあることを確認してください。これは Waydroid が自動的に処理します。

== インストール ==

{{AUR|waydroid}} を [[インストール]] します。

必要に応じて、{{AUR|waydroid-image}} または {{AUR|waydroid-image-gapps}} をインストールして、AUR を通じて必要な Android イメージを入手します。ただし、Waydroid 自体にイメージのダウンロードを処理させることをお勧めします。

Waydroid を初期化した後、最新の Android イメージがまだ利用できない場合は自動的にダウンロードされます。

# waydroid init

GAppsを利用して初期化するには：

# waydroid init -s GAPPS -f

次に、{{waydroid-container.service}}を[[起動/有効化]]します。

これで Waydroid が動作するはずです。

== 使い方 ==

{{ic|waydroid-container.service}} が [[start]] されていることを確認してから、次を実行します：

$ waydroid session start

Waydroid セッションがアクティブになりました。対話コマンドの例を次に示します：

GUI を起動します：

$ waydroid show-full-ui

シェルを起動します：

# waydroid shell

アプリケーションをインストールします：

$ waydroid app install $path_to_apk

アプリケーション一覧を取得します：

$ waydroid app list

アプリケーションを実行します：

$ waydroid app launch $package_name

== ネットワーク ==

ネットワークはそのまま動作するはずですが、そうでない場合は、[[インターネット共有#パケット転送を有効にする|パケット転送]] がカーネルで有効になっていることを確認し、''Waydroid session start'' の実行 "前" にファイアウォールで次のルールを許可する必要があるかもしれません。

{{pkg|ufw}} を例として挙げます。

* DNS トラフィックを許可する必要があります:
** {{bc|# ufw allow 67}}
** {{bc|# ufw allow 53}}
* パケット転送を許可する必要があります:
** {{bc|# ufw default allow FORWARD}}

{{pkg|firewalld}} の場合は、次のコマンドを使用できます。

* DNS:
** {{bc|1=# firewall-cmd --zone=trusted --add-port=67/udp}}
** {{bc|1=# firewall-cmd --zone=trusted --add-port=53/udp}}
* パケット転送:
** {{bc|1=# firewall-cmd --zone=trusted --add-forward}}
* waydroid インターフェイスを信頼するプログラムに追加します:
** {{bc|1=# firewall-cmd --zone=trusted --add-interface=waydroid0}}

{{注|waydroid によって作成されたインターフェース {{ic|waydroid0}} は自動的に firewalld ゾーン {{ic|trusted}} に置かれることを想定しています。そうでない場合は、上記のコマンドを調整するか、インターフェース {{ic|waydroid0}} を {{ic|trusted}} に移動してください。再起動後も変更を維持するには、{{bc|# firewall-cmd --runtime-to-permanent}} も必要になる場合があります。}}

== ヒントとコツ ==

=== ソフトウェアレンダリング ===

以下をすでに実行していることを確認してください：

# waydroid init

(詳細については、[[#インストール]] セクションを参照してください)

次に、以下を追加します。

{{hc|/var/lib/waydroid/waydroid_base.prop|<nowiki>
ro.hardware.gralloc=default
ro.hardware.egl=swiftshader
</nowiki>}}

最後に、{{ic|waydroid-container.service}} を [[再起動]] します。

=== 表示領域の寸法設定 ===

waydroid ウィンドウのサイズを設定するには、次のコマンドを使用して好みに合わせてサイズに調整します。

$ waydroid prop set persist.waydroid.width 576
$ waydroid prop set persist.waydroid.height 1024

次に、{{ic|waydroid-container.service}} を [[再起動]] します。

== トラブルシューティング ==

問題が発生した場合は、公式の Issue Tracker を参照してください: [https://github.com/waydroid/waydroid/issues Waydroid issue tracker]。

=== 一般的なヒント ===

Waydroid は開発が速いため、問題が発生した場合に、最初に行うべき手順のリストを次に示します。

# Waydroid パッケージが最新であることを確認してください。
# {{bc|# waydroid upgrade}} を実行して、最新の Waydroid イメージがあることを確認してください
# Waydroid をリセットします: {{ic|waydroid-container.service}} を [[stop]] し、{{bc|# waydroid init -f}} を実行して、サービスを再度 [[start]] します。
# ちょっとしたクリーンアップを行うこともできます。 {{bc|# rm -rf /var/lib/waydroid /home/.waydroid}} {{bc|$ rm -rf ~/waydroid ~/.share/waydroid ~/.local/share/applications/*aydroid* ~/.local/share/waydroid}}を実行します。
::{{ヒント| [https://github.com/waydroid/waydroid/commit/eef036b3f814a9fc4869ebfe6c9d2bd51fa19f26 2021-09] 以降にインストールした場合は、{{ic|/home/.waydroid/}} を削除する必要はありません。}}

=== ARM アプリと互換性がない ===

Casualsnek の [https://github.com/casualsnek/waydroid_script スクリプト] を使用して、変換レイヤーをインストールします。

変換レイヤーの最適化のため、AMD CPU では libndk を使用し、Intel CPU では libhoudini を使用することをお勧めします。ただし、アプリによっては、ある変換レイヤーでは機能し、別の翻訳レイヤーでは機能しないものもあります。したがって、ゲームが動作しない場合やパフォーマンスが低下する場合は、両方を試す必要がある場合があります。

''libndk arm translation をインストール''

# python3 main.py install libndk

''libhoudini arm translation をインストール''

# python3 main.py install libhoudini

=== 画面回転するとアプリが使えなくなる ===

[https://github.com/waydroid/waydroid/issues/70 Issue 70] を参照してください。

「F11」をクリックして、現在のアプリをウィンドウモードに切り替えます。

=== クリップボードマネージャーサービスの起動に失敗します ===

{{aur|python-pyclip}} とその依存関係をグラフィカルセッションにインストールします (X11 の場合は {{pkg|xclip}}、Wayland の場合は {{pkg|wl-clipboard}})。

=== 物理キーボードが動作しない場合がある ===

左の {{ic|Alt}} キーを押してください。

=== dnsmasq: failed to open pidfile /run/waydroid-lxc/dnsmasq.pid: Permission denied（アクセス許可が拒否されました） ===

AppArmor ルールが設定されていない可能性があります。次のルールを追加します。

{{hc|/etc/apparmor.d/usr.sbin.dnsmasq|
@{run}/waydroid-lxc/r,
@{run}/waydroid-lxc/* rw,
}}

=== Waydroid シェル内のコマンド出力にアクセスできない、または見つからない ===

Arch ベースのディストリビューションには、[[Linuxコンテナ#基本的な使用法| lxc-attach の動作中に表示される恐れのある「バグ」]] があり、これにより、{{ic|adbd}} または {{ic|settings}} のような {{ic|waydroid shell}} 内のコマンドでこの問題が発生する可能性があります。

この問題を回避するには、{{ic|waydroid shell}} コマンドを次のように置き換えることが考えられます。
# lxc-attach -P /var/lib/waydroid/lxc/ -n waydroid --clear-env

=== WARNING: Service manager /dev/binder has died（dev/binderが停止しました） ===

[https://github.com/waydroid/waydroid/issues/136 Isuue 136] を参照してください。

[https://docs.kernel.org/accounting/psi.html PSI] を有効にする必要があります。

{{ic|1=psi=1}} を [[カーネルコマンドライン]] に追加します。

Liquorix カーネル [https://github.com/damentz/liquorix-package/commit/2dd0b878dbd27bdc5e796a7bd7384676df9e6764 は Waydroid では動作しません] は、PSI と互換性のない特定のスケジューラーを使用するため、注意してください。

=== multi-GPU systemを使用すると表示がおかしくなる ===

現在、Waydroid はホストコンポジターが実行されているのと同じ GPU 上で実行する必要があります。これを修正する 2 つの方法は、{{ic|/var/lib/waydroid/lxc/waydroid/config_nodes}} を編集して正しい GPU になるようにするか、コンポジターが実行される GPU を変更するかのいずれかです。

== こちらも参照してください ==

* [https://github.com/waydroid/waydroid Waydroid GitHub repo]
* [https://docs.waydro.id/ Waydroid documentation]
* [https://matrix.to/#/#waydroid:connolly.tech Waydroid Matrix group]
* [https://t.me/WayDroid Waydroid Telegram group]

利用者:DreamChaser

2024-09-28T04:45:48Z

DreamChaser: ページの作成:「技術者ではないので専門用語には疎いです。半年くらい放置されている未翻訳記事があったら翻訳しようかなと思っています。」

技術者ではないので専門用語には疎いです。
半年くらい放置されている未翻訳記事があったら翻訳しようかなと思っています。