QAudioSource Class

QFile destinationFile ; // Membre de la classeQAudioSource* audio ; // Membre de la classe{ destinationFile.setFileName("/tmp/test.raw") ; destinationFile.open( QIODevice::WriteOnly | :: Truncate QIODevice::Truncate ) ; QAudioFormat format ; // Configure le format souhaité, par exemple :format.setSampleRate(44100) ; format.setChannelCount(1) ; format.setSampleFormat(QAudioFormat::Int16) ; QAudioDevice info = QMediaDevices::defaultAudioInput() ; if (!info.isFormatSupported(format)) {        qWarning() << "Default format not supported, trying to use the nearest.";
    } audio = new QAudioSource(format, this) ; connect(audio, &QAudioSource::stateChanged, this, &AudioInputExample::handleStateChanged) ; QTimer::singleShot(3000, this, &AudioInputExample::stopRecording) ;  audio->start(&destinationFile) ; // Enregistre l'audio pendant 3000ms}

void AudioInputExample::stopRecording()
{
    audio->stop();
    destinationFile.close();
    delete audio;
}

QAudioSource* audio ; // membre de la classe.std::atomic<float> peakLevel ; // membre de la classe.{ QAudioFormat format ; // Configure le format, par exempleformat.setSampleRate(44100) ; format.setChannelCount(2) ; format.setSampleFormat(QAudioFormat::Float) ; QAudioDevice info(QMediaDevices::defaultAudioOutput()) ; if (!info.isFormatSupported(format)) {        qWarning() << "Raw audio format not supported by backend, cannot capture audio.";
       return; } audio = new QAudioSource(format, this) ;  audio->start([&peakLevel] (QSpan<float> interleavedAudioBuffer) { float level = peakLevel.load() ; for(float sample : interleavedAudioBuffer) { // Calculer le niveau de crête à partir des échantillons audiolevel = std::max(level, std::abs(sample)) ; } peakLevel.store(level) ; // Note : il faut faire attention si le thread de l'application doit être notifié, car le // callback audio ne doit pas utiliser d'appels système potentiellement bloquants.
        //  De bonnes options sont autoreset events (windows), eventfd (linux) ou kqueue/EVFILT_USER sur macos.}) ; if (!audio->error() == QtAudio::Error::NoError) { // en plus des autres signatures de start(), le démarrage du callback audio échouera si // * le backend n'implémente pas l'IO basé sur le callback (l'API est disponible sur toutes les // plateformes  majeures ) // * la signature du callback audio ne correspond pas à format.sampleFormat()
        qWarning() << "Error starting audio output:" << audio->errorString();
    } }

void AudioInputExample::handleStateChanged(QtAudio::State newState)
{
    switch (newState) {
        case QtAudio::StoppedState:
            if (audio->error() != QtAudio::NoError) {
                // Error handling
            } else {
                // Finished recording
            }
            break;

        case QtAudio::ActiveState:
            // Started recording - read from IO device
            break;

        default:
            // ... other cases as appropriate
            break;
    }
}

Documentation sur les fonctions membres

[explicit] QAudioSource::QAudioSource(const QAudioFormat &format = QAudioFormat(), QObject *parent = nullptr)

Construire une nouvelle entrée audio et l'attacher à parent. Le périphérique d'entrée audio par défaut est utilisé avec les paramètres de sortie format. Si format est initialisé par défaut, le format sera défini sur le format préféré du périphérique audio.

[explicit] QAudioSource::QAudioSource(const QAudioDevice &audioDevice, const QAudioFormat &format = QAudioFormat(), QObject *parent = nullptr)

Construire une nouvelle entrée audio et l'attacher à parent. Le périphérique référencé par audioDevice est utilisé avec les paramètres de l'entrée format. Si format est initialisé par défaut, le format sera défini sur le format préféré de audioDevice.

[override virtual noexcept] QAudioSource::~QAudioSource()

Détruire cette entrée audio.

qsizetype QAudioSource::bufferFrameCount() const

Renvoie la taille du tampon audio en images.

Si elle est appelée avant start(), elle renvoie la valeur par défaut de la plate-forme. Si elle est appelée avant start() mais que setBufferSize() ou setBufferFrameCount() a été appelé avant, elle renvoie la valeur définie par setBufferSize() ou setBufferFrameCount(). Si elle est appelée après start(), elle renvoie la taille réelle de la mémoire tampon utilisée. Cette valeur peut être différente de celle définie précédemment par setBufferSize() ou setBufferFrameCount().

Voir également setBufferFrameCount() et bufferSize.

[since 6.10] qsizetype QAudioSource::bufferSize() const

Renvoie la taille du tampon audio en octets.

Si elle est appelée avant start(), elle renvoie la valeur par défaut de la plate-forme. Si elle est appelée avant start() mais que setBufferSize() ou setBufferFrameCount() a été appelé avant, elle renvoie la valeur définie par setBufferSize() ou setBufferFrameCount(). Si elle est appelée après start(), elle renvoie la taille réelle de la mémoire tampon utilisée. Cette valeur peut être différente de celle définie précédemment par setBufferSize() ou setBufferFrameCount().

Cette fonction a été introduite dans Qt 6.10.

Voir aussi setBufferSize() et bufferFrameCount.

qsizetype QAudioSource::bytesAvailable() const

Renvoie la quantité de données audio disponibles à la lecture en octets.

Voir aussi framesAvailable.

qint64 QAudioSource::elapsedUSecs() const

Renvoie les microsecondes écoulées depuis l'appel de start(), y compris le temps passé en état de veille et de suspension.

QtAudio::Error QAudioSource::error() const

Renvoie l'état d'erreur.

QAudioFormat QAudioSource::format() const

Renvoie l'adresse QAudioFormat utilisée.

[since 6.10] qsizetype QAudioSource::framesAvailable() const

Renvoie la quantité de données audio disponibles pour la lecture en images.

Remarque : la valeur renvoyée n'est valable que dans l'état QtAudio::ActiveState ou QtAudio::IdleState, sinon elle renvoie zéro.

Cette fonction a été introduite dans Qt 6.10.

Voir aussi bytesAvailable.

bool QAudioSource::isNull() const

Renvoie true si la source audio est null, sinon renvoie false.

qint64 QAudioSource::processedUSecs() const

Renvoie la quantité de données audio traitées depuis que start() a été appelé, en microsecondes.

void QAudioSource::reset()

Abandonne toutes les données audio dans les tampons, remet les tampons à zéro.

void QAudioSource::resume()

Reprend le traitement des données audio après un appel à suspend().

Fixe state() à l'état que le récepteur avait lorsque suspend() a été appelé. Cette fonction ne fait rien si l'état du récepteur audio n'est pas QtAudio::SuspendedState.

void QAudioSource::setBufferFrameCount(qsizetype value)

Définit la taille de la mémoire tampon audio à value en nombre d'images.

Voir aussi bufferFrameCount() et setBufferSize.

[since 6.10] void QAudioSource::setBufferSize(qsizetype value)

Fixe la taille de la mémoire tampon audio à value bytes.

Cette fonction a été introduite dans Qt 6.10.

Voir aussi bufferSize() et setBufferFrameCount.

void QAudioSource::setVolume(qreal volume)

Règle le volume d'entrée sur volume.

Le volume est échelonné linéairement de 0.0 (silence) à 1.0 (plein volume). Les valeurs en dehors de cette plage seront bloquées.

Si l'appareil ne permet pas de régler le volume d'entrée, volume sera ignoré et le volume d'entrée restera à 1,0.

Le volume par défaut est 1.0.

Voir aussi volume().

QIODevice *QAudioSource::start()

Renvoie un pointeur vers l'adresse interne QIODevice utilisée pour transférer les données de l'entrée audio du système. Le périphérique sera déjà ouvert et read() pourra lire les données directement à partir de celui-ci.

Si QAudioSource peut accéder au périphérique audio du système, state() renvoie QtAudio::IdleState, error() renvoie QtAudio::NoError et le signal stateChanged() est émis.

Si un problème survient au cours de ce processus, error() renvoie QtAudio::OpenError, state() renvoie QtAudio::StoppedState et le signal stateChanged() est émis.

Voir également QIODevice et QIODevice interface.

[since 6.11] template <typename Callback, QtAudio::if_audio_source_callback<Callback> = true> void QAudioSource::start(Callback &&cb)

Démarre le QAudioSource avec une fonction de rappel qui sera appelée sur un thread audio en temps réel. La fonction de rappel est un appelable qui prend en argument QSpan<const SampleType>, SampleType devant correspondre à QAudioFormat::SampleFormat du format de QAudioSource. Le span contient les données audio entrelacées.

Si QAudioSource est capable de démarrer avec succès, error() renvoie QtAudio::NoError.

Si un problème survient au cours de ce processus, error() renvoie QtAudio::OpenError, state() renvoie QtAudio::StoppedState et le signal stateChanged() est émis.

Cette fonction a été introduite dans Qt 6.11.

Voir aussi Callback interface.

void QAudioSource::start(QIODevice *device)

Commence à transférer les données audio de l'entrée audio du système vers le site device. Le site device doit avoir été ouvert dans les modes WriteOnly, Append ou ReadWrite.

Si QAudioSource parvient à obtenir des données audio, state() renvoie QtAudio::ActiveState ou QtAudio::IdleState, error() renvoie QtAudio::NoError et le signal stateChanged() est émis.

Si un problème survient au cours de ce processus, error() renvoie QtAudio::OpenError, state() renvoie QtAudio::StoppedState et le signal stateChanged() est émis.

Voir également QIODevice et QIODevice interface.

QtAudio::State QAudioSource::state() const

Renvoie l'état du traitement audio.

[signal] void QAudioSource::stateChanged(QtAudio::State state)

Ce signal est émis lorsque le périphérique state a changé.

void QAudioSource::stop()

Arrête l'entrée audio, en se détachant de la ressource système.

Définit error() en QtAudio::NoError, state() en QtAudio::StoppedState et émet le signal stateChanged().

void QAudioSource::suspend()

Arrête le traitement des données audio, en préservant les données audio mises en mémoire tampon.

Définit error() sur QtAudio::NoError, state() sur QtAudio::SuspendedState et émet le signal stateChanged().

qreal QAudioSource::volume() const

Renvoie le volume d'entrée.

Si l'appareil ne permet pas de régler le volume d'entrée, la valeur renvoyée sera 1.0.

Voir aussi setVolume().