AudioBox.h

Go to the documentation of this file.

// Copyright 2015 - 2026, GIBIS-UNIFESP and the wiRedPanda contributors
// SPDX-License-Identifier: GPL-3.0-or-later

 
#pragma once
 
#include <QAudioOutput>
#include <QFileInfo>
#include <QMediaPlayer>
 
#include "App/Element/GraphicElements/AudioOutputElement.h"

class AudioBox : public AudioOutputElement
{
    Q_OBJECT
 
public:
    static constexpr const char *kDefaultAudioPath = ":/Components/Output/Audio/wiredpanda.wav";

    explicit AudioBox(QGraphicsItem *parent = nullptr);

    AudioBox(const AudioBox &other) : AudioBox(other.parentItem()) {}
 
    // --- State Queries ---

    QString audio() const override;
 
    // --- Playback Control ---

    void setAudio(const QString &audioPath) override;
 
    // --- External file dependencies ---

    QStringList externalFiles() const override;
 
    // --- Serialization ---

    void load(QDataStream &stream, SerializationContext &context) override;
    void save(QDataStream &stream, SerializationOptions options) const override;
 
protected:
    // --- AudioOutputElement hooks ---
 
    void startAudio() override;
    void stopAudio() override;
    void applyVolume() override;
    void applyMute() override;
 
private:
    QAudioOutput *m_audioOutput = nullptr;
    QFileInfo m_audio;
    QMediaPlayer *m_player = nullptr;
};