AudioEngine QML Type
AudioEngine은 3D 씬 내부의 사운드 오브젝트를 관리합니다. 더 보기...
Import Statement: | import QtQuick3D.SpatialAudio |
속성
- 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가 뒤쪽을 가리키도록 정의됩니다.
속성 문서
masterVolume : real |
음장 렌더링에 사용되는 전체 볼륨을 설정하거나 반환합니다.
outputDevice : QtMultimedia.AudioDevice |
음장 출력에 사용되는 장치를 설정하거나 반환합니다.
outputMode : enumeration |
엔진의 현재 출력 모드를 설정하거나 반환합니다.
프로퍼티 값 | 설명 |
---|---|
서라운드 | 사운드를 출력 장치의 라우드스피커 구성에 매핑합니다. 일반적으로 스테레오 또는 서라운드 스피커 설정입니다. |
스테레오 | 사운드를 출력 장치의 스테레오 라우드스피커 구성에 매핑합니다. 이렇게 하면 추가 스피커는 무시되고 왼쪽 및 오른쪽 채널만 사용하여 음장의 스테레오 렌더링을 생성합니다. |
헤드폰 | 헤드폰 공간화를 사용하면 헤드폰을 통해 음장을 들을 때 3D 오디오 효과를 만들 수 있습니다. |
© 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.