Re: [PATCH BlueZ 01/13] media-api: Add playback control methods to MediaPlayer1

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Hi,

On Thu, Jan 10, 2013 at 3:24 PM, Luiz Augusto von Dentz
<luiz.dentz@xxxxxxxxx> wrote:
> From: Luiz Augusto von Dentz <luiz.von.dentz@xxxxxxxxx>
>
> This adds methods such as Play, Pause directly in MediaPlayer1, in
> addition to that Track is now turn into a property to take advantage of
> ObjectManager and document the interface as experimental.
> ---
>  doc/media-api.txt | 99 ++++++++++++++++++++++++++++++++-----------------------
>  1 file changed, 57 insertions(+), 42 deletions(-)
>
> diff --git a/doc/media-api.txt b/doc/media-api.txt
> index bb5ced0..16ed34b 100644
> --- a/doc/media-api.txt
> +++ b/doc/media-api.txt
> @@ -129,7 +129,7 @@ Media Control hierarchy
>  =======================
>
>  Service                org.bluez
> -Interface      org.bluez.MediaControl1
> +Interface      org.bluez.MediaControl1 [Deprecated]
>  Object path    [variable prefix]/{hci0,hci1,...}/dev_XX_XX_XX_XX_XX_XX
>
>  Methods                void Play()
> @@ -178,65 +178,47 @@ Properties
>  MediaPlayer1 hierarchy
>  ======================
>
> -Service                unique name (Target role)
> -Interface      org.bluez.MediaPlayer1
> -Object path    freely definable
> -
>  Service                org.bluez (Controller role)
> -Interface      org.bluez.MediaPlayer1
> +Interface      org.bluez.MediaPlayer1 [Experimental]
>  Object path    [variable prefix]/{hci0,hci1,...}/dev_XX_XX_XX_XX_XX_XX/playerX
>
> -Methods                dict GetTrack()
> -
> -                       Returns known metadata of the current track.
> -
> -                       See TrackChanged for possible values.
> -
> -               void Release()
> -
> -                       This method gets called when the service daemon
> -                       unregisters the player which can then perform
> -                       cleanup tasks. There is no need to unregister the
> -                       player, because when this method gets called it has
> -                       already been unregistered.
> +Methods                void Play()
>
> -Signals                TrackChanged(dict metadata)
> +                       Resume playback.
>
> -                       This signal indicates that current track has changed.
> -                       All available metadata for the new track shall be set
> -                       at once in the metadata argument. Metadata cannot be
> -                       updated in parts, otherwise it will be interpreted as
> -                       multiple track changes.
> +               void Pause()
>
> -                       Possible values:
> +                       Pause playback.
>
> -                               string Title:
> +               void Stop()
>
> -                                       Track title name
> +                       Stop playback.
>
> -                               string Artist:
> +               void Next()
>
> -                                       Track artist name
> +                       Next item.
>
> -                               string Album:
> +               void Previous()
>
> -                                       Track album name
> +                       Previous item.
>
> -                               string Genre:
> +               void VolumeUp()
>
> -                                       Track genre name
> +                       Adjust remote volume one step up
>
> -                               uint32 NumberOfTracks:
> +               void VolumeDown()
>
> -                                       Number of tracks in total
> +                       Adjust remote volume one step down
>
> -                               uint32 Number:
> +               void FastForward()
>
> -                                       Track number
> +                       Fast forward playback, this action is only stopped
> +                       when another method in this interface is called.
>
> -                               uint32 Duration:
> +               void Rewind()
>
> -                                       Track duration in milliseconds
> +                       Rewind playback, this action is only stopped
> +                       when another method in this interface is called.
>
>  Properties     string Equalizer [readwrite]
>
> @@ -258,8 +240,8 @@ Properties  string Equalizer [readwrite]
>                 string Status [readonly]
>
>                         Possible status: "playing", "stopped", "paused",
> -                                       "forward-seek", "reverse-seek" or
> -                                       "error"
> +                                       "forward-seek", "reverse-seek"
> +                                       or "error"
>
>                 uint32 Position [readonly]
>
> @@ -272,6 +254,39 @@ Properties string Equalizer [readwrite]
>                         possible to signal its end by setting position to the
>                         maximum uint32 value.
>
> +               dict Track [readonly]
> +
> +                       Track metadata.
> +
> +                       Possible values:
> +
> +                               string Title:
> +
> +                                       Track title name
> +
> +                               string Artist:
> +
> +                                       Track artist name
> +
> +                               string Album:
> +
> +                                       Track album name
> +
> +                               string Genre:
> +
> +                                       Track genre name
> +
> +                               uint32 NumberOfTracks:
> +
> +                                       Number of tracks in total
> +
> +                               uint32 Number:
> +
> +                                       Track number
> +
> +                               uint32 Duration:
> +
> +                                       Track duration in milliseconds
>
>  MediaEndpoint1 hierarchy
>  ========================
> --
> 1.8.0.1
>

Please ignore this series.

--
Luiz Augusto von Dentz
--
To unsubscribe from this list: send the line "unsubscribe linux-bluetooth" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html


[Index of Archives]     [Bluez Devel]     [Linux Wireless Networking]     [Linux Wireless Personal Area Networking]     [Linux ATH6KL]     [Linux USB Devel]     [Linux Media Drivers]     [Linux Audio Users]     [Linux Kernel]     [Linux SCSI]     [Big List of Linux Books]

  Powered by Linux