공간 오디오 개요

Qt Spatial Audio API는 3차원 사운드 씬을 생성할 수 있는 여러 클래스를 제공합니다. 이 씬은 3D 공간에 위치하여 소리를 내는 오브젝트와, 하나 또는 여러 개의 룸을 사용하여 모델링할 수 있는 주변 지오메트리로 정의됩니다. 마지막으로, 청취자를 지정된 위치와 방향으로 이 사운드 씬 내에 배치할 수 있습니다.

C++ 및 QML API를 모두 사용할 수 있습니다.

사운드 씬 생성

사운드 씬을 생성하려면 먼저 ` QAudioEngine` 인스턴스를 생성해야 합니다. 이 엔진은 입력된 사운드 데이터와 기하학적 구조를 처리하여, 씬 내 특정 위치에 있는 사람이 실제로 경험할 법한 사운드 씬을 사실적으로 재현합니다.

QAudioEngine::OutputMode 속성을 사용하여 바이노럴(가상 3D) 렌더링을 사용하는 헤드폰이나 스테레오 또는 서라운드 스피커 구성에 맞게 출력을 최적화할 수 있습니다.

QAudioEngine::outputDevice 속성을 사용하여 출력 장치를 선택할 수 있습니다.

엔진이 설정되면, ` QSpatialSound ` 객체를 생성하고 ` QSpatialSound::source ` 속성을 사용하여 사운드 파일의 URL을 지정함으로써 다양한 사운드 객체를 씬에 배치할 수 있습니다.

QAudioListener 속성을 사용하여 사운드 장면을 듣는 청취자의 위치와 방향을 정의할 수 있습니다. 엔진당 최대 한 명의 청취자만 사용할 수 있습니다. 청취자가 지정되지 않은 경우, 엔진은 청취자가 좌표계의 원점에 위치하며, z축의 양의 방향을 향하고 y축의 양의 방향이 위쪽을 가리키도록 가정합니다.

음원과 청취자 외에도, 일련의 ` QAudioRoom ` 객체를 통해 청취자가 소리를 경험하는 방식에 영향을 미치는 기하학적 구조를 정의할 수 있습니다. 방은 직사각형 형태이며, 각 벽면에 다양한 재질을 적용할 수 있어 서로 다른 음향 반사와 잔향으로 독특한 청취 경험을 제공합니다. 청취자가 방 중 하나 안에 위치해 있으면 방 효과가 적용됩니다. 청취자가 여러 방 안에 동시에 위치해 있는 경우, 기하학적 부피가 가장 작은 방의 효과가 우선 적용됩니다.

청취자의 위치나 방향과 무관한 스테레오 오버레이(예: 배경 음악이나 내레이션)가 필요한 경우, ` QAmbientSound `를 사용하여 사운드 오버레이를 생성할 수 있습니다.

방 안에서 이동할 수 있는 하나의 오디오 소스를 보여주는 간단한 QWidget 기반 예제를 보려면 ‘공간 오디오 패닝 예제(Spacial Audio Panning Example)’를 참고하십시오.

참조 문서

C++ 클래스

QML 유형