Struct mpris_server::LocalServer

pub struct LocalServer<T>where
    T: LocalPlayerInterface + 'static,{ /* private fields */ }

Local version of Server that doesn’t require T to be Send and Sync.

If your type is already Send and Sync, consider using Server instead because LocalServer has an overhead of sending messages across threads.

For more information, see Server documentations.

Implementations

impl<T> LocalServer<T>where T: LocalPlayerInterface + 'static,

pub fn new(bus_name_suffix: &str, imp: T) -> Self

Creates a new LocalServer with the given bus name suffix and implementation, imp, which must implement LocalRootInterface and LocalPlayerInterface.

To start the connection, LocalServer::init_and_run must be called.

The resulting bus name will be org.mpris.MediaPlayer2.<bus_name_suffix>, where <bus_name_suffix>must be a unique identifier, such as one based on a UNIX process id. For example, this could be:

• org.mpris.MediaPlayer2.vlc.instance7389

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”.

pub fn init_and_run(&self) -> LocalServerRunTask

Returns a task that initializes the connection and run the server until the server and the task is dropped.

The task must be awaited as soon as possible after creating the server.

The returned task is no-op if the server has been ran before.

pub fn imp(&self) -> &T

Returns a reference to the underlying implementation.

pub async fn connection(&self) -> Result<&Connection>

Returns a reference to the inner Connection.

If you needed to call this, consider filing an issue.

pub async fn emit(&self, signal: Signal) -> Result<()>

Emits the given signal.

pub async fn properties_changed( &self, properties: impl Into<BitFlags<Property>> ) -> Result<()>

Emits the PropertiesChanged signal for the given properties.

This categorizes the property in the changed or invalidated properties as defined by the spec.

LocalServer::track_list_properties_changed or LocalServer::playlists_properties_changed are used to emit PropertiesChanged for the TrackList or Playlists interfaces respectively.

impl<T> LocalServer<T>where T: LocalTrackListInterface + 'static,

pub fn new_with_track_list(bus_name_suffix: &str, imp: T) -> Self

Creates a new LocalServer with the given bus name suffix and implementation, which must implement TrackListInterface in addition to LocalRootInterface and LocalPlayerInterface.

See also LocalServer::new.

pub async fn track_list_emit(&self, signal: TrackListSignal) -> Result<()>

Emits the given signal on the TrackList interface.

pub async fn track_list_properties_changed( &self, properties: impl Into<BitFlags<TrackListProperty>> ) -> Result<()>

Emits the PropertiesChanged signal for the given properties.

This categorizes the property in the changed or invalidated properties as defined by the spec.

impl<T> LocalServer<T>where T: LocalPlaylistsInterface + 'static,

pub fn new_with_playlists(bus_name_suffix: &str, imp: T) -> Self

Creates a new LocalServer with the given bus name suffix and implementation, which must implement LocalPlaylistsInterface in addition to LocalRootInterface and LocalPlayerInterface.

See also LocalServer::new.

pub async fn playlists_emit(&self, signal: PlaylistsSignal) -> Result<()>

Emits the given signal on the Playlists interface.

pub async fn playlists_properties_changed( &self, properties: impl Into<BitFlags<PlaylistsProperty>> ) -> Result<()>

Emits the PropertiesChanged signal for the given properties.

This categorizes the property in the changed or invalidated properties as defined by the spec.

impl<T> LocalServer<T>where T: LocalTrackListInterface + LocalPlaylistsInterface + 'static,

pub fn new_with_all(bus_name_suffix: &str, imp: T) -> Self

Creates a new LocalServer with the given bus name suffix and implementation, which must implement LocalTrackListInterface and LocalPlaylistsInterface in addition to LocalRootInterface and LocalPlayerInterface.

See also LocalServer::new.

Trait Implementations

impl<T> Debug for LocalServer<T>where T: LocalPlayerInterface + 'static,

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.