QSoundEffect Class

QSoundEffect effect;
effect.setSource(QUrl::fromLocalFile("engine.wav"));
effect.setLoopCount(QSoundEffect::Infinite);
effect.setVolume(0.25f);
effect.play();

    MyGame()
        : m_explosion(this)
    {
        m_explosion.setSource(QUrl::fromLocalFile("explosion.wav"));
        m_explosion.setVolume(0.25f);

        // Set up click handling etc.
        connect(clickSource, &QPushButton::clicked, &m_explosion, &QSoundEffect::play);
    }
private:
    QSoundEffect m_explosion;

멤버 함수 설명서

[explicit] QSoundEffect::QSoundEffect(QObject *parent = nullptr)

지정된 ` parent`을 사용하여 `QSoundEffect`를 생성합니다.

[explicit] QSoundEffect::QSoundEffect(const QAudioDevice &audioDevice, QObject *parent = nullptr)

지정된 ` audioDevice ` 및 ` parent`을 사용하여 `QSoundEffect`를 생성합니다.

[override virtual noexcept] QSoundEffect::~QSoundEffect()

이 음향 효과를 제거합니다.

bool QSoundEffect::isLoaded() const

사운드 효과의 로딩이 완료되었는지 여부를 반환합니다. source()

bool QSoundEffect::isMuted() const

이 음향 효과가 음소거되어 있는지 여부를 반환합니다.

bool QSoundEffect::isPlaying() const

현재 음향 효과가 재생 중이면 true를 반환하고, 그렇지 않으면 false를 반환합니다.

[signal] void QSoundEffect::loadedChanged()

로딩 상태가 변경되면 ‘ loadedChanged ’ 신호가 전송됩니다.

int QSoundEffect::loopCount() const

이 음향 효과가 재생이 중단되기 전까지 재생될 총 횟수를 반환합니다.

현재 남은 반복 횟수를 확인하려면 loopsRemaining() 메서드를 참조하십시오.

setLoopCount()도 참조하십시오 .

[signal] void QSoundEffect::loopCountChanged()

loopCountChanged 신호는 초기 루프 횟수가 변경되었을 때 발생합니다.

[signal] void QSoundEffect::loopsRemainingChanged()

loopsRemainingChanged 신호는 남은 루프 횟수가 변경되었을 때 발생합니다.

[signal] void QSoundEffect::mutedChanged()

mutedChanged 신호는 음소거 상태가 변경되었을 때 발생합니다.

[slot] void QSoundEffect::play()

음향 효과의 재생을 시작하고, loops 속성에 지정된 횟수만큼 효과를 반복합니다.

[signal] void QSoundEffect::playingChanged()

playingChanged 신호는 playing 속성이 변경되었을 때 발생합니다.

void QSoundEffect::setLoopCount(int loopCount)

이 음향 효과의 총 재생 횟수를 ` loopCount`로 설정합니다.

루프 횟수를 0 또는 1로 설정하면 사운드 효과가 한 번만 재생되며, QSoundEffect::Infinite 을 전달하면 무한히 반복됩니다. 사운드 효과가 재생 중일 때 루프 횟수를 변경할 수 있으며, 이 경우 남은 루프 횟수가 새로운 loopCount 로 업데이트됩니다.

loopCount() 및 loopsRemaining()도 참조하십시오 .

void QSoundEffect::setMuted(bool muted)

이 음향 효과의 재생을 음소거할지 여부를 설정합니다.

muted 가 true인 경우 재생이 음소거(소리가 나지 않게)되며, 그렇지 않은 경우 현재 지정된 volume()에 따라 재생됩니다.

isMuted()도 참조하십시오 .

void QSoundEffect::setSource(const QUrl &url)

재생할 현재 URL을 url 로 설정합니다.

source()도 참조하십시오 .

void QSoundEffect::setVolume(float volume)

음향 효과 볼륨을 volume 로 설정합니다.

볼륨은 0.0 (무음)에서 1.0 (최대 볼륨)까지 선형적으로 조정됩니다. 이 범위 밖의 값은 제한됩니다.

기본 볼륨은 1.0 입니다.

UI 음량 컨트롤은 일반적으로 비선형적으로 스케일링되어야 합니다. 예를 들어, 로그 스케일을 사용하면 지각되는 음량이 선형적으로 변화하는데, 이는 사용자가 음량 컨트롤에서 일반적으로 기대하는 바입니다. 자세한 내용은 QtAudio::convertVolume()을 참조하십시오.

volume()도 참조하십시오 .

QUrl QSoundEffect::source() const

재생 중인 소스의 URL을 반환합니다.

setSource()도 참조하십시오 .

[signal] void QSoundEffect::sourceChanged()

sourceChanged 신호는 소스가 변경되었을 때 발생합니다.

QSoundEffect::Status QSoundEffect::status() const

이 사운드 효과의 현재 상태를 반환합니다.

[signal] void QSoundEffect::statusChanged()

statusChanged 신호는 status 속성이 변경되었을 때 발생합니다.

[slot] void QSoundEffect::stop()

현재 재생 중인 콘텐츠를 중지합니다.

[static] QStringList QSoundEffect::supportedMimeTypes()

이 플랫폼에서 지원되는 MIME 유형 목록을 반환합니다.

float QSoundEffect::volume() const

이 음향 효과의 현재 음량을 0.0(무음)에서 1.0(최대 음량) 사이의 값으로 반환합니다.

참조: ` setVolume()` 함수.

[signal] void QSoundEffect::volumeChanged()

volumeChanged 신호는 볼륨이 변경되었을 때 발생합니다.