サウンドデバイスの音量設定を変更します。
SoundSetVolume NewSetting , Component, Device
A string containing a percentage number between -100 and 100 inclusive. 数値がプラス記号またはマイナス記号で始まる場合、現在の設定は指示された量だけ上下に調整される。そうでない場合は、NewSettingで示されたレベルに明示的に設定される。
If the percentage number begins with a minus sign or is unsigned, it does not need to be enclosed in quotation marks.
空白または省略したときは、マスター音量を設定します。そうでないときは、1
や"Line in"
のようにコンポーネントの表示名とインデックスのいずれかを指定するか、"Line in:2"
のようにその両方を指定します。
詳しくは「Component(Sound関数)」をご覧ください。
空白または省略したときは、初期値はシステムのデフォルトの再生デバイス(必ずしもデバイス1である必要はありません)になります。そうでないときは、1
や"Speakers"
や"Speakers (Example HD Audio)"
のようにコンポーネントの表示名とインデックスのいずれかを指定するか、"Speakers:2"
のようにその両方を指定します。
詳しくはDevice(Sound関数)をご覧ください。
デバイスまたはコンポーネントが見つからないときや、コンポーネントがコントロールをサポートしていないときは、TargetErrorがスローされます。そうでないときは、失敗したときにOSErrorがスローされます。
ボリュームを調整する別の方法として、スクリプトにボリュームコントロールのキーストロークを送信させ、以下の例のようにシステム全体のマスターボリュームを変更する方法があります:
Send "{Volume_Up}" ; Raise the master volume by 1 interval (typically 5%). Send "{Volume_Down 3}" ; Lower the master volume by 3 intervals.
システムにインストールされているサウンドデバイスの機能(名前や使用可能なコンポーネントなど)を調べるには、サウンドカード解析スクリプトを実行します。
SoundSetVolumeは、音量レベルを変更する際、既存のバランスを維持しようとする。
現在の音量設定を取得するには、SoundGetVolumeを使用する。
Sets the master volume to 50 percent. Quotation marks can be omitted.
SoundSetVolume "50"
SoundSetVolume 50