Version 2.2
- Copyright © 2006-2012 the VideoLAN team (Mirsal Ennaime, Rafaël Carré, Jean-Paul Saman)
- Copyright © 2005-2008 Milosz Derezynski
- Copyright © 2008 Nick Welch
- Copyright © 2010-2012 Alex Merry
This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
Interfaces
- About (Permalink)
- Changes (Permalink)
- From 2.1 to 2.2:
-
- Added the optional Fullscreen and CanSetFullscreen properties to the org.mpris.MediaPlayer2 interface.
- The path /org/mpris/MediaPlayer2/TrackList/NoTrack now represents "no track" where required in the org.mpris.MediaPlayer2.TrackList interface (since empty paths are not allowed by D-Bus).
- The suggested unique instance identifier no longer violates the D-Bus specification by begining with a digit.
- From 2.0 to 2.1:
-
- Added the optional org.mpris.MediaPlayer2.Playlists interface.
- Corrections (Permalink)
- 2012-08-07: Clarified behaviour of the Play method of the Player interface when paused.
- Bus Name Policy (Permalink)
- org.mpris.MediaPlayer2.audacious
- org.mpris.MediaPlayer2.vlc
- org.mpris.MediaPlayer2.bmp
- org.mpris.MediaPlayer2.xmms2
- org.mpris.MediaPlayer2.vlc.instance7389
- Entry point (Permalink)
- org.mpris.MediaPlayer2
- org.mpris.MediaPlayer2.Player
- The PropertiesChanged signal (Permalink)
- Interfaces (Permalink)
The Media Player Remote Interfacing Specification is a standard D-Bus interface which aims to provide a common programmatic API for controlling media players.
It provides a mechanism for discovery, querying and basic playback control of compliant media players, as well as a tracklist interface which is used to add context to the active media item.
Each media player must request a unique bus name which begins with org.mpris.MediaPlayer2. For example:
This allows clients to list available media players (either already running or which can be started via D-Bus activation)
In the case where the media player allows multiple instances running simultaneously, each additional instance should request a unique bus name, adding a dot and a unique identifier to its usual bus name, such as one based on a UNIX process id. For example, this could be:
Note: According to the D-Bus specification, the unique identifier "must only contain the ASCII characters '[A-Z][a-z][0-9]_-'" and "must not begin with a digit".
The media player must expose the /org/mpris/MediaPlayer2 object path, which must implement the following interfaces:
The /org/mpris/MediaPlayer2 object may implement the org.mpris.MediaPlayer2.TrackList interface.
The /org/mpris/MediaPlayer2 object may implement the org.mpris.MediaPlayer2.Playlists interface.
The MPRIS
uses the