WirePlumber - 版の履歴

Kgx: /* 設定 */ 同期

2025-03-07T13:08:54Z

設定: 同期

← 古い版		2025年3月7日 (金) 22:08時点における版
176行目:		176行目:

	{{Note\|一般的な使用例としては、NVIDIA の HDMI オーディオ出力を無効にする場合など。}}		{{Note\|一般的な使用例としては、NVIDIA の HDMI オーディオ出力を無効にする場合など。}}

			=== ノードの優先度の設定 ===

			自動的に選択されるシンクまたはソースを変更するには、その {{ic\|priority.driver}} と {{ic\|priority.session}} の値を設定する必要があります。

			{{hc\|/etc/wireplumber/wireplumber.conf.d/52-set-priorities.conf\|output=
			monitor.alsa.rules = [
			{
			matches = [
			{
			node.name = "alsa_output.usb-Generic_USB_Audio-00.HiFi__Speaker__sink"
			}
			]
			actions = {
			update-props = {
			priority.driver = 100
			priority.session = 100
			}
			}
			}
			]
			}}

			この例では、Asus B650E-F マザーボードのオンボードオーディオのスピーカー出力シンクの優先度を 100 に設定しています。これは元々の値である 1000 から低く設定されています。そのため、他の出力シンク(例えばオンボードオーディオデバイスの S/PDIF 出力や接続されているヘッドホンなど)がデフォルトで選択されることになります。それらのデバイスはより高い優先度を持っているため、アナログスピーカー出力ではなく、そちらが選ばれることになります。

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

			[[PipeWire#同じサウンドカード上の複数のシンクへの同時出力]] を参照してください。

	=== 一時的なデバイスへの同時出力 ===		=== 一時的なデバイスへの同時出力 ===

Kgx: /* 同じサウンドカード上の複数のシンクへの同時出力 */ 同期

2025-03-07T13:04:50Z

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

@@ 177行目: / 177行目: @@
 {{Note|一般的な使用例としては、NVIDIA の HDMI オーディオ出力を無効にする場合など。}}
-=== 同じサウンドカード上の複数のシンクへの同時出力 ===
+=== 一時的なデバイスへの同時出力 ===
 }}
 }}
 == ヒントとテクニック ==

Kgx: /* ヒントとテクニック */ 同期

2025-03-07T12:52:50Z

ヒントとテクニック: 同期

@@ 227行目: / 227行目: @@
 == ヒントとテクニック ==
 === キーボードで音量コントロール ===
@@ 257行目: / 265行目: @@
 {{Note|ミュートステータスは、シンクがミュートされている場合にのみ表示されます。}}
 === ログアウト後も Bluetooth を実行し続ける/ヘッドレス Bluetooth ===
