Marantz NR1509 HEOS CLI ProtocolSpecification Version 1.11 02072018 - Page 5

Issues & Solutions

Page 5 highlights

2.1.2.2 Issues & Solutions Changes made to HEOS user account, through HEOS app will not reflect through CLI until the controller is restarted. Ex: Adding or removing music services to HEOS user account, through HEOS app will not reflect in get_music_sources command response until the controller is restarted. Solution: Controller needs to re sign-in to HEOS account to reflect changes made through HEOS app, with out restarting the controller. So, in addition to performing HEOS account sign-in as part of driver initialization process, it is highly recommended to provide sign-out and sign-in option through end users UI screen. End user need to re-signIn when he adds/removes music service through HEOS app. 2.1.3 Miscellaneous Controllers can add custom argument SEQUENCE= in browse commands to associate command and response. This is possible because the 'message' field in the response packet includes all the arguments sent in the command. Please let us know if you need additional custom argument other than 'SEQUENCE'. This is to avoid accidentally using HEOS command arguments for special purpose. Maximum number of simultaneous socket connections supported by HEOS speaker is 32. Service specific transport control options are as follows: Services Amazon Music Deezer iHeart Radio Napster Pandora Rhapsody SoundCloud SiriusXM Tidal Tunein Juke Type station song station song station song station song station song station song station song station song station song station song station song Supported Transport Controls by CLI Play, Pause, Stop, PlayNext, PlayPrevious Play, Pause, Stop, PlayNext, PlayPrevious Play, Pause, Stop, PlayNext Play, Pause, Stop, PlayNext, PlayPrevious Play, Stop Play, Pause, Stop, PlayNext, PlayPrevious Play, Pause, Stop, PlayNext Play, Pause, Stop, PlayNext, PlayPrevious Play, Pause, Stop, PlayNext NA Play, Pause, Stop, PlayNext Play, Pause, Stop, PlayNext, PlayPrevious NA Play, Pause, Stop, PlayNext, PlayPrevious Play, Stop NA NA Play, Pause, Stop, PlayNext, PlayPrevious Play, Stop Play, Pause, Stop, PlayNext, PlayPrevious Play, Pause, Stop, PlayNext, PlayPrevious Play, Pause, Stop, PlayNext, PlayPrevious Supported Transport Controls in HEOS App (No significance. Only for Reference) Play, Pause, PlayNext, PlayPrevious Play, Pause, PlayNext, PlayPrevious Play, Pause, PlayNext Play, Pause, PlayNext, PlayPrevious Play, Stop, Scan Play, Pause, PlayNext, PlayPrevious Play, Pause, PlayNext Play, Pause, PlayNext, PlayPrevious Play, Pause, PlayNext NA Play, Pause, PlayNext Play, Pause, PlayNext, PlayPrevious NA Play, Pause, PlayNext, PlayPrevious Play, Stop NA NA Play, Pause, PlayNext, PlayPrevious Play, Stop Play, Pause, PlayNext, PlayPrevious Play, Pause, PlayNext, PlayPrevious Play, Pause, Stop, PlayNext, PlayPrevious

  • 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

2.1.2.2 Issues & Solutions
Changes made to HEOS user account, through HEOS app will not reflect through CLI until the controller is restarted. Ex: Adding or
removing music services to HEOS user account, through HEOS app will not reflect in get_music_sources command response until the
controller is restarted.
Solution: Controller needs to re sign-in to HEOS account to reflect changes made through HEOS app, with out restarting
the controller. So, in addition to performing HEOS account sign-in as part of driver initialization process, it is highly
recommended to provide sign-out and sign-in option through end users UI screen. End user need to re-signIn when he
adds/removes music service through HEOS app.
2.1.3 Miscellaneous
Controllers can add custom argument SEQUENCE=<number> in browse commands to associate command and response. This is
possible because the 'message' field in the response packet includes all the arguments sent in the command. Please let us know if
you need additional custom argument other than 'SEQUENCE'. This is to avoid accidentally using HEOS command arguments for
special purpose.
Maximum number of simultaneous socket connections supported by HEOS speaker is 32.
Service specific transport control options are as follows:
Services
Type
Supported Transport Controls
by CLI
Supported Transport Controls in
HEOS App (No significance.
Only for Reference)
Amazon Music
station
Play, Pause, Stop, PlayNext,
PlayPrevious
Play, Pause, PlayNext,
PlayPrevious
song
Play, Pause, Stop, PlayNext,
PlayPrevious
Play, Pause, PlayNext,
PlayPrevious
Deezer
station
Play, Pause, Stop, PlayNext
Play, Pause, PlayNext
song
Play, Pause, Stop, PlayNext,
PlayPrevious
Play, Pause, PlayNext,
PlayPrevious
iHeart Radio
station
Play, Stop
Play, Stop, Scan
song
Play, Pause, Stop, PlayNext,
PlayPrevious
Play, Pause, PlayNext,
PlayPrevious
Napster
station
Play, Pause, Stop, PlayNext
Play, Pause, PlayNext
song
Play, Pause, Stop, PlayNext,
PlayPrevious
Play, Pause, PlayNext,
PlayPrevious
Pandora
station
Play, Pause, Stop, PlayNext
Play, Pause, PlayNext
song
NA
NA
Rhapsody
station
Play, Pause, Stop, PlayNext
Play, Pause, PlayNext
song
Play, Pause, Stop, PlayNext,
PlayPrevious
Play, Pause, PlayNext,
PlayPrevious
SoundCloud
station
NA
NA
song
Play, Pause, Stop, PlayNext,
PlayPrevious
Play, Pause, PlayNext,
PlayPrevious
SiriusXM
station
Play, Stop
Play, Stop
song
NA
NA
Tidal
station
NA
NA
song
Play, Pause, Stop, PlayNext,
PlayPrevious
Play, Pause, PlayNext,
PlayPrevious
Tunein
station
Play, Stop
Play, Stop
song
Play, Pause, Stop, PlayNext,
PlayPrevious
Play, Pause, PlayNext,
PlayPrevious
Juke
station
Play, Pause, Stop, PlayNext,
PlayPrevious
Play, Pause, PlayNext,
PlayPrevious
song
Play, Pause, Stop, PlayNext,
PlayPrevious
Play, Pause, Stop, PlayNext,
PlayPrevious