AudioEngine QML Type
AudioEngine은 3D 씬 내부의 사운드 오브젝트를 관리합니다. 더 보기...
| Import Statement: | import QtQuick3D.SpatialAudio |
속성
- distanceScale : real
(since 6.11) - masterVolume : real
- outputDevice : QtMultimedia.AudioDevice
- outputMode : enumeration
자세한 설명
오디오 엔진은 3D 씬 내에서 사운드 오브젝트를 관리합니다. 씬에 SpatialSound 개체를 추가하여 3D 공간의 지정된 위치에서 발생하는 사운드를 정의할 수 있습니다. AmbientSound 을 사용하면 스테레오 오버레이(예: 보이스오버 또는 사운드 트랙)를 추가할 수 있습니다.
AudioListener 을 사용하여 음원을 기준으로 음장을 듣는 사람의 위치를 정의할 수 있습니다. 청취자가 음원에서 멀리 떨어져 있으면 음원이 덜 잘 들립니다. 또한 청취자와 소스 사이의 방향에 따라 해당 라우드스피커에 매핑됩니다. 대부분의 경우 AudioListener 객체는 QtQuick3D.Camera 객체의 하위 객체로 간단히 인스턴스화할 수 있습니다.
AudioRoom 오브젝트를 생성하여 특정 크기와 다양한 유형의 벽이 있는 방의 사운드(반사 및 리버브)를 시뮬레이션합니다.
오디오 엔진은 헤드폰을 사용할 때 3D 공간에서 사운드의 위치를 파악하고 헤드폰을 통해 공간 오디오 효과를 생성하기 위해 머리 관련 임펄스 반응 함수(https://en.wikipedia.org/wiki/Sound_localization 참조)를 사용하여 귀의 효과를 시뮬레이션하는 모드를 제공합니다.
Qt Quick 3D 의 나머지 부분과 마찬가지로 오디오 엔진은 기본적으로 센티미터 단위의 좌표계를 사용합니다. 축은 양수 x가 오른쪽을 가리키고, 양수 y가 위쪽을 가리키며, 양수 z가 뒤쪽을 가리키도록 정의됩니다.
속성 문서
distanceScale : real [since 6.11]
공간 오디오 엔진에서 사용하는 좌표계의 축척을 정의합니다. 기본적으로 모든 단위는 Qt Quick 3D 에서 사용하는 기본 단위와 일치하는 센티미터 단위입니다.
거리 눈금을 100으로 설정하면 미터 단위로 표시됩니다.
이 속성은 Qt 6.11에 도입되었습니다.
masterVolume : real
음장 렌더링에 사용되는 전체 볼륨을 설정하거나 반환합니다.
outputDevice : QtMultimedia.AudioDevice
음장 출력에 사용 중인 장치를 설정하거나 반환합니다.
outputMode : enumeration
엔진의 현재 출력 모드를 설정하거나 검색합니다.
| 속성 값 | 설명 |
|---|---|
| 서라운드 | 사운드를 출력 장치의 라우드스피커 구성에 매핑합니다. 일반적으로 스테레오 또는 서라운드 스피커 설정입니다. |
| 스테레오 | 사운드를 출력 장치의 스테레오 라우드스피커 구성에 매핑합니다. 이렇게 하면 추가 스피커는 무시되고 왼쪽 및 오른쪽 채널만 사용하여 음장의 스테레오 렌더링을 생성합니다. |
| 헤드폰 | 헤드폰 공간화를 사용하면 헤드폰을 통해 음장을 들을 때 3D 오디오 효과를 만들 수 있습니다. |
© 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.