Bugzilla – Bug 15657
CLI enhancement: getexternalvolumeinfo notification
Last modified: 2013-05-02 13:26:50 UTC
This is a documentation enhancement and should be included in the SBS CLI documentation. It's not about server behavior but plugin behavior used by a number of plugins (IRBlaster, DenonSerial, DenonAVP/AVR Control) and currently supported by iPeng, probably some other clients soon. Notification syntax: <playerid> getexternalvolumeinfo <taggedParameters> This notification notifies a client that a plugin supports volume change capability for a player. This capability will override (from a user point of view) the "digitalVolumeControl" flag that indicates whether a player's output is fixed to a certain volume (typically 100%). This will be used by pluginjs providing external volume control, e.g. for an amplifier (IRBlaster being an example). In this scenario, the volume output of the player is typically fixed but there is still a volume control capability and the plugin control the amp's volume instead. The purpose of this notification is to let a client know that there is a volume control capability associated to a player. Use: getexternalvolumeinfo Sending a "getexternalvolumeinfo" command triggers all plugins supporting the feature to return a notification about their capabilities for each player for which they provide these capabilities. The command may be sent to a specific player but typically a plugin will ignore this and respond to any getexternalvolumeinfo command for each player. Returned tagged parameters: Tag Description relative A boolean value stating that a plugin is able to provide relative volume change capability for this player as in "mixer volume +5" precise A boolean value stating that a plugin is able to provide precise volume change capability for this player as in "mixer volume 75" plugin is an optional string naming the plugin providing the capability Example: Request: "getexternalvolumeinfo<LF>" Response 1: "a5:41:d2:cd:cd:05 getexternalvolumeinfo relative:1 plugin:IRBlaster" Response 2: "a5:41:d2:cd:cd:05 getexternalvolumeinfo precise:1 plugin:DenonSerial"
I fixed the default assignee for these bugs since Dylan is no longer with us.
Unassigned bugs cannot have a priority.
Jörg - is this a feature built in to LMS or some 3rd party plugin? I can't find any code dealing with this.
No, there is no server code, that's why I called it a documentation enhancement. The protocol described is used by plugins to communicate to a client (controller) that they do change the default volume control behavior of the server so it doesn't apply to the server itself. A number of plugins use it, e.g. IRBlaster, some of the Denon plugins and at least one other one but I forgot which it was. At least iPeng and SqueezeCommander support it on the controller side, probably some other Apps, too, at least I have answered questions of other App developers about it.
Committed to 7.8.
Am I correct to assume that this in the CLI doc now (sorry, don't use the git version, yet)? Cool, Thanks!
(In reply to comment #6) > Am I correct to assume that this in the CLI doc now (sorry, don't use the > git version, yet)? Yes, in the Notifications section of 7.8