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

사운드 효과가 현재 재생 중이면 참을 반환하고, 그렇지 않으면 거짓을 반환합니다.

[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()

사운드 효과 재생을 시작하여 루프 속성에 지정된 횟수만큼 효과를 반복합니다.

[signal] void QSoundEffect::playingChanged()

playingChanged 신호는 재생 중인 프로퍼티가 변경되면 발신됩니다.

void QSoundEffect::setLoopCount(int loopCount)

이 사운드 효과를 재생할 총 횟수를 loopCount 으로 설정합니다.

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

loopCount() 및 loopsRemaining()도 참조하세요 .

void QSoundEffect::setMuted(bool muted)

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

muted 이 참이면 재생이 음소거(무음)되고, 그렇지 않으면 현재 지정된 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 신호가 전송됩니다.

[slot] void QSoundEffect::stop()

현재 재생을 중지합니다.

[static] QStringList QSoundEffect::supportedMimeTypes()

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

float QSoundEffect::volume() const

이 사운드 효과의 현재 볼륨을 0.0(무음)에서 1.0(최대 볼륨)까지 반환합니다.

setVolume()도 참조하세요 .

[signal] void QSoundEffect::volumeChanged()

volumeChanged 신호는 볼륨이 변경되면 발신됩니다.