QAudioDecoder Class

Member Function Documentation

[explicit] QAudioDecoder::QAudioDecoder(QObject *parent = nullptr)

Construire une instance de QAudioDecoder avec parent.

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

Détruit l'objet décodeur audio.

QAudioFormat QAudioDecoder::audioFormat() const

Renvoie le format audio sur lequel le décodeur est réglé.

Voir aussi setAudioFormat() et formatChanged().

bool QAudioDecoder::bufferAvailable() const

Retourne true si un tampon est disponible pour être lu, et false dans le cas contraire. S'il n'y a pas de tampon disponible, l'appel à la fonction read() renverra un tampon non valide.

[signal] void QAudioDecoder::bufferAvailableChanged(bool available)

Signale la disponibilité (si available est vrai) d'un nouveau tampon.

Si available est faux, aucun tampon n'est disponible.

Voir également bufferAvailable() et bufferReady().

[signal] void QAudioDecoder::bufferReady()

Signale qu'un nouveau tampon audio décodé peut être lu.

Voir aussi read() et bufferAvailable().

qint64 QAudioDecoder::duration() const

Renvoie la durée totale (en millisecondes) du flux audio ou -1 si elle n'est pas disponible.

[signal] void QAudioDecoder::durationChanged(qint64 duration)

Signale que l'estimation de duration des données décodées a changé.

Voir également positionChanged().

QAudioDecoder::Error QAudioDecoder::error() const

Renvoie l'état d'erreur actuel du site QAudioDecoder.

[signal] void QAudioDecoder::error(QAudioDecoder::Error error)

Signale qu'une condition error s'est produite.

// Connect using qOverload:
connect(audioDecoder, qOverload(&QAudioDecoder::error),
        receiver, &ReceiverClass::slot);

// Or using a lambda:
connect(audioDecoder, qOverload(&QAudioDecoder::error),
        this, [](QAudioDecoder::Error error) { /* handle error */ });

Voir aussi errorString().

[signal] void QAudioDecoder::finished()

Signale que le décodage s'est terminé avec succès. Si le décodage échoue, un signal d'erreur est émis à la place.

Voir aussi start(), stop() et error().

[signal] void QAudioDecoder::formatChanged(const QAudioFormat &format)

Signale que le format audio actuel du décodeur est passé à format.

Voir également audioFormat() et setAudioFormat().

bool QAudioDecoder::isSupported() const

Retourne true si le décodage audio est pris en charge sur cette plateforme.

qint64 QAudioDecoder::position() const

Renvoie la position (en millisecondes) du dernier tampon lu par le décodeur ou -1 si aucun tampon n'a été lu.

[signal] void QAudioDecoder::positionChanged(qint64 position)

Signale que le site position du décodeur a changé.

Voir également durationChanged().

QAudioBuffer QAudioDecoder::read() const

Lire un tampon à partir du décodeur, s'il y en a un de disponible. Renvoie un tampon invalide s'il n'y a pas de tampons décodés actuellement disponibles, ou en cas d'échec. Dans les deux cas, cette fonction ne bloque pas.

Vous devez répondre au signal bufferReady() ou vérifier la fonction bufferAvailable() avant d'appeler read() pour être sûr d'obtenir des données utiles.

void QAudioDecoder::setAudioFormat(const QAudioFormat &format)

Réglez le format audio souhaité pour les échantillons décodés sur format.

Cette propriété ne peut être définie que lorsque le décodeur est arrêté. La définition de cette propriété à d'autres moments sera ignorée.

Si le décodeur ne prend pas en charge ce format, error() sera réglé sur FormatError.

Si vous ne spécifiez pas de format, le format de l'audio décodé sera utilisé. Dans le cas contraire, une conversion de format sera appliquée.

Si vous souhaitez réinitialiser le format décodé à celui du fichier audio d'origine, vous pouvez spécifier une adresse invalide format.

Voir aussi audioFormat().

void QAudioDecoder::setSource(const QUrl &fileName)

Définit le nom du fichier audio actuel à fileName.

Lorsque cette propriété est définie, tout décodage en cours est arrêté et les tampons audio sont supprimés.

Vous ne pouvez spécifier qu'un nom de fichier source ou une source QIODevice. La définition de l'un désactivera l'autre.

Voir également source().

void QAudioDecoder::setSourceDevice(QIODevice *device)

Définit l'audio actuel QIODevice à device.

Lorsque cette propriété est définie, tout décodage en cours est arrêté et les tampons audio sont supprimés.

Vous ne pouvez spécifier qu'un nom de fichier source ou une source QIODevice. La définition de l'un désactivera l'autre.

Voir également sourceDevice().

QUrl QAudioDecoder::source() const

Renvoie le nom du fichier à décoder. Si setSourceDevice a été appelé, ce nom sera vide.

Voir aussi setSource().

[signal] void QAudioDecoder::sourceChanged()

Signale que la source de courant du décodeur a changé.

Voir également source() et sourceDevice().

QIODevice *QAudioDecoder::sourceDevice() const

Renvoie la source courante QIODevice, si elle a été définie. Si setSource() a été appelé, ce sera une nullptr.

Voir aussi setSourceDevice().

[slot] void QAudioDecoder::start()

Démarre le décodage de la ressource audio.

Au fur et à mesure que les données sont décodées, le signal bufferReady() est émis lorsque suffisamment de données ont été décodées. L'appel à read() renvoie alors un tampon audio sans blocage.

Si vous appelez read() avant qu'un tampon ne soit prêt, un tampon invalide sera renvoyé, toujours sans blocage.

Voir aussi read().

[slot] void QAudioDecoder::stop()

Arrête le décodage audio. Si vous appelez à nouveau start(), le décodage reprendra depuis le début.