MPRISのソースを表示

[[Category:Multimedia]]
[[en:MPRIS]]
[https://specifications.freedesktop.org/mpris-spec/latest/ MPRIS] (Media Player Remote Interfacing Specification) はメディアプレイヤーを制御するための共通のプログラマティック API を提供することを目的とした標準 [[D-Bus]] インターフェイスです。

準拠するメディアプレイヤーの発見、問い合わせ、基本的な再生制御のためのメカニズムや、アクティブなメディアアイテムにコンテンキストを追加するために使用するトラックリストインターフェイスを提供します。

== サポートしているクライアント ==

* [[Chromium]]
* [[Firefox]]
* [[wikipedia:Dragon_Player|Dragon Player]]
* [[mpv#mpv-mpris]]
* [[Music Player Daemon/Tips and tricks#MPRIS support]]
* {{AUR|rage}}
* [[Spotify#MPRIS]]
* {{AUR|ncspot}}
* [[Telegram]]
* [[VLC]]
* {{Pkg|celluloid}}

== コントロールユーティリティ ==

{{Tip|Create a [[キーバインド]] for common control commands and multimedia keys such as {{ic|XF86AudioPlay}}, {{ic|XF86AudioStop}}, {{ic|XF86AudioPrev}} and {{ic|XF86AudioNext}}.}}

=== Playerctl ===

The {{Pkg|playerctl}} utility provides a command line tool to send commands to MPRIS clients. The most common commands are {{ic|play-pause}}, {{ic|next}} and {{ic|previous}}:

 $ playerctl play-pause
 $ playerctl next
 $ playerctl previous

''playerctl'' will send the command to the first player it finds. To select a player manually, use the {{ic|--player}} option, e.g. {{ic|1=--player=vlc}}.

=== mpris-player-control ===

The [https://gitlab.com/axdsop/nix-dotfiles/tree/master/Configs/polybar/scripts/mpris_player mpris_player_control] is a shell script which integrates {{ic|dbus-send}} and {{ic|pactl}} to control MPRIS clients. It supports the Play, Pause, PlayPause and Stop actions and sink volume control (mute/unmute/up/down) for [[Spotify]].

Run {{ic|mpris_player_control -h}} to show basic script usage.

=== D-Bus ===

An alternative to the above is to manually use [[D-Bus]], which should be available by default as it is a dependency of [[systemd]].

For example, the following commands can be used to control [[Spotify]]:

 $ dbus-send --print-reply --dest=org.mpris.MediaPlayer2.spotify /org/mpris/MediaPlayer2 org.mpris.MediaPlayer2.Player.PlayPause
 $ dbus-send --print-reply --dest=org.mpris.MediaPlayer2.spotify /org/mpris/MediaPlayer2 org.mpris.MediaPlayer2.Player.Next
 $ dbus-send --print-reply --dest=org.mpris.MediaPlayer2.spotify /org/mpris/MediaPlayer2 org.mpris.MediaPlayer2.Player.Previous
 $ dbus-send --print-reply --dest=org.mpris.MediaPlayer2.spotify /org/mpris/MediaPlayer2 org.mpris.MediaPlayer2.Player.Stop

== Bluetooth ==

Media control from bluetooth headsets and similar devices may be forwarded to MPRIS.

{{Note|Some headphones such as Sony WH-1000XM3 provide an AVRCP interface. For these types ''mpris-proxy'' is not required. Just make sure you have [[キーバインド]] set up for media keys.}}

[[インストール]] the {{Pkg|bluez-utils}} package and run {{ic|mpris-proxy}}. In order to start up ''mpris-proxy'' in the background and/or when your system starts, you may create a [[systemd/ユーザー]] service:

{{hc|~/.config/systemd/user/mpris-proxy.service|<nowiki>
[Unit]
Description=Forward bluetooth media controls to MPRIS

[Service]
Type=simple
ExecStart=/usr/bin/mpris-proxy

[Install]
WantedBy=default.target
</nowiki>}}

Then [[起動]]/[[有効化]] the service with the {{ic|--user}} flag.