SpatialSound QML Type
3D 공간의 사운드 오브젝트. 더 보기...
Import Statement: | import QtQuick3D.SpatialAudio |
속성
- autoPlay : bool
- directivity : real
- directivityOrder : real
- distanceCutoff : real
- distanceModel : enumeration
- loops : int
- manualAttenuation : real
- nearFieldGain : real
- occlusionIntensity : real
- size : real
- source : url
- volume : real
방법
상세 설명
공간사운드는 3D 공간에서 들리는 물체를 나타냅니다. 공간에서의 위치와 방향을 정의하고, 재생되는 사운드를 설정하고, 오브젝트의 볼륨을 정의할 수 있습니다.
오브젝트는 다양한 감쇠 동작을 가질 수 있고, 주로 한 방향 또는 구형으로 사운드를 방출하며, 다른 오브젝트에 의해 가려진 것처럼 동작할 수 있습니다.
속성 문서
autoPlay : bool |
소스가 지정되면 자동으로 사운드 재생을 시작할지 여부를 결정합니다.
기본값은 true
입니다.
directivity : real |
음원의 방향성을 정의합니다. 값이 0이면 소리가 모든 방향으로 동일하게 방출되고, 값이 1이면 소스가 주로 전방 방향으로 소리를 방출한다는 의미입니다.
유효한 값은 0에서 1 사이이며 기본값은 0입니다.
directivityOrder : real |
음원의 지향성 순서를 정의합니다. 순서가 높을수록 사운드 콘의 위치가 더 선명해집니다.
이 속성의 최소값과 기본값은 1입니다.
distanceCutoff : real |
소스에서 나오는 소리가 차단되는 거리를 정의합니다. 청취자가 차단 거리보다 사운드 오브젝트에서 멀리 떨어져 있으면 더 이상 소리가 들리지 않습니다.
distanceModel : enumeration |
청취자와의 거리에 따라 소리의 볼륨을 조절하는 방법을 정의합니다. 볼륨은 size 에서 distanceCutoff 로 축소되기 시작합니다. 크기보다 작은 거리에서는 볼륨이 일정하고 컷오프 거리보다 큰 거리에서는 볼륨이 0이 됩니다.
속성 값 | 설명 |
---|---|
로그 | 음량이 거리에 따라 대수적으로 감소합니다. |
선형 | 선형 - 거리에 따라 볼륨이 선형적으로 감소합니다. |
수동 감쇠 | 감쇠는 manualAttenuation 속성을 사용하여 수동으로 정의합니다. |
loops : int |
플레이어가 멈추기 전에 사운드가 재생되는 빈도를 결정합니다. 현재 사운드를 영원히 반복하려면 SpatialSound::Infinite로 설정합니다.
기본값은 1
입니다.
manualAttenuation : real |
distanceModel 이 SpatialSound.ManualAttenuation 으로 설정된 경우 수동 감쇠 계수를 정의합니다.
nearFieldGain : real |
음원의 근거리 필드 게인을 정의합니다. 유효한 값은 0에서 1 사이입니다. 근거리 필드 게인이 1이면 청취자와 매우 가까운 거리에서 사운드 신호의 볼륨이 약 20dB 높아집니다.
occlusionIntensity : real |
객체가 가려지는 정도를 정의합니다. 0은 개체가 전혀 가려지지 않음을 의미하며, 숫자가 클수록 가려짐이 크다는 뜻입니다.
기본값은 0입니다.
size : real |
음원의 크기를 정의합니다. 리스너가 크기보다 사운드 오브젝트에 더 가까이 있으면 볼륨이 일정하게 유지됩니다. 이 크기는 큰 소스가 벽에 의해 부분적으로 가려질 수 있는 오클루전 계산에도 사용됩니다.
source : url |
재생할 사운드의 소스 파일입니다.
volume : real |
이 음원의 전체 볼륨을 정의합니다.
0에서 1 사이의 값은 사운드를 감쇠시키고, 1을 초과하는 값은 추가적인 게인 부스트를 제공합니다.
메서드 문서
pause() |
현재 위치에서 사운드 재생을 일시 중지합니다. play ()를 호출하면 재생이 계속됩니다.
play() |
사운드 재생을 시작합니다. 사운드가 이미 재생 중이면 아무 작업도 수행하지 않습니다.
stop() |
사운드 재생을 중지하고 현재 위치와 루프 횟수를 0으로 초기화합니다. play()를 호출하면 사운드 파일의 시작 부분에서 재생이 시작됩니다.
© 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.