@@ 269行目: / 281行目: @@
 {{Note|これに加えて、[[PipeWire]]/Wireplumber を実行しているユーザーに対しては[[systemd/ユーザー#systemd のユーザーインスタンスを自動起動|残留 (lingering)]] を有効にする必要があります。}}
 == 参照 ==

Kgx: /* ルールマッチングのためのインターフェース名の取得 */ 情報を更新

2023-10-19T09:34:00Z

ルールマッチングのためのインターフェース名の取得: 情報を更新

@@ 48行目: / 48行目: @@
 === ルールマッチングのためのインターフェース名の取得 ===
-WirePlumber の Lua スクリプトでは、設定したい対象インターフェースの [https://docs.pipewire.org/page_objects_design.html PipeWire objects] で {{ic|matches}} ルールを指定する必要があります。
+Lua スクリプトでは、設定するインターフェイスの [https://docs.pipewire.org/page_objects_design.html オブジェクト] のプロパティを使用して {{ic|matches}} ルールを指定する必要があります。
-システムで利用可能な全てのオブジェクトを表示するには、コマンド {{ic|pw-cli list-objects}} と {{ic|pw-cli dump}} を使用します。
+WirePlumber によって管理されているすべてのオブジェクトを表示するには、コマンド {{ic|wpctl status}} を使用します。ターゲットインターフェイスに割り当てられた {{ic|''ID''}} を見つけます。次に、コマンド {{ic|wpctl Inspection ''ID''}} を使用して、必要なプロパティを取得します。
 }}
 === デバイス/ノードのプロパティを変更する ===

AshMyzk: /* ログアウト後も Bluetooth を実行し続ける/ヘッドレス Bluetooth */ 訳を修正

2023-08-22T06:40:12Z

ログアウト後も Bluetooth を実行し続ける/ヘッドレス Bluetooth: 訳を修正

← 古い版		2023年8月22日 (火) 15:40時点における版
222行目:		222行目:
	=== ログアウト後も Bluetooth を実行し続ける/ヘッドレス Bluetooth ===		=== ログアウト後も Bluetooth を実行し続ける/ヘッドレス Bluetooth ===

	デフォルトでは、{{ic\|/usr/share/wireplumber/bluetooth.lua.d/50-bluez-config.lua}} により [https://gitlab.freedesktop.org/pipewire/wireplumber/-/merge_requests/222~~] が有効になります~~/diffs?commit_id=~~a253aa4c4948cdd87ba222670ee17db849af85ddlogind~~ ~~module]~~ これ~~により~~、セッションが終了する~~たびに~~ Bluetooth が無効~~になり~~ます。これは次の~~ようにオーバーライド~~できます。		デフォルトでは、{{ic\|/usr/share/wireplumber/bluetooth.lua.d/50-bluez-config.lua}} により [https://gitlab.freedesktop.org/pipewire/wireplumber/-/merge_requests/222/diffs?commit_id=a253aa4c4948cdd87ba222670ee17db849af85dd logind モジュール]が有効化されます。このモジュールは、セッションが終了すると Bluetooth を無効化します。この挙動は以下の設定で無効化できます:

	{{hc\|/etc/wireplumber/bluetooth.lua.d/50-bluez-config.lua (or ~/.config/wireplumber/bluetooth.lua.d/50-bluez-config.lua)\|2=		{{hc\|/etc/wireplumber/bluetooth.lua.d/50-bluez-config.lua (あるいは ~/.config/wireplumber/bluetooth.lua.d/50-bluez-config.lua)\|2=
	bluez_monitor.properties = {		bluez_monitor.properties = {
	["with-logind"] = false,		["with-logind"] = false,
230行目:		230行目:
	}}		}}

	{{Note\|[[PipeWire]]/Wireplumber を実行しているユーザーに対して [[systemd/ユーザー#systemd のユーザーインスタンスを自動起動\|残留]] を有効にする必要があります。}}		{{Note\|これに加えて、[[PipeWire]]/Wireplumber を実行しているユーザーに対しては[[systemd/ユーザー#systemd のユーザーインスタンスを自動起動\|残留 (lingering)]] を有効にする必要があります。}}

	== 参照 ==		== 参照 ==

Kgx: /* 設定 */ 設定の変更を翻訳して追加

2023-07-28T17:56:37Z

設定: 設定の変更を翻訳して追加

← 古い版		2023年7月29日 (土) 02:56時点における版
35行目:		35行目:

	{{ic\|lua.d/}} ディレクトリ内の Lua 設定ファイルは、{{ic\|''config-dir''/scripts/}} から Lua スクリプトも読み込みます。これらのスクリプトは Pipewire のロジック/機能の一部を実装しており、特定の状況下では変更する価値がある場合もあります。		{{ic\|lua.d/}} ディレクトリ内の Lua 設定ファイルは、{{ic\|''config-dir''/scripts/}} から Lua スクリプトも読み込みます。これらのスクリプトは Pipewire のロジック/機能の一部を実装しており、特定の状況下では変更する価値がある場合もあります。

			=== 設定の変更 ===

			WirePlumber を設定する推奨方法は、{{ic\|/etc/wireplumber/}} または {{ic\|~/.config/wireplumber/ 内の適切な {{ic\|lua.d/}} ディレクトリに Lua スクリプトを追加することです。}} 考慮すべき点は次のとおりです。

			* 上書きしたい既存のスクリプトがある場合は、{{ic\|/usr/share/wireplumber/}} からコピーしてください。同じ名前で優先順位の低い場所にある設定ファイルは無視されます [https://pipewire.pages.freedesktop.org/wireplumber/configuration/locations.html#location-of-configuration-files]
			* 新しいスクリプトを追加する場合、50 より大きな数字で始めるべきです (例:{{ic\|51-my-config.lua}}) デフォルトの設定は、英数字の並び順で 50 かそれ以下で行われることがほとんどだからです。
			** WirePlumber は [https://pipewire.pages.freedesktop.org/wireplumber/configuration/config_lua.html#multi-path-merging multi-path merging] を実行するため、英数字の並び順がディレクトリの優先順位よりも優先されるため、番号の低いストックの設定が新しいスクリプトよりも先に実行されることに注意してください。
			* 選択するディレクトリは、ストックの設定が行うものと一致している必要がありますが、[https://pipewire.pages.freedesktop.org/wireplumber/configuration/multi_instance.html 複数インスタンスを使用する] 場合ではない限り、厳密には重要ではありません。
			* Bluetooth デバイスの ALSA プロパティは {{ic\|bluetooth.lua.d/}} で設定する必要があります。Bluetooth デバイスの ALSA プロパティは {{ic\|main.lua.d/}} で設定されたものでは ''ありません''。

	=== ルールマッチングのためのインターフェース名の取得 ===		=== ルールマッチングのためのインターフェース名の取得 ===

Kgx: /* 設定 */ 設定ファイルのレイアウトを翻訳して追加

2023-07-28T17:50:48Z

設定: 設定ファイルのレイアウトを翻訳して追加

← 古い版		2023年7月29日 (土) 02:50時点における版
16行目:		16行目:

	== 設定 ==		== 設定 ==
	WirePlumber のモジュール設計は、特定の機能の実装を入れ替える際に、残りの機能を再実装する必要がなく、非常に柔軟性があります。詳細な情報は、[https://pipewire.pages.freedesktop.org/wireplumber/configuration.html official documentation] で見ることができます。

			=== 設定ファイルのレイアウト ===
	以下に、簡単な設定例を示します。

			[https://pipewire.pages.freedesktop.org/wireplumber/configuration.html WirePlumber の設定] は、変更された {{ic\|context}} や {{ic\|alsa_monitor}} などのグローバル PipeWire 風味の JSON オブジェクトで設定されていますその行動を変えるために。設定ファイルは、{{ic\|~/.config/wireplumber/}} (ユーザー構成)、{{ic\|/etc/wireplumber/}} (グローバル構成)、そして {{ic\|/usr/share/wireplumber/}} (ストック構成) から読み取られます。
⚫	=== ルールマッチングのためのインターフェース名の取得 ===

			WirePlumber は、[https://pipewire.pages.freedesktop.org/wireplumber/configuration/main.html メイン設定ファイル] を読み取ることから開始します。これは、PipeWire コンテキスト、[https://docs.pipewire.org/page_spa_plugins.html SPA プラグイン]、モジュール、およびコンポーネントを設定する JSON のようなファイルです。これらのコンポーネントの中には、グローバルオブジェクトを動的に変更するために使用される [[Wikipedia:ja:Lua\|Lua]] スクリプトエンジンがあります。

			パッケージに同梱されているさまざまな設定ファイルがあります。

			* シングルインスタンス設定ファイル{{ic\|/usr/share/wireplumber/wireplumber.conf}} これはデフォルトの設定であり、他のすべての設定の機能を1つのプロセス内に含んでいます。
			** すべてのメイン設定ファイルで使用されている "context" オブジェクトについては、[https://pipewire.pages.freedesktop.org/wireplumber/configuration/main.html ドキュメント] を参照。
			* メイン設定ファイル {{ic\|/usr/share/wireplumber/main.conf}} WirePlumber コアに必要なモジュールとコンポーネントをロードし、{{ic\|''config-dir''/main.lua.d/}} から [https://pipewire.pages.freedesktop.org/wireplumber/configuration/config_lua.html Lua 設定ファイル] をロードします。[https://pipewire.pages.freedesktop.org/wireplumber/configuration/config_lua.html] を参照してください。
			** [https://pipewire.pages.freedesktop.org/wireplumber/configuration/alsa.html ALSAオブジェクト] と [https://pipewire.pages.freedesktop.org/wireplumber/configuration/access.html "アクセス" オブジェクト] のドキュメントを参照してください。
			* [[Bluetooth]] 設定ファイル {{ic\|/usr/share/wireplumber/bluetooth.conf}} コアプロセスの Bluetooth 接続を処理する WirePlumber プロセスに適しています。これは{{ic\|''config-dir''/bluetooth.lua.d/}} から Lua ファイルをロードします。
			** [https://pipewire.pages.freedesktop.org/wireplumber/configuration/bluetooth.html Bluetooth オブジェクトのドキュメント] を参照してください。
			* ''policy'' 設定ファイルは {{ic\|/usr/share/wireplumber/policy.conf}} にあります。これは、WirePlumber がノードの移動や変更を判断するためのポリシー機能をカプセル化したものです。{{ic\|''config-dir''/policy.lua.d/}} から Lua ファイルを読み込みます。
			** ポリシー関連オブジェクトについては、[https://pipewire.pages.freedesktop.org/wireplumber/configuration/policy.html ドキュメント] を参照してください。

			{{ic\|lua.d/}} ディレクトリ内の Lua 設定ファイルは、{{ic\|''config-dir''/scripts/}} から Lua スクリプトも読み込みます。これらのスクリプトは Pipewire のロジック/機能の一部を実装しており、特定の状況下では変更する価値がある場合もあります。

		⚫	=== ルールマッチングのためのインターフェース名の取得 ===

	WirePlumber の Lua スクリプトでは、設定したい対象インターフェースの [https://docs.pipewire.org/page_objects_design.html PipeWire objects] で {{ic\|matches}} ルールを指定する必要があります。		WirePlumber の Lua スクリプトでは、設定したい対象インターフェースの [https://docs.pipewire.org/page_objects_design.html PipeWire objects] で {{ic\|matches}} ルールを指定する必要があります。

Kgx: /* 設定 */ 情報を更新

2023-06-23T20:07:18Z

設定: 情報を更新

← 古い版		2023年6月24日 (土) 05:07時点における版
112行目:		112行目:

	{{Note\|一般的な使用例としては、NVIDIA の HDMI オーディオ出力を無効にする場合など。}}		{{Note\|一般的な使用例としては、NVIDIA の HDMI オーディオ出力を無効にする場合など。}}

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

			{{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
			}}

			ここで、一致するデバイスに新しいカードプロファイルを使用するように Wireplumber を設定します。識別情報については、[[WirePlumber#ルールマッチングのためのインターフェース名の取得\|ルールマッチングのためのインターフェース名の取得]] を参照してください。次のような Lua スクリプトを作成して構成を適用します。

			{{hc\|/etc/wireplumber/main.lua.d/51-alsa-custom.lua (or ~/.config/wireplumber/main.lua.d/51-alsa-custom.lua)\|2=
			rule = {
			matches = {
			{
			{ "device.nick", "matches", "HDA Intel PCH" },
			},
			},
			apply_properties = {
			["api.alsa.use-acp"] = true,
			["api.acp.auto-profile"] = false,
			["api.acp.auto-port"] = false,
			["device.profile-set"] = "multiple.conf",
			["device.profile"] = "multiple",
			},
			}
			table.insert(alsa_monitor.rules,rule)
			}}

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

Kgx: ヒントとテクニックを翻訳して追加

2023-06-23T20:03:21Z

ヒントとテクニックを翻訳して追加

@@ 54行目: / 54行目: @@
 === デバイス/ノードのプロパティを変更する ===
-デバイスやノードのプロパティ（説明やニックネームなど）を変更するには、Lua スクリプトを作成し、{{ic|~/.config/wireplumber}} に適切なパスと名前で追加する必要があります。
+デバイスやノードのプロパティ(説明やニックネームなど)を変更するには、Lua スクリプトを作成し、{{ic|~/.config/wireplumber}} に適切なパスと名前で追加する必要があります。
 例えば ALSA ノードの説明を変更するには、 {{ic|~/.config/wireplumber/main.lua.d/51-alsa-rename.lua}} のようなファイルを作成して、以下のような内容を記述してください。
@@ 86行目: / 86行目: @@
 Lua スクリプトのファイル名と場所は、[https://pipewire.pages.freedesktop.org/wireplumber/configuration/config_lua.html#multi-path-merging WirePlumber's マルチパスマージ] で、デフォルトの設定ファイル
-（例:{{ic|/usr/share/wireplumber/main.lua.d/50-alsa-config.lua}}）デバイスをロードして有効にするファイル
+(例:{{ic|/usr/share/wireplumber/main.lua.d/50-alsa-config.lua}})デバイスをロードして有効にするファイル
-（例:{{ic|/usr/share/wireplumber/main.lua.d/90-enable-all.lua}}）の前に実行できるよう設計されています。
+(例:{{ic|/usr/share/wireplumber/main.lua.d/90-enable-all.lua}})の前に実行できるよう設計されています。
 デバイスやノードを選択するためのマッチングルールや、変更できるプロパティは [https://pipewire.pages.freedesktop.org/wireplumber/configuration/alsa.html ALSA 設定] と [https://pipewire.pages.freedesktop.org/wireplumber/configuration/bluetooth.html Bluetooth 設定] に記載されています。
@@ 112行目: / 112行目: @@
 {{Note|一般的な使用例としては、NVIDIA の HDMI オーディオ出力を無効にする場合など。}}
 == 参照 ==

Kgx: /* ルールマッチングのためのインターフェース名の取得 */ 情報を更新

2022-05-16T01:54:23Z

ルールマッチングのためのインターフェース名の取得: 情報を更新

← 古い版		2022年5月16日 (月) 10:54時点における版
22行目:		22行目:
	=== ルールマッチングのためのインターフェース名の取得 ===		=== ルールマッチングのためのインターフェース名の取得 ===

	Lua スクリプト~~を使用してデバイスやノードを~~設定~~する前に、~~対象~~となるデバ~~イス~~/ノードを指定するため~~の [https://docs.pipewire.org/page_objects_design.html PipeWire ~~オブジェクト~~] を~~知っておく~~必要があります。		WirePlumber の Lua スクリプトでは、設定したい対象インターフェースの [https://docs.pipewire.org/page_objects_design.html PipeWire objects] で {{ic\|matches}} ルールを指定する必要があります。

	コマンド {{ic\|$ pw-cli list-objects}} ~~または~~ {{ic\|$ pw-cli ls}} を使用~~すると、システムで利用可能な全てのオブジェクトを表示することができ~~ます。		システムで利用可能な全てのオブジェクトを表示するには、コマンド {{ic\|pw-cli list-objects}} と {{ic\|pw-cli dump}} を使用します。

			オブジェクト {{ic\|Node}} は PipeWire グラフ内のシンクまたはソースです。これらは ALSA の {{ic\|Device}} に対応します。
⚫	表示するオブジェクトの種類を絞り込むには、 {{ic\|<nowiki>[~~all\|Core\|Module\|~~Device\|Node~~\|Port\|Factory\|Client\|Link\|Session\|Endpoint\|EndpointStream\|<id>~~]</nowiki>}} コマン~~ドに続く {{ic\|list-objects}}~~ を一つ追加してください。

		⚫	表示するオブジェクトの種類を絞り込むには、 {{ic\|<nowiki>[Device\|Node]</nowiki>}} オプションを追加してください。例えば:
⚫	{{hc\|$ pw-cli list-objects Device\|output=~~...~~

		⚫	{{hc\|$ pw-cli list-objects Device\|output=
			...
	id 37, type PipeWire:Interface:Device/3		id 37, type PipeWire:Interface:Device/3
	object.serial = "264"		object.serial = "264"
38行目:		41行目:
	device.nick = "HD-Audio Generic"		device.nick = "HD-Audio Generic"
	media.class = "Audio/Device"		media.class = "Audio/Device"
	...}}		...
			}}

			オブジェクトタイプのフィルタリングは、{{ic\|pw-cli dump}} コマンドにも適用されます。

			もしエンドポイントの特定のクラス (例:"Audio/Sink") を探しているのであれば、 {{ic\|media.class}} プロパティを参照してください。

		⚫	ほとんどの場合、ALSA を設定するときに必要なプロパティは {{ic\|device.name}} か {{ic\|node.name}} のどちらかです。
	コマンド {{ic\|$ pw-cli dump}} でも、このタイプフィルタリングは適用されます。

			{{Tip\|{{ic\|pw-top}} コマンドは現在使用されている {{ic\|Node}} のリストを表示します。}}
⚫	ALSA を設定するときに必要な~~オブジェクト~~は {{ic\|device.name}} か {{ic\|node.name}} のどちらかです。

	=== デバイス/ノードのプロパティを変更する ===		=== デバイス/ノードのプロパティを変更する ===

WirePlumber - 版の履歴

Kgx: /* 設定 */ 同期

Kgx: /* 同じサウンドカード上の複数のシンクへの同時出力 */ 同期

Kgx: /* ヒントとテクニック */ 同期

Kgx: /* ルールマッチングのためのインターフェース名の取得 */ 情報を更新

AshMyzk: /* ログアウト後も Bluetooth を実行し続ける/ヘッドレス Bluetooth */ 訳を修正

Kgx: /* 設定 */ 設定の変更を翻訳して追加

Kgx: /* 設定 */ 設定ファイルのレイアウトを翻訳して追加

Kgx: /* 設定 */ 情報を更新

Kgx: ヒントとテクニックを翻訳して追加

Kgx: /* ルール マッチングのためのインターフェース名の取得 */ 情報を更新

Kgx: /* ルールマッチングのためのインターフェース名の取得 */ 情報を更新