Marantz SR7015 HEOS CLI ProtocolSpecification Version - Page 41

Retrieve Album Metadata, 4.18 Get Service Options for now playing screen - OBSOLETE

Page 41 highlights

4.4.17 Retrieve Album Metadata Rhapsody and Napster services doesn't provide album art url while browsing for tracks. Controllers can use this command to retrieve album art url while browsing for tracks. Retrieve image url associated with a given album id. This command facilitates controllers to retrieve and update their UI with cover art, if image_url in browse/search/get_queue/get_now_playing_media command response is blank. Command: heos://browse/retrieve_metadata?sid=source_id&cid=album_id Attribute sid cid Description Comment Source id returned by 'get_music_sources' command; select HEOS source to get HEOS playlists. Currently supported media sources are Rhapsody/Napster Container id returned by 'browse' command or 'get_now_playing_media' command Rhapsody/Napster album ids Note: Supported music service is Rhapsody and Napster Response: { "heos": { "command": "browse/retrieve_metadata", "result": "success", "message": "sid=2&cid=album_id&returned=items_in_current_response&count=total_items_available" }, "payload": [ { "album_id": "album_id", "images": [ { "image_url": "URL to image file", "width": current image width }, . . . { "image_url": "URL to image file", "width": current image width } ] } ] } Example: heos://browse/retrieve_metadata?sid=2&cid=Alb.184664171 4.4.18 Get Service Options for now playing screen - OBSOLETE Obsolete - Now get_now_playing_media command will include supported option for currently playing media. Command: heos://browse/get_service_options?sid=source_id Attribute sid id (options) Description Enumeration Source id returned by 'get_music_sources' N/A command Options available on now playing screen Following options are currently supported for 'Get Service options for now playing

  • 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
  • 46
  • 47

4.4.17 Retrieve Album Metadata
Rhapsody and Napster services doesn't provide album art url while browsing for tracks. Controllers can use this command to retrieve
album art url while browsing for tracks.
Retrieve image url associated with a given album id. This command facilitates controllers to retrieve and update their UI with cover art, if
image_url in browse/search/get_queue/get_now_playing_media command response is blank.
Command:
heos://browse/retrieve_metadata?sid=source_id&cid=album_id
Attribute
Description
Comment
sid
Source id returned by 'get_music_sources'
command; select HEOS source to get
HEOS playlists.
Currently supported media sources are
Rhapsody/Napster
cid
Container id returned by 'browse'
command or 'get_now_playing_media'
command
Rhapsody/Napster album ids
Note: Supported music service is Rhapsody and Napster
Response:
{
"heos": {
"command": "browse/retrieve_metadata",
"result": "success",
"message": "sid=2&cid=album_id&returned=items_in_current_response&count=total_items_available"
},
"payload": [
{
"album_id": "album_id",
"images": [
{
"image_url": "URL to image file",
"width": current image width
},
.
.
.
{
"image_url": "
",
URL to image file
"width": current image width
}
]
}
]
}
Example:
heos://browse/retrieve_metadata?sid=2&cid=Alb.184664171
4.4.18 Get Service Options for now playing screen - OBSOLETE
Obsolete - Now get_now_playing_media command will include supported option for currently playing media.
Command: heos://browse/get_service_options?sid=source_id
Attribute
Description
Enumeration
sid
Source id returned by 'get_music_sources'
command
N/A
id (options)
Options available on now playing screen
Following options are currently supported
for 'Get Service options for now playing