SoundSetVolume

サウンドデバイスの音量設定を変更します。

SoundSetVolume NewSetting , Component, Device

パラメータ

NewSetting

型:文字列整数または浮動小数点数

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.

Component

型:文字列または整数

空白または省略したときは、マスター音量を設定します。そうでないときは、1"Line in"のようにコンポーネントの表示名とインデックスのいずれかを指定するか、"Line in:2"のようにその両方を指定します。

詳しくは「Component(Sound関数)」をご覧ください。

Device

型:文字列または整数

空白または省略したときは、初期値はシステムのデフォルトの再生デバイス(必ずしもデバイス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を使用する。

Sound関数

Sets the master volume to 50 percent. Quotation marks can be omitted.

SoundSetVolume "50"
SoundSetVolume 50

Increases the master volume by 10 percent. Quotation marks cannot be omitted.

SoundSetVolume "+10"

Decreases the master volume by 10 percent. Quotation marks can be omitted.

SoundSetVolume "-10"
SoundSetVolume -10

Increases microphone recording volume by 20 percent.

SoundSetVolume "+20", , "Microphone"