Changes a volume setting of a sound device.
SoundSetVolume NewSetting , Component, Device
Type: String, Integer or Float
A string containing a percentage number between -100 and 100 inclusive. If the number begins with a plus or minus sign, the current setting will be adjusted up or down by the indicated amount. Otherwise, the setting will be set explicitly to the level indicated by NewSetting.
If the percentage number begins with a minus sign or is unsigned, it does not need to be enclosed in quotation marks.
If blank or omitted, it defaults to the master volume setting. Otherwise, specify the component's display name and/or index, e.g. 1, "Line in" or "Line in:2".
For further details, see Component (Sound Functions).
If blank or omitted, it defaults to the system's default device for playback (which is not necessarily device 1). Otherwise, specify the device's display name and/or index, e.g. 1, "Speakers", "Speakers:2" or "Speakers (Example HD Audio)".
For further details, see Device (Sound Functions).
A TargetError is thrown if the device or component could not be found or if the component does not support this control type. Otherwise, an OSError is thrown on failure.
An alternative way to adjust the volume is to have the script send volume-control keystrokes to change the master volume for the entire system, such as in the example below:
Send "{Volume_Up}" ; Raise the master volume by 1 interval (typically 5%).
Send "{Volume_Down 3}" ; Lower the master volume by 3 intervals.
To discover the capabilities of the sound devices installed on the system -- such as the names and available components -- run the soundcard analysis script.
SoundSetVolume attempts to preserve the existing balance when changing the volume level.
Use SoundGetVolume to retrieve the current volume setting.
Sets the master volume to 50 percent. Quotation marks can be omitted.
SoundSetVolume "50"
SoundSetVolume 50