Revision control
++ // Copyright (C) 2022 The Qt Company Ltd.
++ // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-3.0-only
++
++ #include "qambientsound.h"
++
++ #include <QtSpatialAudio/private/qaudioengine_p.h>
++ #include <QtSpatialAudio/private/qspatialaudiosound_p.h>
++ #include <QtCore/qdebug.h>
++ #include <QtCore/qurl.h>
++
++ #include <resonance_audio.h>
++
++ #include <memory>
++
++ QT_BEGIN_NAMESPACE
++
++ namespace {
++
++ int addStereoSource(QAudioEngine *engine)
++ {
++ auto *ep = QAudioEnginePrivate::get(engine);
++ if (!ep)
++ return -1;
++ return ep->resonanceAudio->api->CreateStereoSource(2);
++ }
++
++ } // namespace
++
++ class QAmbientSoundPrivate final : public QSpatialAudioSoundPrivate
++ {
++ Q_DECLARE_PUBLIC(QAmbientSound)
++
++ public:
++ explicit QAmbientSoundPrivate(QAudioEngine *engine);
++ };
++
++ QAmbientSoundPrivate::QAmbientSoundPrivate(QAudioEngine *engine)
++ : QSpatialAudioSoundPrivate{
++ engine,
++ 2,
++ addStereoSource(engine),
++ }
++ {
++ QSpatialAudioSoundPrivate::applyVolume();
++ }
++
++ /*!
++ \class QAmbientSound
++ \inmodule QtSpatialAudio
++ \ingroup spatialaudio
++ \ingroup multimedia_audio
++
++ \brief A stereo overlay sound.
++
++ QAmbientSound represents a position and orientation independent sound.
++ It's commonly used for background sounds (e.g. music) that is supposed to be independent
++ of the listeners position and orientation.
++
++ \note QAmbientSound is only active when the QAudioEngine is using OutputMode::Stereo or
++ OutputMode::Headphone.
++ */
++
++ /*!
++ Creates a stereo sound source for \a engine.
++
++ \note Must be called with a valid QAudioEngine
++ */
++ QAmbientSound::QAmbientSound(QAudioEngine *engine) : QObject(*new QAmbientSoundPrivate(engine))
++ {
++ if (!engine)
++ qWarning() << "Cannot create QAmbientSound without a valid QAudioEngine";
++ }
++
++ QAmbientSound::~QAmbientSound()
++ {
++ Q_D(QAmbientSound);
++ if (d->state() != QSpatialAudioSoundPrivate::State::Stopped)
++ d->stop();
++ }
++
++ /*!
++ \property QAmbientSound::volume
++
++ Defines the volume of the sound.
++
++ Values between 0 and 1 will attenuate the sound, while values above 1
++ provide an additional gain boost.
++ */
++ void QAmbientSound::setVolume(float volume)
++ {
++ Q_D(QAmbientSound);
++ if (volume != d->volume()) {
++ d->setVolume(volume);
++ Q_EMIT volumeChanged();
++ }
++ }
++
++ float QAmbientSound::volume() const
++ {
++ Q_D(const QAmbientSound);
++ return d->volume();
++ }
++
++ void QAmbientSound::setSource(const QUrl &url)
++ {
++ Q_D(QAmbientSound);
++ if (d->url() == url)
++ return;
++ d->loadUrl(url);
++
++ Q_EMIT sourceChanged();
++ }
++
++ /*!
++ \property QAmbientSound::source
++
++ The source file for the sound to be played.
++ */
++ QUrl QAmbientSound::source() const
++ {
++ Q_D(const QAmbientSound);
++ return d->url();
++ }
++ /*!
++ \enum QAmbientSound::Loops
++
++ Lets you control the playback loop using the following values:
++
++ \value Infinite Loops infinitely
++ \value Once Stops playback after running once
++ */
++ /*!
++ \property QAmbientSound::loops
++
++ Determines how many times the sound is played before the player stops.
++ Set to QAmbientSound::Infinite to play the current sound in
++ a loop forever.
++
++ The default value is \c 1.
++ */
++ int QAmbientSound::loops() const
++ {
++ Q_D(const QAmbientSound);
++ return d->loops();
++ }
++
++ void QAmbientSound::setLoops(int loops)
++ {
++ Q_D(QAmbientSound);
++ if (loops != d->loops()) {
++ d->setLoops(loops);
++ Q_EMIT loopsChanged();
++ }
++ }
++
++ /*!
++ \property QAmbientSound::autoPlay
++
++ Determines whether the sound should automatically start playing when a source
++ gets specified.
++
++ The default value is \c true.
++ */
++ bool QAmbientSound::autoPlay() const
++ {
++ Q_D(const QAmbientSound);
++ return d->autoPlay();
++ }
++
++ void QAmbientSound::setAutoPlay(bool autoPlay)
++ {
++ Q_D(QAmbientSound);
++ if (autoPlay != d->autoPlay()) {
++ d->setAutoPlay(autoPlay);
++ Q_EMIT autoPlayChanged();
++ }
++ }
++
++ /*!
++ Starts playing back the sound. Does nothing if the sound is already playing.
++ */
++ void QAmbientSound::play()
++ {
++ Q_D(QAmbientSound);
++ d->play();
++ }
++
++ /*!
++ Pauses sound playback. Calling play() will continue playback.
++ */
++ void QAmbientSound::pause()
++ {
++ Q_D(QAmbientSound);
++ d->pause();
++ }
++
++ /*!
++ Stops sound playback and resets the current position and current loop count to 0.
++ Calling play() will start playback at the beginning of the sound file.
++ */
++ void QAmbientSound::stop()
++ {
++ Q_D(QAmbientSound);
++ d->stop();
++ }
++
++ /*!
++ Returns the engine associated with this sound.
++ */
++ QAudioEngine *QAmbientSound::engine() const
++ {
++ Q_D(const QAmbientSound);
++
++ return d->engine;
++ }
++
++ QT_END_NAMESPACE
++
++ #include "moc_qambientsound.cpp"