다음을 통해 공유

AECMicArray

  • 아티클

이 샘플에서는 핵심 오디오 API를 사용하여 고품질 음성 스트림을 캡처합니다. 이 샘플은 Microsoft에서 제공하는 음성 캡처 DSP라고도 하는 AEC DMO를 사용하여 AEC(음향 에코 취소) 및 마이크 배열 처리를 지원합니다.

이 항목에는 다음 섹션이 포함되어 있습니다.

설명

이 샘플에서는 다음 기능을 보여 줍니다.

  • 멀티미디어 디바이스 열거 및 선택을 위한 MMDevice입니다.
  • 스트림 시작 및 중지, 스트림 전환과 같은 스트림 관리 작업을 위한 WASAPI입니다.
  • 오디오 어댑터를 열거하기 위한 DeviceTopology입니다.
  • EndpointVolume 은 오디오 세션의 볼륨 수준을 제어합니다.

요구 사항

제품 버전
Windows SDK Windows Vista 이상
Visual Studio 2005(비 Express 버전)

 

샘플 다운로드

이 샘플은 다음 위치에서 사용할 수 있습니다.

위치 Path/URL
Windows SDK \Program Files\Microsoft SDKs\Windows\v7.0\Samples\Multimedia\Audio\AECMicArray\...

 

예제 빌드

AecSDKDemo 샘플을 빌드하려면 다음 단계를 사용합니다.

  1. SDK 명령 창을 엽니다.

  2. cd %MSSDK%\Setup을 입력합니다.

  3. VCIntegrate.exe 실행합니다.

    이 시점부터 명령 창에는 SDK를 활용하는 애플리케이션을 빌드하기 위한 적절한 환경 설정이 있습니다.

  4. 샘플을 빌드합니다.

샘플 실행

데모 애플리케이션을 성공적으로 빌드하면 실행 파일 AecSDKDemo.exe 생성됩니다. 실행하려면 아래에 설명된 대로 명령 창에 필수 또는 선택적 인수를 입력 AecSDKDemo 합니다.

AecSDKDemo -out mic_out.pcm -mod system_mode [-option value]

다음 표에서는 인수를 보여줍니다.

인수 Description
-out 필수 사항입니다. 출력 파일 이름을 지정합니다.
-모드 필수 사항입니다. 음성 캡처 시스템 모드를 지정합니다. 자세한 내용은 샘플 추가 정보에서 "음성 캡처 DMO 구성" 섹션을 참조하세요.
-위업 선택 사항입니다. 기능 모드를 켜거나(1) 끄기(0)합니다.
-ns 선택 사항입니다. 노이즈 표시 안 함(1) 또는 끄기(0)를 켭니다. 이를 지정하려면 기능 모드가 켜져야 합니다.
-Agc 선택 사항입니다. 디지털 AGC를 켜거나(1) 끄기(0)합니다. 이를 지정하려면 기능 모드가 켜져야 합니다.
-cntrclip 선택 사항입니다. 가운데 클리핑을 켜거나(1) 끄기(0)합니다. 이를 지정하려면 기능 모드가 켜져야 합니다.
-spkdev 선택 사항입니다. 스피커 디바이스 인덱스를 지정합니다. 지정하지 않으면 사용자에게 선택하라는 메시지가 표시됩니다.
-micdev 선택 사항입니다. 마이크 디바이스 인덱스를 지정합니다. 지정하지 않으면 사용자에게 선택하라는 메시지가 표시됩니다.
-기간 선택 사항입니다. 애플리케이션이 실행되는 기간을 지정합니다.

 

이 샘플 애플리케이션은 신호를 재생하지 않습니다. AEC 사용 모드(모드 0 및 4)에 대해 데모를 제대로 실행하려면 사용자는 양방향 채팅 시나리오에서 원거리 음성을 시뮬레이션하는 DMO(즉, "-spkdev" 옵션으로 지정된 디바이스)에 지정된 동일한 스피커 디바이스를 통해 일부 오디오 신호를 재생해야 합니다. 사용자는 모든 플레이어를 사용하여 오디오 신호를 재생할 수 있습니다. 선택한 스피커 디바이스에 활성 렌더링 스트림이 없으면 DMO가 처리되지 않습니다.

핵심 오디오 API를 사용하는 SDK 샘플