XiiaLive Open APIs for Android
XiiaLive provides a few ways to control playback and also receive playback and metadata information.
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.
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. |
Сервис поддержки клиентов работает на платформе UserEcho