이 페이지에서는

Qt Spatial Audio

Qt Spatial Audio 3D 공간에서 음장을 구현하기 위한 다양한 QML 타입과 C++ 클래스를 제공하는 애드온 모듈이 소개되어 있습니다. 이 모듈에는 공간 내에 청취자를 배치하고, 청취자 주변에 국소화된 음원을 추가하며, 잔향과 반사를 통해 가상 공간을 시뮬레이션할 수 있는 사용하기 쉬운 API가 포함되어 있습니다.

시작하기

Qt Spatial Audio 를 처음 사용하시는 경우, .qml 파일에 다음 문장을 추가하여 QML 타입을 애플리케이션으로 가져올 수 있습니다.

import QtQuick3D.SpatialAudio

C++ 라이브러리를 링크하려면 프로젝트의 ` CMakeLists.txt ` 파일에 다음 내용을 추가하십시오. ` mytarget `을 프로젝트 이름으로 대체하십시오.

find_package(Qt6 REQUIRED COMPONENTS SpatialAudio)
target_link_libraries(mytarget PRIVATE Qt6::SpatialAudio)

'공간 오디오 개요'에서는 아래에 나열된 다양한 클래스의 사용 방법에 대해 더 자세히 설명하고 있습니다.

QML 유형

다음 표는 몇 가지 중요한 QML 유형을 요약한 것입니다.

유형설명
AudioEngine오디오 씬 처리를 수행하는 엔진
SpatialSound3D 공간에 위치한 음원입니다.
AmbientSound위치에 구애받지 않는 스테레오 사운드 트랙입니다.
AudioRoom오디오 리버브와 반사를 생성하는 공간을 정의합니다.

C++ 클래스

다음 표는 몇 가지 중요한 C++ 클래스를 요약한 것입니다.

클래스설명
QAudioEngine오디오 씬 처리를 수행하는 엔진
QSpatialSound3D 공간에 위치한 음원입니다.
QAmbientSound위치에 구애받지 않는 스테레오 사운드 트랙입니다.
QAudioRoom오디오 리버브와 반사를 생성하는 공간을 정의합니다.

라이선스 및 출처 표기

Qt Spatial Audio 모듈은 The Qt Company의 상용 라이선스 하에 제공됩니다. 또한, 이 모듈은 자유 소프트웨어 라이선스 하에서도 이용 가능합니다. 이러한 자유 소프트웨어 라이선스에는 GNU Lesser General Public License 버전 3 또는 GNU General Public License 버전 3이 포함됩니다. 자세한 내용은 Qt 라이선싱을 참조하십시오.

Qt Spatial Audio 는 GNU 일반 공중 사용 허가서(GNU General Public License) 버전 2 하에서는 제공되지 않습니다.

또한, Qt 6.12.0의 Qt Spatial Audio 에는 다음의 허용적인 라이선스에 따라 제공되는 타사 모듈이 포함되어 있습니다:

Eigen, version 5.0.1

Mozilla Public License 2.0 및 BSD 3조항 “New” 또는 “Revised” 라이선스

Resonance Audio, version e225aedb5ec76ca6a0fe7079c0b84dbcbb490553

아파치 라이선스 2.0

pffft, version 02fe7715a5bf8bfd914681c53429600f94e0f536

BSD 3조항 “New” 또는 “Revised” 라이선스

참조 및 예제

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.