XiiaLive Open APIs for Android

XiiaLive provides a few ways to control playback and also receive playback and metadata information. 

Control Service Intents

The control service intents are sent using startService. If the user has installed XiiaLive and XiiaLive Pro the intents will be simply received by XiiaLive Pro only.



Intent App version Description
com.vblast.xiialive.intent.action.
PLAYBACK_RESUME
FREE/PRO Resumes last played. If already playing nothing happens.
com.vblast.xiialive.intent.action.
PLAYBACK_PAUSE
FREE/PRO Pauses playback. If already paused nothing happens.
com.vblast.xiialive.intent.action.
PLAYBACK_TOGGLE
FREE/PRO Toggles playback. If playing it will stop playback. If not playing it will resume playback.
com.vblast.xiialive.intent.action.
PLAYBACK_STOP
FREE/PRO Stops playback. If not playing nothing happens.
com.vblast.xiialive.intent.action.
PLAYLIST_PREV
PRO Starts playing the previous playlist item.
com.vblast.xiialive.intent.action.
PLAYLIST_NEXT
PRO Starts playing the next playlist item.
com.vblast.xiialive.intent.action.
FAVORITE_PREV
PRO Starts playing the next favorite station from the users favorites list.
com.vblast.xiialive.intent.action.
FAVORITE_NEXT
PRO Starts playing the prev favorite station from the users favorites lists.

Metadata Broadcast Intents

We have tried to mimic as much as we could the standard Android music player and various other popular music players intents and extras with playback and metadata information to make it hopefully easy to use.



Intent Description
com.vblast.xiialive.metachanged
Broadcast sent when metadata has changed.
com.vblast.xiialive.playstatechanged
Playback status changed.
com.vblast.xiialive.playbackcomplete
Playback has ended.

Note, if you want to know from what app, XiiaLive or XiiaLive Pro, the broadcast intent came from check the category field if it is  com.vblast.xiialive.category.FREE or com.vblast.xiialive.category.PRO.

Metadata Broadcast Extras

The follow are sent with the metadata broadcast intents.

Extra Type Description
active
boolean An active state means the media player manager is still actively managing playlist, connection issues and potential errors for retries.
preparing boolean
Initial playback request is in preparing state. Preparing state means playlist is being setup and media information is being probed.

playing boolean
If actual audio is playing. During connecting, buffering or pause state playing is false.
uri
string Currently playing URI.
mime string Currently playing MIME.
track string Track name of the song.
artist string Song artist.
album string Media album or station name.
genre string Media genre
bitrate int Media bitrate.
channels int Media channel count. 1=mono, 2=stereo
samplerate int Media sample rate.






This article was helpful for 6 people. Czy artykuł był pomocny?