Marantz NR1609 HEOS CLI ProtocolSpecification Version 1.11 02072018 - Page 37

Get HEOS Playlists, 4.14 Rename HEOS Playlist, 4.15 Delete HEOS Playlist

Page 37 highlights

aid Add criteria id as defined by enumerations -> 1 - play now 2 - play next 3 - add to end 4 - replace and play pid Player id returned by 'get_players' or 'get_groups' command N/A Note: The mid for this command must be a 'track' media type. Response: Note: this command will cause a Now Playing Change Event to occur if a new song is played. { "heos": { "command": " browse/add_to_queue", "result": "success", "message": "pid='player_id'&sid='source_id'&cid='container_id'&mid='media_id'&aid='add_criteria'" } } Example: heos://browse/add_to_queue?pid=1&sid=8&cid=Artists/All&mid=9&aid=1 Supported Sources: Local Media Servers, Playlists, History, Rhapsody Tracks, Deezer Tracks, iHeartRadio Tracks, Napster, Tidal, SoundCloud, Amazon Music, Juke 4.4.13 Get HEOS Playlists Refer to Browse Sources and Browse Source Containers 4.4.14 Rename HEOS Playlist Command: heos://browse/rename_playlist?sid=source_id&cid=contaiiner_id&name=playlist_name Attribute Description Enumeration sid Source id returned by 'get_music_sources' command; select HEOS source to get HEOS playlists. N/A cid Container id returned in 'Get HEOS Playlists' command N/A name String for new playlist name limited to 128 unicode characters N/A Response: { "heos": { } } "command": "browse/rename_playlist ", "result": "success", "message": "sid='source_id'&cid='contaiiner_id'&name='playlist_name'" Example: heos://browse/rename_playlist?sid=11&cid=234&name=new name 4.4.15 Delete HEOS Playlist Command: heos://browse/delete_playlist?sid=source_id&cid=contaiiner_id Attribute Description Enumeration sid Source id returned by 'get_music_sources' command; select HEOS source to get HEOS playlists. N/A cid Container id returned in 'Get HEOS Playlists' command N/A Response: Note: The HEOS History has two containers: one for songs and another for stations. The following response example is for the songs container. The station container returns the list of stations. { "heos": { "command": "browse/delete_playlist ", "result": "success",

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45

aid
Add criteria id as defined by enumerations ->
1 – play now
2 – play next
3 – add to end
4 – replace and play
pid
Player id returned by 'get_players' or 'get_groups' command
N/A
Note: The mid for this command must be a 'track' media type.
Response:
: this command will cause a Now Playing Change Event to occur if a new song is played.
Note
{
"heos": {
"command": " browse/add_to_queue",
"result": "success",
"message": "pid='player_id'&sid='source_id'&cid='container_id'&mid='media_id'&aid='add_criteria'"
}
}
Example: heos://browse/add_to_queue?pid=1&sid=8&cid=Artists/All&mid=9&aid=1
Supported Sources: Local Media Servers, Playlists, History, Rhapsody Tracks, Deezer Tracks, iHeartRadio Tracks,
Napster, Tidal, SoundCloud, Amazon Music, Juke
4.4.13 Get HEOS Playlists
Refer to
Browse Sources and Browse Source Containers
4.4.14 Rename HEOS Playlist
Command: heos://browse/rename_playlist?sid=source_id&cid=contaiiner_id&name=playlist_name
Attribute
Description
Enumeration
sid
Source id returned by 'get_music_sources' command; select HEOS source to get HEOS playlists.
N/A
cid
Container id returned in 'Get HEOS Playlists' command
N/A
name
String for new playlist name limited to 128 unicode characters
N/A
Response:
{
"heos": {
"command": "browse/rename_playlist ",
"result": "success",
"message": "sid='source_id'&cid='contaiiner_id'&name='playlist_name'"
}
}
Example: heos://browse/rename_playlist?sid=11&cid=234&name=new name
4.4.15 Delete HEOS Playlist
Command: heos://browse/delete_playlist?sid=source_id&cid=contaiiner_id
Attribute
Description
Enumeration
sid
Source id returned by 'get_music_sources' command; select HEOS source to get HEOS playlists.
N/A
cid
Container id returned in 'Get HEOS Playlists' command
N/A
Response:
The HEOS History has two containers: one for songs and another for stations. The following response example is for the songs
Note:
container. The station container returns the list of stations.
{
"heos": {
"command": "browse/delete_playlist ",
"result": "success",