Ändert eine Lautstärkeeinstellung eines Audiogeräts.
SoundSetVolume NeueEinstellung , Komponente, Gerät
Typ: Zeichenkette, Integer oder Float
Eine Zeichenkette, die eine Prozentzahl im Bereich von -100 bis 100 enthält. Wenn die Zahl mit einem Plus- oder Minuszeichen beginnt, wird die aktuelle Einstellung um den angegebenen Wert erhöht bzw. verringert. Andernfalls wird NeueEinstellung explizit gesetzt.
Wenn die Prozentzahl mit einem Minuszeichen beginnt oder vorzeichenlos ist, muss sie nicht in Anführungszeichen gesetzt werden.
Typ: Zeichenkette oder Integer
Wenn leer oder weggelassen, wird standardmäßig die Master-Lautstärkeeinstellung verwendet. Andernfalls geben Sie den Anzeigenamen und/oder die Indexnummer der Komponente an, z.B. 1, "Line in" oder "Line in:2".
Weitere Informationen finden Sie unter Komponente (Sound-Funktionen).
Typ: Zeichenkette oder Integer
Wenn leer oder weggelassen, wird standardmäßig das Standardwiedergabegerät des Systems verwendet (was nicht unbedingt Gerät 1 ist). Andernfalls geben Sie den Anzeigenamen und/oder die Indexnummer des Geräts an, z.B. 1, "Lautsprecher", "Lautsprecher:2" oder "Lautsprecher (Beispiel HD Audio)".
Weitere Informationen finden Sie unter Gerät (Sound-Funktionen).
Es wird ein TargetError ausgelöst, wenn das Gerät oder die Komponente nicht gefunden werden konnte oder wenn die Komponente diesen Reglertyp nicht unterstützt. Andernfalls wird bei Misserfolg ein OSError ausgelöst.
Um die Master-Lautstärke des gesamten Systems zu ändern, kann alternativ ein Skript verwendet werden, das lautstärkespezifische Tastendrücke sendet. Zum Beispiel:
Send "{Volume_Up}" ; Master-Lautstärke um 1 Stufe erhöhen (normalerweise 5 %).
Send "{Volume_Down 3}" ; Master-Lautstärke um 3 Stufen verringern.
Um den Leistungsumfang der installierten Audiogeräte zu ermitteln - z.B. die Namen und verfügbaren Komponenten - führen Sie das Soundkartenanalyse-Skript aus.
SoundSetVolume versucht, die bestehende Balance beim Ändern der Lautstärke beizubehalten.
Mit SoundGetVolume kann die aktuelle Lautstärkeeinstellung abgerufen werden.
Setzt die Master-Lautstärke auf 50 Prozent. Anführungszeichen können weggelassen werden.
SoundSetVolume "50"
SoundSetVolume 50
Erhöht die Master-Lautstärke um 10 Prozent. Anführungszeichen können nicht weggelassen werden.
SoundSetVolume "+10"