AudioEngine QML Type

AudioEngine은 3D 씬 내의 사운드 오브젝트를 관리합니다. 더 보기...

• 상속된 멤버를 포함한 모든 멤버 목록

속성

• distanceScale : real (since 6.11)
• masterVolume : real
• outputDevice : QtMultimedia.AudioDevice
• outputMode : enumeration

상세 설명

AudioEngine은 3D 씬 내의 사운드 오브젝트를 관리합니다. 씬에 ' SpatialSound ' 오브젝트를 추가하여 3D 공간의 특정 위치에서 발생하는 사운드를 정의할 수 있습니다. ' AmbientSound '을 사용하면 스테레오 오버레이(예: 보이스오버 또는 사운드트랙)를 추가할 수 있습니다.

AudioListener 를 사용하여 음원을 기준으로 음장을 듣는 사람의 위치를 정의할 수 있습니다. 청취자가 음원으로부터 멀어질수록 음원은 덜 들리게 됩니다. 또한 청취자와 음원 사이의 방향에 따라 해당 음원이 해당 라우드스피커로 매핑됩니다. 대부분의 경우, AudioListener 객체는 QtQuick3D.Camera 객체의 자식 객체로 간단히 인스턴스화할 수 있습니다.

특정 크기와 다양한 유형의 벽을 가진 방의 소리(반사음 및 잔향)를 시뮬레이션하려면 ` AudioRoom ` 객체를 생성하십시오.

AudioEngine은 헤드폰을 사용할 때 3D 공간에서 소리의 위치를 파악하고 헤드 관련 임펄스 응답 함수(Head-Related Impulse Response, HRIR)를 사용하여 귀의 효과를 시뮬레이션함으로써(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

엔진의 현재 출력 모드를 설정하거나 가져옵니다.