AudioRoom QML Type

Import Statement: import QtQuick3D.SpatialAudio

속성

상세 설명

공간 오디오 엔진의 방을 정의합니다.

청취자가 방 안에 있는 경우, 방 속성과 일치하는 사운드 반사 및 리버브가 우선적으로 음장에 적용됩니다.

방은 항상 정사각형이며 중심 위치, 방향 및 치수에 따라 정의됩니다. 방의 6개의 벽은 각각 다른 재질로 만들어져 청취자가 방 안에 있는 동안 경험하게 될 계산된 반사와 리버브에 기여할 수 있습니다.

여러 개의 방이 같은 위치를 커버하는 경우 엔진은 가장 작은 볼륨을 가진 방을 사용합니다.

프로퍼티 문서

backMaterial : AudioRoom::Material

ceilingMaterial : AudioRoom::Material

floorMaterial : AudioRoom::Material

frontMaterial : AudioRoom::Material

leftMaterial : AudioRoom::Material

rightMaterial : AudioRoom::Material

방의 다른 면에 사용할 재질을 설정합니다. 속성은 다음과 같이 좌표와 연관되어 있습니다:

속성좌표
왼쪽음수 x
오른쪽양수 x
뒤로네거티브 z
양수 z
바닥음수 y
천장양수 y

머티리얼의 유효한 값은 다음과 같습니다:

속성 값설명
투명방의 측면이 열려 있으며 반사나 리버브에 기여하지 않습니다.
AcousticCeilingTiles대부분의 리플렉션과 리버브를 억제하는 어쿠스틱 타일입니다.
BrickBare맨 벽돌 벽입니다.
BrickPainted페인트 칠한 벽돌 벽입니다.
콘크리트 블록 거친원시 콘크리트 벽입니다.
콘크리트 블록 페인트페인트 칠한 콘크리트 벽
CurtainHeavy무거운 커튼입니다. 주로 저주파를 반사합니다.
섬유유리단열재섬유 유리 단열재. 매우 낮은 주파수만 반사합니다.
GlassThin얇은 유리 벽
GlassThick두꺼운 유리 벽
GrassGrass
리놀륨온콘크리트리놀륨 바닥
대리석대리석 바닥
금속금속
콘크리트 마루콘크리트 위에 쪽모이 세공 나무 바닥
석고거친거친 석고
석고매끄러운매끄러운 석고
합판패널플라이우드 패널
광택콘크리트 또는 타일광택 콘크리트 또는 타일
시트 록Rock
물 또는 얼음 표면물 또는 얼음
목재 천장나무 천장
WoodPanel나무 패널
유니폼모든 주파수에서 균일한 반사를 제공하는 인공 재료

dimensions : vector3D

3D 공간에서 방의 치수를 정의합니다. 단위는 기본적으로 센티미터입니다.

QtQuick3D::Node::position참조하세요 .


reflectionGain : real

이 방에서 생성되는 반사에 대한 게인 계수입니다. 0에서 1 사이의 값은 반사를 약화시키고, 1보다 큰 값은 반사에 게인을 적용하여 반사를 더 크게 만듭니다.

기본값은 1이며, 계수가 0이면 리플렉션이 비활성화됩니다. 음수 값은 0에 매핑됩니다.


reverbBrightness : real

생성된 리버브에 적용할 밝기 계수입니다. 양수 값은 높은 주파수의 리버브를 증가시키고 낮은 주파수를 감쇠시키며, 음수 값은 그 반대의 역할을 합니다.

기본값은 0입니다.


reverbGain : real

이 룸에서 생성되는 리버브에 대한 게인 계수입니다. 0에서 1 사이의 값은 리버브를 감쇠시키고, 1보다 큰 값은 리버브에 게인을 적용하여 리버브를 더 크게 만듭니다.

기본값은 1이며, 계수가 0이면 리버브가 비활성화됩니다. 음수 값은 0에 매핑됩니다.


reverbTime : real

이 룸에 대해 생성되는 모든 리버브 타이밍에 적용될 팩터입니다. 값이 클수록 리버브 타이밍이 길어져 룸 사운드가 커집니다.

기본값은 1입니다. 음수 값은 0에 매핑됩니다.


© 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.