AutoHotKey(오토핫키) 설명서 SoundGet

Posted by 발전소장
2014. 8. 14. 14:10 AutoHotKey/Commands

SoundGet

사운드 디바이스의 각종 설정을 취득

SoundGet, OutputVar [, ComponentType, ControlType, DeviceNumber]

Parameters

인수명설명
OutputVar 취득한 값을 격납하는 변수명.
ComponentType 이하의 어떤 것인가.
  • MASTER(디폴트)
  • DIGITAL
  • LINE
  • MICROPHONE
  • SYNTH
  • CD
  • TELEPHONE
  • PCSPEAKER
  • WAVE
  • AUX
  • ANALOG
  • HEADPHONES
  • N/A
디바이스가 존재하지 않는 경우,ErrorLevel에 그 취지를 나타내는 문자열이 대입된다.
같은 종류의 것이 다수 있을 때는 「ANALOG:2」(와)과 같이 지정하는 것으로,2번째 이후의 디바이스를 지정할 수 있다.많은 경우,1번째가 출력,2번째가 입력용 디바이스이다.
ControlType
  • VOLUME(디폴트)
  • ONOFF
  • MUTE
  • MONO
  • LOUDNESS
  • STEREOENH
  • BASSBOOST
  • PAN
  • QSOUNDPAN
  • BASS
  • TREBLE
  • EQUALIZER
그 설정이 존재하지 않는 경우,ErrorLevel에 그 취지를 나타내는 문자열이 대입된다.
번호로 지정할 수도 있다.
DeviceNumber 디바이스 번호.
디폴트는 「1」

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

Remarks

OutputVar에는,ControlType하지만 「ONOFF」 「MUTE」 「MONO」 「LOUDNESS」 「STEREOENH」 「BASSBOOST」의 경우 「ON」인가 「OFF」, 그 이외의 경우는0...100의 소수가 대입된다.
소수의 포맷은SetFormat그리고 설정할 수 있다.
취득에 실패하면 비운다.

ComponentType(이)나ControlType(으)로 지정 가능한 값을 조사하는 방법은,SoundSet의Examples(을)를 참조.

Related

SoundSet, SoundGetWaveVolume, SoundSetWaveVolume, SoundPlay

Example(s)

SoundGet, master_volume
MsgBox, Master volume is %master_volume% percent.

SoundGet, master_mute, , mute
MsgBox, Master Mute is currently %master_mute%.

SoundGet, bass_level, Master, bass
if ErrorLevel <> 0
	MsgBox, Error Description: %ErrorLevel%
else
	MsgBox, The BASS level for MASTER is %bass_level% percent.

SoundGet, microphone_mute, Microphone, mute
if microphone_mute = Off
	MsgBox, The microphone is not muted.