Revision control
++ // Copyright (C) 2026 The Qt Company Ltd.
++ // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-3.0-only
++
++ #ifndef QSPATIALAUDIOSOUND_P_H
++ #define QSPATIALAUDIOSOUND_P_H
++
++ //
++ // W A R N I N G
++ // -------------
++ //
++ // This file is not part of the Qt API. It exists for the convenience
++ // of other Qt classes. This header file may change from version to
++ // version without notice, or even be removed.
++ //
++ // We mean it.
++ //
++
++ #include <QtSpatialAudio/private/qtspatialaudioglobal_p.h>
++ #include <QtMultimedia/qaudiobuffer.h>
++ #include <QtMultimedia/qaudioformat.h>
++ #include <QtMultimedia/private/qmultimedia_source_resolver_p.h>
++ #include <QtMultimedia/private/qsamplecache_p.h>
++ #include <QtCore/qfuture.h>
++ #include <QtCore/qurl.h>
++ #include <QtCore/private/qobject_p.h>
++
++ #include <atomic>
++ #include <memory>
++
++ namespace vraudio {
++ class ResonanceAudioApi;
++ }
++
++ QT_BEGIN_NAMESPACE
++
++ class QAudioEngine;
++ class QQuick3DSpatialSound;
++ class QQuick3DAmbientSound;
++
++ namespace QSpatialAudioPrivate {
++
++ class QSpatialAudioPlaybackState
++ {
++ public:
++ explicit QSpatialAudioPlaybackState(QAudioBuffer buffer, bool playing, int loops);
++
++ void getBuffer(QSpan<float> output);
++
++ void pause();
++ void resume();
++ void setLoops(int);
++
++ QAudioFormat format() const;
++
++ private:
++ // controls
++ std::atomic_bool m_playing = false;
++ std::atomic_int m_loops = 1;
++
++ // state
++ int m_currentSample = 0;
++ int m_currentLoop = 0;
++
++ const QAudioBuffer m_buffer;
++ };
++
++ } // namespace QSpatialAudioPrivate
++
++ class QSpatialAudioSoundPrivate : public QObjectPrivate
++ {
++ public:
++ QSpatialAudioSoundPrivate(QAudioEngine *engine, int nchannels, int sourceId);
++ ~QSpatialAudioSoundPrivate();
++
++ QUrl url() const { return m_url; }
++ void loadUrl(const QUrl &url);
++
++ void setVolume(float volume);
++ float volume() const { return m_volume; }
++
++ int loops() const { return m_loops; }
++ void setLoops(int);
++ bool autoPlay() const { return m_autoPlay; }
++ void setAutoPlay(bool);
++
++ virtual void updateRoomEffects() { }
++
++ void play();
++ void pause();
++ void stop();
++
++ const int nchannels = 2;
++ QAudioEngine *const engine;
++ const int sourceId;
++
++ enum class State : uint8_t {
++ Stopped,
++ Playing,
++ Paused,
++ };
++ State state() const { return m_state; }
++
++ protected:
++ template <typename Functor>
++ auto withResonanceApi(Functor &&f)
++ {
++ auto *api = getAPI();
++ if (api)
++ f(api);
++ else {
++ using result = std::invoke_result_t<Functor, vraudio::ResonanceAudioApi *>;
++ if constexpr (std::is_void_v<result>)
++ return;
++ else
++ return result{ };
++ }
++ }
++
++ virtual void applyVolume();
++
++ private:
++ State m_state = State::Stopped;
++ bool m_autoPlay = true;
++
++ float m_volume = 1.f;
++ int m_loops = 1;
++
++ SharedSamplePtr m_sample;
++ std::optional<QAudioBuffer> m_buffer;
++ QFuture<void> m_loadFuture;
++
++ QUrl m_url; // unresolved URL
++ using AbstractSourceResolver = QMultimediaPrivate::AbstractSourceResolver;
++ using TrivialSourceResolver = QMultimediaPrivate::TrivialSourceResolver;
++
++ friend class QQuick3DSpatialSound;
++ friend class QQuick3DAmbientSound;
++ std::unique_ptr<const AbstractSourceResolver> m_sourceResolver =
++ std::make_unique<TrivialSourceResolver>();
++
++ vraudio::ResonanceAudioApi *getAPI();
++
++ // playback state
++ using QSpatialAudioPlaybackState = QSpatialAudioPrivate::QSpatialAudioPlaybackState;
++ using SharedPlaybackState = std::shared_ptr<QSpatialAudioPrivate::QSpatialAudioPlaybackState>;
++ SharedPlaybackState m_playbackState;
++
++ void setState(SharedPlaybackState);
++ };
++
++ QT_END_NAMESPACE
++
++ #endif // QSPATIALAUDIOSOUND_P_H