QAudioSink Class

QFile sourceFile ; // membre de la classe.QAudioSink* audio ; // membre de la classe.{ sourceFile.setFileName("/tmp/test.raw") ; sourceFile.open(QIODevice::ReadOnly) ; QAudioFormat format ; // Configure le format, par exempleformat.setSampleRate(44100) ; format.setChannelCount(1) ; format.setSampleFormat(QAudioFormat::Int16) ; QAudioDevice info(QMediaDevices::defaultAudioOutput()) ; if (!info.isFormatSupported(format)) {        qWarning() << "Raw audio format not supported by backend, cannot play audio.";
       return; } audio = new QAudioSink(format, this) ; connect(audio, QAudioSink::stateChanged, this, &AudioInputExample::handleStateChanged) ;  audio->start(&sourceFile) ; }

void AudioOutputExample::stopAudioOutput()
{
    audio->stop();
    sourceFile.close();
    delete audio;
}

QAudioSink* audio ; // membre de la classe.float phase ; // 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 play audio.";
       return; } audio = new QAudioSink(format, this) ; float phaseIncrement = 2 * M_PI * 220.0 / format.sampleRate() ; // onde sinusoïdale de 220 Hz audio->start([&phase, phaseIncrement] (QSpan<float> interleavedAudioBuffer) { // Le callback audio ne doit pas appeler de fonctions potentiellement bloquantes // Remplir le buffer audio avec une onde sinusoïdale const int sampleCount = interleavedAudioBuffer.size() / 2; // Stéréo, donc diviser par 2 for(int i = 0; i < sampleCount ; ++i) { float sample = std::sin(phase) ; interleavedAudioBuffer[i * 2] = sample ; // Canal gaucheinterleavedAudioBuffer[i * 2 + 1] = sample ; // Canal droitphase += phaseIncrement ; // Incrémenter la phase pour l'échantillon suivant} }) ; 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 AudioOutputExample::handleStateChanged(QtAudio::State newState)
{
    switch (newState) {
        case QtAudio::IdleState:
            // Finished playing (no more data)
            AudioOutputExample::stopAudioOutput();
            break;

        case QtAudio::StoppedState:
            // Stopped for other reasons
            if (audio->error() != QtAudio::NoError) {
                // Error handling
            }
            break;

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

Documentation sur les fonctions membres

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

Construire une nouvelle sortie audio et l'attacher à parent. Le périphérique de sortie 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] QAudioSink::QAudioSink(const QAudioDevice &audioDevice, const QAudioFormat &format = QAudioFormat(), QObject *parent = nullptr)

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

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

Détruit cette sortie audio.

Cette opération libère les ressources système utilisées et les mémoires tampons.

[since 6.10] qsizetype QAudioSink::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().

Cette fonction a été introduite dans Qt 6.10.

Voir aussi setBufferFrameCount() et bufferSize.

qsizetype QAudioSink::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().

Voir également setBufferSize() et bufferFrameCount.

qsizetype QAudioSink::bytesFree() const

Renvoie le nombre d'octets libres dans la mémoire tampon audio.

Voir aussi framesFree.

qint64 QAudioSink::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 QAudioSink::error() const

Renvoie l'état d'erreur.

QAudioFormat QAudioSink::format() const

Renvoie l'adresse QAudioFormat utilisée.

[since 6.10] qsizetype QAudioSink::framesFree() const

Renvoie le nombre de trames libres dans la mémoire tampon audio.

Cette fonction a été introduite dans Qt 6.10.

Voir aussi bytesFree.

bool QAudioSink::isNull() const

Renvoie true si l'instance QAudioSink est null, sinon renvoie false.

qint64 QAudioSink::processedUSecs() const

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

void QAudioSink::reset()

Arrête immédiatement la sortie audio et rejette toutes les données audio présentes dans les tampons. Toutes les données audio en attente envoyées à QIODevice sont ignorées.

Voir aussi stop().

void QAudioSink::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.

[since 6.10] void QAudioSink::setBufferFrameCount(qsizetype value)

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

Cette fonction a été introduite dans Qt 6.10.

Voir aussi bufferFrameCount() et setBufferSize.

void QAudioSink::setBufferSize(qsizetype value)

Définit la taille de la mémoire tampon audio à value en octets.

Voir aussi bufferSize() et setBufferFrameCount.

void QAudioSink::setVolume(qreal volume)

Règle le volume de sortie sur volume.

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

Le volume par défaut est 1.0.

Les commandes de volume de l'interface utilisateur doivent généralement être mises à l'échelle de manière non linéaire. Par exemple, l'utilisation d'une échelle logarithmique produira des changements linéaires dans l'intensité sonore perçue, ce qui correspond à ce qu'un utilisateur attend normalement d'une commande de volume. Voir QtAudio::convertVolume() pour plus de détails.

Voir également volume().

QIODevice *QAudioSink::start()

Renvoie un pointeur vers l'adresse interne QIODevice utilisée pour transférer des données vers la sortie audio du système. Le périphérique sera déjà ouvert et write() pourra y écrire des données directement.

Si QAudioSink est en mesure d'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_sink_callback<Callback> = true> void QAudioSink::start(Callback &&cb)

Démarre le QAudioSink 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 un QSpan<SampleType> comme argument, SampleType doit correspondre au QAudioFormat::SampleFormat du format de QAudioSink. L'intervalle doit être rempli avec des données audio entrelacées.

Si le démarrage de QAudioSink est réussi, 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 QAudioSink::start(QIODevice *device)

Lance le transfert des données audio du site device vers la sortie audio du système. Le site device doit avoir été ouvert en mode ReadOnly ou ReadWrite.

Si le site QAudioSink réussit à transmettre les données audio, state() renvoie QtAudio::ActiveState, 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 QAudioSink::state() const

Renvoie l'état du traitement audio.

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

Ce signal est émis lorsque l'appareil state a changé. Il s'agit de l'état actuel de la sortie audio.

void QAudioSink::stop()

Arrête la sortie 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().

Voir aussi reset().

void QAudioSink::suspend()

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

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

qreal QAudioSink::volume() const

Renvoie le volume compris entre 0,0 et 1,0 inclus.

Voir aussi setVolume().