SoundEffect QML Type
사운드 효과 유형은 QML에서 사운드 효과를 재생하는 방법을 제공합니다. 더 보기...
Import Statement: | import QtMultimedia |
In C++: | QSoundEffect |
속성
- loops : int
- loopsRemaining : int
- muted : bool
- playing : bool
- source : url
- status : enumeration
- volume : real
신호
- loadedChanged()
- loopCountChanged()
- loopsRemainingChanged()
- mutedChanged()
- playingChanged()
- sourceChanged()
- statusChanged()
- volumeChanged()
방법
상세 설명
이 유형을 사용하면 일반적으로 지연 시간이 짧은 비압축 오디오 파일(일반적으로 WAV 파일)을 재생할 수 있으며, 사용자 동작에 반응하는 '피드백' 유형의 사운드(예: 가상 키보드 소리, 팝업 대화 상자에 대한 긍정 또는 부정 피드백, 게임 사운드)에 적합합니다. 짧은 지연 시간이 중요하지 않은 경우, 더 다양한 미디어 형식을 지원하고 리소스를 덜 사용하는 MediaPlayer 유형을 대신 사용하는 것이 좋습니다.
일반적으로 사운드 효과를 재사용하여 모든 파싱 및 준비를 미리 완료하고 필요할 때만 트리거할 수 있도록 해야 합니다. 사운드 효과 인스턴스를 선언하고 다른 곳에서 참조할 수 있으므로 QML을 사용하면 이 작업을 쉽게 수행할 수 있습니다.
다음 예제는 마우스 클릭 시 WAV 파일을 재생합니다.
Text { text: "Click Me!"; font.pointSize: 24; width: 150; height: 50; SoundEffect { id: playSound source: "soundeffect.wav" } MouseArea { id: playArea anchors.fill: parent onPressed: { playSound.play() } } }
사운드 효과는 지연 시간이 짧은 재생을 위해 약간 더 많은 리소스를 필요로 하므로 플랫폼에서 동시에 재생되는 사운드 효과의 수를 제한할 수 있습니다.
속성 문서
loops : int |
이 속성은 사운드가 재생되는 횟수를 보유합니다. 값이 0 또는 1이면 사운드가 한 번만 재생되며, 무한 반복을 사용하려면 SoundEffect.무한으로 설정합니다.
이 값은 사운드 효과가 재생되는 동안 변경할 수 있으며, 이 경우 나머지 루프가 새 값으로 업데이트됩니다.
loopsRemaining : int |
이 속성에는 사운드 효과가 자체적으로 중지되기 전까지 남은 루프 수( loops 에서 설정된 값인 경우 SoundEffect.Infinite)가 포함됩니다.
playing : bool |
이 속성은 사운드 효과의 재생 여부를 나타냅니다.
source : url |
이 속성에는 재생할 사운드의 URL이 저장됩니다. SoundEffect 에서 소스를 로드하려면 URL이 존재해야 하며 애플리케이션에 지정된 디렉터리에 대한 읽기 권한이 있어야 합니다. 원하는 소스가 로컬 파일인 경우 URL은 절대 또는 상대( SoundEffect) 경로를 선언한 파일에 대해 지정할 수 있습니다.
status : enumeration |
이 속성은 SoundEffect 내에 열거된 SoundEffect 의 현재 상태를 나타냅니다. 가능한 상태는 아래에 나열되어 있습니다.
값 | 설명 |
---|---|
SoundEffect.Null | 소스가 설정되지 않았거나 소스가 널입니다. |
SoundEffect.Loading | SoundEffect 에서 소스를 로드하는 중입니다. |
SoundEffect.Ready | 소스가 로드되어 재생할 준비가 되었습니다. |
SoundEffect.Error | 소스를 로드하지 못하는 등 작동 중에 오류가 발생했습니다. |
volume : real |
이 속성은 음향 효과 재생의 볼륨을 유지합니다.
볼륨은 0.0
(무음)에서 1.0
(최대 볼륨)까지 선형적으로 조절됩니다. 이 범위를 벗어나는 값은 클램핑됩니다.
기본 볼륨은 1.0
입니다.
UI 볼륨 컨트롤은 일반적으로 비선형적으로 조절해야 합니다. 예를 들어 로그 스케일을 사용하면 사용자가 일반적으로 볼륨 컨트롤에서 기대할 수 있는 선형적인 음량 변화가 발생합니다. 자세한 내용은 convertVolume()를 참조하세요.
신호 문서
loadedChanged() |
loadedChanged
신호는 로딩 상태가 변경되면 발신됩니다.
참고: 해당 핸들러는 onLoadedChanged
입니다.
loopCountChanged() |
loopCountChanged
신호는 초기 루프 수가 변경되었을 때 전송됩니다.
참고: 해당 핸들러는 onLoopCountChanged
입니다.
loopsRemainingChanged() |
loopsRemainingChanged
신호는 남은 루프 수가 변경되면 전송됩니다.
참고: 해당 핸들러는 onLoopsRemainingChanged
입니다.
mutedChanged() |
mutedChanged
신호는 음소거 상태가 변경되면 전송됩니다.
참고: 해당 핸들러는 onMutedChanged
입니다.
playingChanged() |
playingChanged
신호는 재생 속성이 변경되면 전송됩니다.
참고: 해당 핸들러는 onPlayingChanged
입니다.
sourceChanged() |
sourceChanged
신호는 소스가 변경되었을 때 전송됩니다.
참고: 해당 핸들러는 onSourceChanged
입니다.
statusChanged() |
statusChanged
신호는 상태 속성이 변경되면 전송됩니다.
참고: 해당 핸들러는 onStatusChanged
입니다.
volumeChanged() |
volumeChanged
신호는 볼륨이 변경되면 전송됩니다.
참고: 해당 핸들러는 onVolumeChanged
입니다.
메서드 문서
play() |
사운드 효과의 재생을 시작하여 loops 속성에 지정된 횟수만큼 효과를 반복합니다.
SoundEffect 의 기본 메서드입니다.
SoundEffect { id: playSound source: "soundeffect.wav" } MouseArea { id: playArea anchors.fill: parent onPressed: { playSound.play() } }
stop() |
현재 재생을 중지합니다.
© 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.