본문으로 건너뛰기
시골프로그래머의 블로그
블로그 메뉴

델파이로 Windows 볼륨 조절하고 바깥 변경까지 따라가기 — VolumeControl

Core Audio(WASAPI)로 Windows 전체 볼륨과 앱 볼륨을 조절하고, 볼륨 믹서나 볼륨 키로 바뀐 값도 화면에 반영하는 Delphi VCL 예제입니다.

풀빛컴퓨팅3분 읽기#오픈소스#Delphi#Windows 오디오#WASAPI

프로그램 안에 볼륨 슬라이더를 두는 것까지는 어렵지 않습니다. 곤란한 건 사용자가 키보드 볼륨 키나 Windows 볼륨 믹서로 값을 바꿨을 때입니다. 프로그램의 슬라이더는 예전 값에 머물러 있고, 두 값이 어긋납니다.

VolumeControl은 Core Audio(WASAPI) API로 볼륨을 조절하면서, 바깥에서 일어난 변경도 받아서 트랙바를 실시간으로 움직이는 Delphi(VCL) 예제입니다.

VolumeControl 화면

무엇을 하나

인터페이스 하나(IVolumeControl)로 두 가지 볼륨을 다룹니다.

볼륨 내용 쓰는 API
전체(마스터) 볼륨 기본 출력 장치의 전체 볼륨 IAudioEndpointVolume
앱 볼륨 이 프로세스의 오디오 세션 볼륨. 볼륨 믹서에 앱별로 뜨는 그 슬라이더 ISimpleAudioVolume

그 밖에 이런 처리가 들어 있습니다.

  • IAudioEndpointVolumeCallback·IAudioSessionEvents를 등록해 시스템 어디서든 바뀐 볼륨과 음소거를 받습니다.
  • 값을 바꿀 때마다 고정 EventContext GUID를 넘기고, 콜백에서 이 값을 비교해 이 앱이 바꾼 것(AExternal = False)인지 바깥에서 바꾼 것(AExternal = True)인지 가립니다.
  • 콜백은 오디오 시스템의 작업 스레드에서 오므로 TThread.Queue로 메인 스레드에 넘겨 화면을 고칩니다.
  • NotifyDelayMs가 0이면 바로 반영하고, 0보다 크면 변경이 멈춘 뒤 마지막 값만 한 번 알립니다.

어떻게 만들었나

Core Audio는 "드래그가 끝났다"는 신호를 주지 않고 값이 바뀔 때마다 알림을 보냅니다. 믹서 슬라이더를 끌면 알림이 쏟아집니다. 예제는 이렇게 처리합니다.

  1. OnNotify·OnSimpleVolumeChanged가 Core Audio 작업 스레드에서 불립니다.
  2. 최신 값을 잠금 아래 보관하고, TThread.Queue로 작업을 하나만 넣습니다.
  3. 메인 스레드에서 OnVolumeChanged·OnMuteChanged 이벤트를 올립니다.
  4. 폼이 트랙바를 고칠 때는 플래그로 막아, 코드로 바꾼 Position이 다시 SetVolume을 부르지 않게 합니다.

쌓인 알림을 하나씩 처리하지 않으니 트랙바가 밀리지 않고 따라옵니다.

써 보기

var LVolume: IVolumeControl := CreateMasterVolume;   // 또는 CreateAppVolume
LVolume.NotifyDelayMs := 0;                          // 0 = 즉시, > 0 = debounce(밀리초)
LVolume.OnVolumeChanged :=
  procedure(Sender: TObject; APercent: Integer; AExternal: Boolean)
  // ... 핸들러 ...
LVolume.Volume := 50;                                // 50% 로 설정

IDE에서 src/VolumeTest.dproj를 열어 빌드하거나, 명령줄 컴파일러를 씁니다.

"C:/Program Files (x86)/Embarcadero/Studio/37.0/bin/dcc64.exe" src/VolumeTest.dpr -B -E"BIN"

src/VolumeSmoke.dpr는 화면 없이 제어·알림·해제 경로를 점검하는 콘솔 테스트입니다. 실제로 가져다 쓸 부분은 src/Audio.Volume.pas 한 파일입니다.

COM 초기화

VolumeTest.dpr은 CoInitializeEx(nil, COINIT_APARTMENTTHREADED)를 먼저 부릅니다. 이 호출이 없으면 오디오 세션 알림을 등록할 때 COM 마샬링이 정해지지 않아, 앱 볼륨을 처음 바꿀 때 프로그램이 죽을 수 있습니다.

알아 둘 점

  • Delphi 13(Embarcadero Studio 37.0) 또는 호환 버전, Windows Vista 이상이 필요합니다. 타깃 플랫폼은 Win64입니다.
  • 라이선스는 MIT입니다.

소스는 GitHub 저장소에 있습니다.

함께 읽으면 좋은 글