Оригинал статьи в AutoHotkey.chm: "SoundGet", в содержании - "Sound Commands" - "SoundGet", v1.0.46.03.

Ник переводчика: YMP.

Настоящее имя переводчика: Юрий Попов.

SoundGet

Считывает текущие настройки звукового устройства (микшера). Окно с этими настройками открывается, например, при двойном щелчке по динамику в трее.

SoundGet, OutputVar [, ComponentType, ControlType, DeviceNumber]

Параметры

OutputVar	Имя выходной переменной. В зависимости от вида считываемой настройки возвращаемое в переменную значение может быть числом (с плавающей точкой) в диапазоне от 0 до 100 (включительно), либо словом ON или OFF (для настроек ONOFF, MUTE, MONO, LOUDNESS, STEREOENH, BASSBOOST). Формат числа (количество знаков после запятой и пр.) определяется командой SetFormat. Если считать настройку не удалось, переменная будет пустой.
ComponentType	Тип компонента (соотносится с одним из регуляторов в окне настроек микшера). Если опущен или пустой, принимает значение MASTER (общий регулятор громкости, который доступен также при одиночном щелчке по динамику в трее). Допустимые значения: MASTER (то же, что SPEAKERS), DIGITAL, LINE, MICROPHONE, SYNTH, CD, TELEPHONE, PCSPEAKER, WAVE, AUX, ANALOG. Для версии 1.0.37.06 и следующих добавлено значение N/A, для версии 1.0.42.04 и следующих добавлено значение HEADPHONES. Если микшер не содержит указанного компонента, это будет отражено сообщением в переменной ErrorLevel (см. список ниже). Компонент, обозначаемый в микшере как Auxiliary (дополнительный), иногда может быть доступен как ANALOG, а не как AUX. Если микшер имеет более одного экземпляра какого-то компонента, то обычно первый содержит настройки воспроизведения, а второй - настройки записи. Для доступа ко второму и следующим экземплярам добавляйте двоеточие и номер к имени компонента. Например, Analog:2.
ControlType	Вид настройки. Если опущен или пустой, принимает значение VOLUME (громкость). Допустимые значения: VOLUME (или VOL), ONOFF, MUTE, MONO, LOUDNESS, STEREOENH, BASSBOOST, PAN, QSOUNDPAN, BASS, TREBLE, EQUALIZER. В версии 1.0.37.06 и следующих может задаваться номером (см. переменную ControlTypes в скрипте для анализа звуковой карты). Если компонент не поддерживает указанный вид настройки, это будет отражено сообщением в переменной ErrorLevel (см. список ниже).
DeviceNumber	Может быть выражением. Номер устройства. Если опущен, принимает значение 1, что обычно соответствует системному устройству по умолчанию для записи и воспроизведения. Для доступа к другим устройствам указывайте номер больше единицы.

ErrorLevel

Равен нулю, если команда выполнена успешно. Иначе принимает одно из следующих значений:

Invalid Control Type or Component Type (Неверный вид настройки или тип компонента)

Can't Open Specified Mixer (Не могу открыть указанный микшер)

Mixer Doesn't Support This Component Type (Микшер не поддерживает указанный компонент)

Mixer Doesn't Have That Many of That Component Type (Количество компонентов данного типа в микшере меньше, чем указанный номер)

Component Doesn't Support This Control Type (Компонент не поддерживает указанную настройку)

Can't Get Current Setting (Не могу считать текущую настройку)

Примечания

Чтобы выяснить возможности установленных в системе звуковых устройств (микшеров), такие как доступные типы компонентов и виды настроек, запустите скрипт для анализа звуковой карты из статьи SoundSet.

Для изменения настроек используйте команду SoundSet.

Примеры

SoundGet, master_volume
MsgBox, Общий регулятор громкости сейчас на уровне %master_volume% процентов.

SoundGet, master_mute, , mute
MsgBox, Выключатель общего регулятора громкости сейчас в положении %master_mute%.

SoundGet, bass_level, Master, bass
if ErrorLevel
    MsgBox, Описание ошибки: %ErrorLevel%
else
    MsgBox, Уровень нижних частот общего регулятора громкости %bass_level% процентов.

SoundGet, microphone_mute, Microphone, mute
if microphone_mute = Off
    MsgBox, Микрофон не отключен.
else if microphone_mute = On
    MsgBox, Микрофон отключен.

Перейти на главную страничку сайта (список статей, файлы для скачивания)