サウンドデバイスの音量設定を変更します。
SoundSetVolume NewSetting , Component, Device
-100から100までのパーセンテージを表す数字を含む文字列です。数値がプラス記号またはマイナス記号で始まる場合、現在の設定は指示された量だけ上下に調整されます。そうでない場合は、NewSettingで示されたレベルに明示的に設定されます。
パーセントを表す数字がマイナス記号で始まるか符号がないときは、引用符で囲む必要はありません。
空白または省略したときは、マスター音量を設定します。そうでないときは、1や"Line in"のようにコンポーネントの表示名とインデックスのいずれかを指定するか、"Line in:2"のようにその両方を指定します。
詳しくは「Component(Sound関数)」をご覧ください。
空白または省略したときは、初期値はシステムのデフォルトの再生デバイス(必ずしもデバイス1である必要はありません)になります。そうでないときは、1や"Speakers"や"Speakers (Example HD Audio)"のようにコンポーネントの表示名とインデックスのいずれかを指定するか、"Speakers:2"のようにその両方を指定します。
詳しくはDevice(Sound関数)をご覧ください。
デバイスまたはコンポーネントが見つからないときや、コンポーネントがコントロールをサポートしていないときは、TargetErrorがスローされます。そうでないときは、失敗したときにOSErrorがスローされます。
ボリュームを調整する別の方法として、スクリプトにボリュームコントロールのキーストロークを送信させ、以下の例のようにシステム全体のマスターボリュームを変更する方法があります:
Send "{Volume_Up}" ; マスター音量を1段階(通常5%)上げます。
Send "{Volume_Down 3}" ; マスター音量を3段階下げます。
システムにインストールされているサウンドデバイスの機能(名前や使用可能なコンポーネントなど)を調べるには、サウンドカード解析スクリプトを実行します。
SoundSetVolumeは、音量レベルを変更する際、既存のバランスを維持しようとします。
現在の音量設定を取得するには、SoundGetVolumeを使用してください。