savePlayQueue
Categories:
Opensubsonic:
http://your-server/rest/savePlayQueue Since 1.12.0
Saves the state of the play queue for this user. This includes the tracks in the play queue, the currently playing track, and the position within this track. Typically used to allow a user to move between different clients/apps while retaining the same play queue (for instance when listening to an audio book).
Parameters
| Parameter | Req. | OpenS. | Default | Comment |
|---|---|---|---|---|
id | No | ID of a song in the play queue. Use one id parameter for each song in the play queue. | ||
current | Yes (subsonic) / No (OpenSubsonic)* | The ID of the current playing song. | ||
position | No | The position in milliseconds within the currently playing song. |
Errata/OpenSubsonic
* In the original Subsonic, despite the claims that current is optional, it was required and must be in the list of id.
Note: For OpenSubsonic servers, id is optional. Send a call without any parameters to clear the currently saved queue.
For OpenSubsonic servers only, current is required unless id is empty.
If position is empty, servers should treat the position as 0.
Example
http://your-server/rest/savePlayQueue.view?id=123¤t=123&u=demo&p=demo&v=1.13.0&c=AwesomeClientName&f=jsonResult
An empty subsonic-response element on success.
{
"subsonic-response": {
"status": "ok",
"version": "1.16.1",
"type": "AwesomeServerName",
"serverVersion": "0.1.3 (tag)",
"openSubsonic": true
}
}{
"subsonic-response": {
"status": "ok",
"version": "1.16.1"
}
}