Struct PlayerProxy

pub struct PlayerProxy { /* private fields */ }

Implementations

impl PlayerProxy

pub fn new(channel: AsyncChannel) -> Self

Create a new Proxy for fuchsia.media.sounds/Player.

pub fn take_event_stream(&self) -> PlayerEventStream

Get a Stream of events from the remote end of the protocol.

Panics

Panics if the event stream was already taken.

pub fn add_sound_from_file( &self, id: u32, file: ClientEnd<FileMarker>, ) -> QueryResponseFut<PlayerAddSoundFromFileResult, DefaultFuchsiaResourceDialect>

Adds a sound to the collection maintained for the client, reading the sound from a file. If id identifies an existing sound in the collection, the service will close the connection. Returns the duration of the sound or an error status returned from an I/O operation.

Currently, only PCM WAV files and Ogg/Opus files are supported.

pub fn add_sound_buffer( &self, id: u32, buffer: Buffer, stream_type: &AudioStreamType, ) -> Result<(), Error>

Adds a sound, in the form of a buffer containing raw PCM samples, to the collection maintained for the client. The service will retain a handle to the buffer’s VMO until the sound is removed and is no longer playing or until the connection is closed.

If id identifies an existing sound in the collection, the service will close the connection.

pub fn remove_sound(&self, id: u32) -> Result<(), Error>

Removes a sound from the collection maintained for the client. A sound can be removed even if a PlaySound method is pending for that sound.

If id doesn’t identify an existing sound in the collection, the service will do nothing. This is tolerated so that clients don’t have to wait for the response from AddSoundFromFile before playing and removing the sound.

Removing an unneeded sound frees the resources associated with that sound, principally the VMO required to store the uncompressed sound.

pub fn play_sound( &self, id: u32, usage: AudioRenderUsage, ) -> QueryResponseFut<PlayerPlaySoundResult, DefaultFuchsiaResourceDialect>

Plays the existing sound identified by id using a renderer with usage usage. The sound is played as soon as possible. The reply is sent when the sound is finished playing. If id doesn’t identify an existing sound in the collection, the method returns PlaySoundError.NO_SUCH_SOUND. The most recent PlaySound call for a given valid id can be stopped using StopPlayingSound, in which case, this method returns PlaySoundError.STOPPED.

pub fn stop_playing_sound(&self, id: u32) -> Result<(), Error>

Stops playback of the sound identified by id invoked by the the most recent call to PlaySound for that sound. If id doesn’t identify an existing sound in the collection or if the sound is not currently playing, this method does nothing. If more than one PlaySound method is currently pending for that sound, only the most recent is stopped.

Trait Implementations

impl Clone for PlayerProxy

fn clone(&self) -> PlayerProxy

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PlayerProxy

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

Formats the value using the given formatter.

impl PlayerProxyInterface for PlayerProxy

type AddSoundFromFileResponseFut = QueryResponseFut<Result<i64, i32>>

type PlaySoundResponseFut = QueryResponseFut<Result<(), PlaySoundError>>

fn add_sound_from_file( &self, id: u32, file: ClientEnd<FileMarker>, ) -> Self::AddSoundFromFileResponseFut

fn add_sound_buffer( &self, id: u32, buffer: Buffer, stream_type: &AudioStreamType, ) -> Result<(), Error>

fn remove_sound(&self, id: u32) -> Result<(), Error>

fn play_sound( &self, id: u32, usage: AudioRenderUsage, ) -> Self::PlaySoundResponseFut

fn stop_playing_sound(&self, id: u32) -> Result<(), Error>

impl Proxy for PlayerProxy

type Protocol = PlayerMarker

The protocol which this Proxy controls.

fn from_channel(inner: AsyncChannel) -> Self

Create a proxy over the given channel.

fn into_channel(self) -> Result<AsyncChannel, Self>

Attempt to convert the proxy back into a channel.

fn as_channel(&self) -> &AsyncChannel

Get a reference to the proxy’s underlying channel.

fn into_client_end(self) -> Result<ClientEnd<Self::Protocol>, Self>

Attempt to convert the proxy back into a client end.

fn is_closed(&self) -> bool

Returns true if the proxy has received the PEER_CLOSED signal.

fn on_closed(&self) -> OnSignals<'_, Unowned<'_, Handle>>

Returns a future that completes when the proxy receives the PEER_CLOSED signal.