audio.h

Go to the documentation of this file.

#pragma once
 
#include "fl/asset/asset.h"
#include "fl/audio/audio.h"
#include "fl/audio/audio_input.h"  // For audio::Config  // IWYU pragma: keep
#include "fl/stl/optional.h"
#include "fl/stl/shared_ptr.h"
#include "fl/stl/string.h"
#include "fl/stl/url.h"
#include "fl/stl/compiler_control.h"  // IWYU pragma: keep
#include "fl/stl/noexcept.h"
#include "fl/log/log.h"
#include "fl/ui/element.h"
#include "platforms/ui_defs.h"
 
#ifndef FASTLED_HAS_UI_AUDIO
#define FASTLED_HAS_UI_AUDIO 0
#endif
 
namespace fl {
 
#if !FASTLED_HAS_UI_AUDIO
class UIAudioImpl {
  public:
    UIAudioImpl(const fl::string& name) { FASTLED_UNUSED(name); }
    UIAudioImpl(const fl::string& name, const fl::url& url) {
        FASTLED_UNUSED(name);
        FASTLED_UNUSED(url);
    }
    UIAudioImpl(const fl::string& name, const fl::audio::Config& config) {
        FASTLED_UNUSED(name);
        FASTLED_UNUSED(config);
    }
    ~UIAudioImpl() FL_NO_EXCEPT {}
 
    audio::Sample next() {
        FL_WARN("Audio sample not implemented");
        return audio::Sample();
    }
 
    bool hasNext() {
        FL_WARN("Audio sample not implemented");
        return false;
    }
 
    // Stub method for group setting (does nothing on non-WASM platforms)
    void setGroup(const fl::string& groupName) { FASTLED_UNUSED(groupName); }
 
    // Stub: no underlying audio input on non-WASM platforms
    fl::shared_ptr<audio::IInput> audioInput() { return nullptr; }
};
#endif
 
class UIAudio : public UIElement {
  public:
    FL_NO_COPY(UIAudio)
    UIAudio(const fl::string& name) FL_NO_EXCEPT;
    UIAudio(const fl::string& name, const fl::url& url) FL_NO_EXCEPT;
    UIAudio(const fl::string& name, const fl::asset_ref& asset) FL_NO_EXCEPT;
    UIAudio(const fl::string& name, const fl::audio::Config& config) FL_NO_EXCEPT;
    ~UIAudio() FL_NO_EXCEPT;
    audio::Sample next() FL_NO_EXCEPT { return mImpl.next(); }
    bool hasNext() FL_NO_EXCEPT { return mImpl.hasNext(); }
 
    // Expose underlying audio input for FastLED.add() auto-pump
    fl::shared_ptr<audio::IInput> audioInput() FL_NO_EXCEPT { return mImpl.audioInput(); }
 
    // Returns the hardware microphone config, if one was provided.
    const fl::optional<audio::Config>& config() const FL_NO_EXCEPT { return mConfig; }
 
    // Lazily registers with CFastLED::add() on first call and returns the
    // auto-pumped audio::Processor. Subsequent calls return the cached processor.
    fl::shared_ptr<audio::Processor> processor() FL_NO_EXCEPT;
 
    // Override setGroup to also update the implementation
    void setGroup(const fl::string& groupName) FL_NO_EXCEPT override {
        UIElement::setGroup(groupName);
        // Update the implementation's group if it has the method (WASM platforms)
        mImpl.setGroup(groupName);
    }
 
  protected:
    UIAudioImpl mImpl;
    fl::optional<audio::Config> mConfig;
    fl::shared_ptr<audio::Processor> mProcessor;
};
 
} // namespace fl