Qt Spatial Audio
Qt Spatial Audio 는 3D 공간에서 음장을 구현하기 위한 다양한 QML 유형과 C++ 클래스 세트를 제공하는 애드온 모듈입니다. 여기에는 공간에 리스너를 배치하고, 리스너 주변에 지역화된 음원을 추가하고, 리버브와 리플렉션으로 가상 공간을 에뮬레이션하는 데 사용하기 쉬운 API가 포함되어 있습니다.
시작하기
Qt Spatial Audio 을 처음 사용하는 경우 .qml
파일에 다음 문을 사용하여 QML 유형을 애플리케이션으로 가져올 수 있습니다.
import QtQuick3D.SpatialAudio
C++ 라이브러리에 연결하려면 프로젝트의 CMakeLists.txt
파일에 다음을 추가합니다. my_project
을 프로젝트 이름으로 대체합니다.
find_package(Qt6 REQUIRED COMPONENTS SpatialAudio)
target_link_libraries(my_project PRIVATE Qt6::SpatialAudio)
공간 오디오 개요에서는 아래 나열된 다양한 클래스를 사용하는 방법에 대한 자세한 설명을 제공합니다.
QML 유형
다음 표에는 몇 가지 중요한 QML 유형이 요약되어 있습니다.
유형 | 설명 |
---|---|
AudioEngine | 오디오 씬을 처리하는 엔진 |
SpatialSound | 3D 공간에 위치한 사운드 소스입니다. |
AmbientSound | 위치에 독립적인 스테레오 사운드 트랙입니다. |
AudioRoom | 오디오 리버브와 리플렉션을 생성하는 공간을 정의합니다. |
C++ 클래스
다음 표는 몇 가지 중요한 C++ 클래스에 대한 개요입니다.
클래스 | 설명 |
---|---|
QAudioEngine | 오디오 씬을 처리하는 엔진 |
QSpatialSound | 3D 공간에 위치한 사운드 소스입니다. |
QAmbientSound | 위치에 독립적인 스테레오 사운드 트랙입니다. |
QAudioRoom | 오디오 리버브와 리플렉션을 생성하는 공간을 정의합니다. |
라이선스 및 속성
Qt Spatial Audio 모듈은 The Qt Company의 상용 라이선스에 따라 사용할 수 있습니다. 또한 무료 소프트웨어 라이선스에 따라 사용할 수 있습니다. 이러한 무료 소프트웨어 라이선스는 GNU 약소 일반 공중 사용 허가서, 버전 3 또는 GNU 일반 공중 사용 허가서, 버전 3입니다. 자세한 내용은 Qt 라이선스를 참조하십시오.
Qt Spatial Audio 은 GNU 일반 공중 사용 허가서 버전 2에 따라 사용할 수 없습니다.
또한 Qt 6.8.2의 Qt Spatial Audio 에는 다음과 같은 허용 라이선스에 따른 타사 모듈이 포함되어 있습니다:
Mozilla 공중 사용 허가서 2.0 및 BSD 3-항 "신" 또는 "개정" 라이선스 | |
Apache 라이선스 2.0 | |
BSD 3-항 "신" 또는 "개정" 라이선스 |
참조 및 예제
© 2025 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.