SoundGet

Retrieves various settings of a sound device (master mute, master volume, etc.)

SoundGet, OutputVar , ComponentType, ControlType, DeviceNumber

매개변수

OutputVar

The name of the output variable in which to store the retrieved setting, which is either a floating point number between 0 and 100 (inclusive) or the word ON or OFF (used only for ControlTypes ONOFF, MUTE, MONO, LOUDNESS, STEREOENH, and BASSBOOST). 이 변수는 설정을 열람하는 데 문제가 있었으면 비워집니다. 부동 소수점 수의 형식은, 예를 들어 소수점의 위치는, SetFormat에 의하여 결정됩니다.

ComponentType

비어 있거냐 생략하면, 기본 값은 단어 MASTER입니다. 그렇지 않으면, 다음 단어 중 하나가 될 수 있습니다: MASTER (SPEAKERS와 동의어), DIGITAL, LINE, MICROPHONE, SYNTH, CD, TELEPHONE, PCSPEAKER, WAVE, AUX, ANALOG, HEADPHONES, 또는 N/A. 사운드 장치에 지정된 ComponentType이 없으면, ErrorLevel은 그 문제를 나타낼 것입니다.

어떤 믹서에서 라벨이 Auxiliary인 콤포넌트는 AUX가 아니라ANALOG로 접근할 수 있습니다.

사운드 장치에 ComponentType의 실체가 여럿이면 (예를 들어 두 종류의 LINE이 있으면), 보통 첫 번째에 연주 설정이 담기고 둘 째에 녹음 설정이 담깁니다. 첫 번째 말고 다른 실체에 접근하려면, 쌍점과 숫자를 이 매개변수에 추가하십시오. 예를 들어: Analog:2는 아날로그 컴포넌트의 두번째 실체라는 뜻입니다.

ControlType

비어 있거나 생략하면, 기본 값은 VOLUME입니다. 그렇지 않으면, 다음 단어 중 하나가 될 수 있습니다: VOLUME (또는 VOL), ONOFF, MUTE, MONO, LOUDNESS, STEREOENH, BASSBOOST, PAN, QSOUNDPAN, BASS, TREBLE, EQUALIZER, 또는 유효한 콘트롤 유형의 번호 (사운드카드 분석 스크립트 참조). 지정된 ComponentType에 지정된 ControlType이 없으면, ErrorLevel은 그 문제를 알려줄 것입니다.

주의: 사운드 장치는 보통 VOLUME (또는 VOL) 그리고 MUTE만 지원합니다. 물론 다른 것들도 윈도우즈 버전과 사운드 장치에 따라 사용할 수 있습니다.

DeviceNumber

1부터 지원되는 장치의 총 개수까지의 숫자. 이 매개변수를 생략하면, 기본 값은 1입니다 (첫 번째 사운드 장치), 아니면 Windows Vista 이상에서 연주를 위한 시스템의 기본 장치입니다. 이 매개변수는 표현식일 수 있습니다. 사운드카드 분석 스크립트가 어느 번호를 사용해야할지 결정하는 데 도움을 줄 것입니다.

에러 처리

[v1.1.04+]: 이 명령어는 실패하면 예외를 던질 수 있습니다. 더 자세한 정보는 실행시간 에러를 참조하십시오.

ErrorLevel는 명령어가 성공하면 0이 설정됩니다. 그렇지 않으면 다음 문구 중 하나가 설정됩니다:

• 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 (현재 설정을 얻을 수 없음)

논평

Windows Vista 이후는 v1.1.10부터 지원합니다.

시스템에 설치된 사운드 장치 (믹서)의 능력을 알아내려면 -- 예를 들어, 컴포턴트 유형과 콘트롤 유형 -- 다음 사운드카드 분석 스크립트를 실행하십시오.

오디오를 더 섬세하게 제어하려면, VA 라이브러리의 사용을 고려해 보십시오.

설정을 바꾸려면 SoundSet을 사용하십시오.

관련 항목

SoundSet, SoundGetWaveVolume, SoundSetWaveVolume, SoundPlay

예제

SoundGet, master_volume
MsgBox, 마스터 볼륨은 %master_volume% 퍼센트입니다.

SoundGet, master_mute,, Mute
MsgBox, 마스터 음소거는 현재 %master_mute%입니다.

SoundGet, bass_level, Master, Bass
if ErrorLevel
    MsgBox, 에러 설명: %ErrorLevel%
else
    MsgBox, MASTER에 대한 BASS 레벨은 %bass_level% 퍼센트입니다.

SoundGet, microphone_mute, Microphone, Mute
if (microphone_mute = "Off")
    MsgBox, 마이크로폰이 음소거되지 않았습니다.