Difference between revisions of "Developer:Davaar:VolumeService"
(→Fade) |
|||
| Line 3: | Line 3: | ||
==Volume== | ==Volume== | ||
| − | Volume can be set to an absolute value or incremented/decremented in single steps. Volume | + | Volume is an adjustable setting that controls the loudness of the audio at the output channels of the product. Volume can be set to an absolute value or incremented/decremented in single steps. The maximum Volume setting is defined by the VolumeMax Characteristic. The minimum Volume setting is zero. |
| − | |||
== Volume Limit == | == Volume Limit == | ||
| − | + | VolumeLimit specifies the upper limit of the Volume. Any attempt to set the master volume above the VolumeLimit will reset the volume to the value of the VolumeLimit. Whenever the VolumeLimit is adjusted, the current master volume is checked and automatically reduced if necessary. The maximum VolumeLimit setting is defined by the VolumeMax Characteristic. | |
==Balance== | ==Balance== | ||
| − | Balance specifies | + | Balance is an adjustable setting that specifies the bias in volume between the left and right output channels of the product. Balance can be set to an absolute value or incremented/decremented in single steps. The maximum Balance setting is defined by the BalanceMax Characteristic. The minimum Balance setting is defined by (-BalanceMax) . |
| − | |||
| − | |||
==Fade== | ==Fade== | ||
| − | Fade is an adjustable setting that specifies the bias in volume between the front and rear output channels of the products. | + | Fade is an adjustable setting that specifies the bias in volume between the front and rear output channels of the products. Fade can be set to an absolute value or incremented/decremented in single steps. The maximum Fade setting is defined by the FadeMax Characteristic. The minimum Fade setting is defined by (-FadeMax) . |
==Mute== | ==Mute== | ||
| − | + | Mute is an adjustable state that determines if the output channels of the product are muted or not. When muted, all output channels of the product are silent. | |
==Characterstics== | ==Characterstics== | ||
| Line 34: | Line 31: | ||
==== SetVolume==== | ==== SetVolume==== | ||
| − | The SetVolume action provides a means of setting the Volume to | + | The SetVolume action provides a means of setting the Volume to an absolute value. The minimum value that can be applied is zero. The maximum value that can be applied is determined by the VolumeMax and VolumeLimit settings. If an attempt is made to set the Volume above VolumeMax, an error will be reported. If an attempt is made to set the Volume above VolumeLimit, the Volume will be set to the VolumLimit value and no error will be repoprted. |
==== Volume Inc==== | ==== Volume Inc==== | ||
The VolumeInc action provides a means of increasing the Volume by 1. | The VolumeInc action provides a means of increasing the Volume by 1. | ||
Revision as of 14:47, 23 November 2010
Contents
Architecture Overview
The Volume service
Volume
Volume is an adjustable setting that controls the loudness of the audio at the output channels of the product. Volume can be set to an absolute value or incremented/decremented in single steps. The maximum Volume setting is defined by the VolumeMax Characteristic. The minimum Volume setting is zero.
Volume Limit
VolumeLimit specifies the upper limit of the Volume. Any attempt to set the master volume above the VolumeLimit will reset the volume to the value of the VolumeLimit. Whenever the VolumeLimit is adjusted, the current master volume is checked and automatically reduced if necessary. The maximum VolumeLimit setting is defined by the VolumeMax Characteristic.
Balance
Balance is an adjustable setting that specifies the bias in volume between the left and right output channels of the product. Balance can be set to an absolute value or incremented/decremented in single steps. The maximum Balance setting is defined by the BalanceMax Characteristic. The minimum Balance setting is defined by (-BalanceMax) .
Fade
Fade is an adjustable setting that specifies the bias in volume between the front and rear output channels of the products. Fade can be set to an absolute value or incremented/decremented in single steps. The maximum Fade setting is defined by the FadeMax Characteristic. The minimum Fade setting is defined by (-FadeMax) .
Mute
Mute is an adjustable state that determines if the output channels of the product are muted or not. When muted, all output channels of the product are silent.
Characterstics
VolumeMax
VolumeUnity
VolumeSteps
VolumeMilliDbPerStep
BalanceMax
FadeMax
Volume Actions
Volume
The Volume action reports the current master volume setting of the product.
SetVolume
The SetVolume action provides a means of setting the Volume to an absolute value. The minimum value that can be applied is zero. The maximum value that can be applied is determined by the VolumeMax and VolumeLimit settings. If an attempt is made to set the Volume above VolumeMax, an error will be reported. If an attempt is made to set the Volume above VolumeLimit, the Volume will be set to the VolumLimit value and no error will be repoprted.
Volume Inc
The VolumeInc action provides a means of increasing the Volume by 1.
Volume Dec
The VolumeDec action provides a means of decreasing the Volume by 1.
VolumeLimit
The VolumeLimit action reports the current VolumeLimit setting.
Balance
The Balance action reports the current Balance setting.
SetBalance
The SetBalance action provides a means of setting the Balance to a specific value.
BalanceInc
The BalanceInc action provides a means of increasing the Balance by 1.
BalanceDec
The BalanceDec action provides a means of decreasing the Balance by 1.
Fade
The Fade action reports the current Fade setting of the product.
SetFade
The SetFade action provides a means of setting the Fade to a specific value.
FadeInc
The FadeIncaction provides a means of increasing the Fade by 1.
FadeDec
The FadeDec action provides a means of decreasing the Fade by 1.
Mute
The Mute action reports the current Mute state of the product.
SetMute
The SetMute action provides a means of setting the Mute state.
Characteristics
The Characteristics action returns all six characteristic values of the product.
API Reference
Volume Service Description (XML)
Migration Guide
None.
Upnp Action Name Changes
None.
Obsolete Functions
None.
