QMediaPlayer Class

player = new QMediaPlayer;
audioOutput = new QAudioOutput;
player->setAudioOutput(audioOutput);
connect(player, &QMediaPlayer::positionChanged, this, &MediaExample::positionChanged);
player->setSource(QUrl::fromLocalFile("/Users/me/Music/coolsong.mp3"));
audioOutput->setVolume(0.5);
player->play();

Documentation de la propriété

activeAudioTrack : int

Renvoie la piste audio actuellement active.

Par défaut, la première piste audio disponible sera sélectionnée.

Définissez ` index ` sur ` -1 ` pour désactiver toutes les pistes audio.

Fonctions d’accès :

Signal de notification :

activeSubtitleTrack : int

Renvoie la piste de sous-titres actuellement active.

Définissez index sur -1 pour désactiver les sous-titres.

Les sous-titres sont désactivés par défaut.

Fonctions d'accès :

Signal de notification :

activeVideoTrack : int

Renvoie la piste vidéo actuellement active.

Par défaut, la première piste audio disponible sera sélectionnée.

Définissez index sur -1 pour désactiver toutes les pistes vidéo.

Fonctions d'accès :

Signal de notification :

[since 6.8] audioBufferOutput : QAudioBufferOutput*

Cette propriété contient le tampon audio de sortie utilisé par le lecteur multimédia.

Définit une output de tampon audio pour le lecteur multimédia.

Si une QAudioBufferOutput est spécifiée et que la source multimédia contient un flux audio, le lecteur multimédia émettra le signal QAudioBufferOutput::audioBufferReceived avec des tampons audio contenant des données audio décodées. À la fin du flux audio, QMediaPlayer émet un QAudioBuffer vide.

QMediaPlayer émet des tampons audio en même temps qu’il transmet les données correspondantes à la sortie audio si celle-ci est spécifiée. Cependant, la lecture du son peut présenter un léger retard dû à la mise en tampon de l’audio.

Le format des tampons audio émis est tiré de l’ output spécifié ou du flux audio correspondant si l’ output renvoie un format non valide. Les données audio émises ne sont pas mises à l’échelle en fonction de la vitesse de lecture actuelle.

Voici quelques cas d’utilisation potentiels de la fonction QAudioBufferOutput avec QMediaPlayer:

• Visualisation audio. Si la vitesse de lecture du lecteur multimédia n’est pas celle de 1, vous pouvez redimensionner les dimensions de l’image de sortie ou l’intervalle de mise à jour de l’image en fonction des exigences du visualiseur.
• Tout traitement audio par IA, par exemple la reconnaissance vocale.
• Envoi des données vers une sortie audio externe. Il convient de prendre en compte les variations de la fréquence de lecture, la synchronisation avec la vidéo, ainsi que le vidage manuel lors de l’arrêt et de la recherche. Nous déconseillons d’utiliser la sortie du tampon audio à cette fin, sauf si vous avez une raison valable de le faire.

Cette énumération a été introduite dans Qt 6.8.

Fonctions d'accès :

Signal de notification :

audioOutput : QAudioOutput*

Cette propriété indique le périphérique de sortie audio utilisé par le lecteur multimédia.

Il s'agit de la sortie audio actuellement utilisée pour la lecture des fichiers multimédias. La définition d'une nouvelle sortie audio remplacera celle actuellement utilisée.

Si vous définissez cette propriété sur « nullptr », toute sortie audio sera désactivée.

Fonctions d’accès :

Signal de notification :

[read-only] audioTracks : QList<QMediaMetaData>

Répertorie l'ensemble des pistes audio disponibles dans le fichier multimédia.

L'QMediaMetaData e renvoyé décrit les propriétés de chaque piste.

Différentes pistes audio peuvent, par exemple, contenir des enregistrements dans différentes langues.

Fonctions d'accès :

Signal de notification :

[read-only] bufferProgress : float

Cette propriété indique le pourcentage de remplissage du tampon temporaire avant le début ou la reprise de la lecture, allant de 0(vide) à 1(plein).

Lorsque l'objet lecteur est en cours de mise en mémoire tampon, cette propriété indique le pourcentage de remplissage de la mémoire tampon temporaire. La mémoire tampon doit être remplie à 100 % avant que la lecture puisse démarrer ou reprendre ; à ce moment-là, la méthode mediaStatus() renverra BufferedMedia ou BufferingMedia. Si la valeur est inférieure à 100, la méthode mediaStatus() renverra StalledMedia.

Fonctions d’accès :

Signal de notification :

Voir également mediaStatus().

[read-only] duration : qint64

Cette propriété contient la durée du média actuel.

La valeur correspond à la durée totale de lecture, en millisecondes, du média actuel. Cette valeur peut varier au cours de la durée de vie de l’objet QMediaPlayer et peut ne pas être disponible au début de la lecture ; connectez-vous au signal durationChanged() pour recevoir des notifications d’état.

Fonctions d'accès :

Signal de notification :

[read-only] error : Error

Cette propriété contient une chaîne de caractères décrivant la dernière erreur survenue.

Fonctions d'accès :

Signal de notification :

Voir également error().

[read-only] errorString : QString

Cette propriété contient une chaîne de caractères décrivant plus en détail la condition d'erreur actuelle.

Fonctions d'accès :

Signal de notification :

[read-only] hasAudio : bool

Cette propriété indique si le fichier multimédia contient du son.

Fonctions d'accès :

Signal de notification :

[read-only] hasVideo : bool

Cette propriété indique si le média contient une vidéo.

Fonctions d'accès :

Signal de notification :

loops : int

Détermine le nombre de fois que le fichier multimédia est lu avant que le lecteur ne s'arrête. Définissez cette propriété sur « QMediaPlayer::Infinite » pour lire le fichier multimédia actuel en boucle indéfiniment.

La valeur par défaut est « 1 ». Définir cette propriété sur « 0 » n'a aucun effet.

Fonctions d’accès :

Signal de notification :

[read-only] mediaStatus : MediaStatus

Cette propriété indique l'état du flux multimédia en cours.

Le statut du flux décrit l'état d'avancement de la lecture du flux actuel.

Par défaut, cette propriété est QMediaPlayer::NoMedia

Fonctions d’accès :

Signal de notification :

[read-only] metaData : QMediaMetaData

Renvoie les métadonnées relatives au fichier multimédia actuellement lu par le lecteur multimédia.

Les métadonnées peuvent contenir des informations telles que le titre de la vidéo ou sa date de création.

Fonctions d’accès :

Signal de notification :

[since 6.10] pitchCompensation : bool

Cette propriété indique l'état de la compensation de hauteur tonale du lecteur multimédia.

Elle indique si la compensation de hauteur tonale est activée. Lorsqu’elle est activée, la modification de la vitesse de lecture n’affectera pas la hauteur tonale du signal audio.

Par défaut, la valeur est « true » si la compensation de hauteur tonale est disponible, sinon « false ».

Cette énumération a été introduite dans Qt 6.10.

Fonctions d'accès :

Signal de notification :

[read-only, since 6.10] pitchCompensationAvailability : const PitchCompensationAvailability

Cette propriété indique si la compensation de hauteur tonale est disponible sur le backend « QtMultimedia » actuel.

Indique si la compensation de hauteur tonale de l'QMediaPlayer est disponible sur le backend actuel.

Pour plus d’informations, consultez la section « QMediaPlayer::PitchCompensationAvailability ».

Cette énumération a été introduite dans Qt 6.10.

Fonctions d’accès :

[since 6.10] playbackOptions : QPlaybackOptions

Options de lecture avancées permettant de configurer la lecture et le décodage des fichiers multimédias.

Cette propriété expose l'API QPlaybackOptions qui permet un contrôle de bas niveau des options de lecture multimédia. Bien que nous recommandions vivement de s'en tenir aux paramètres par défaut de QMediaPlayer, cette API peut être utilisée pour optimiser la lecture multimédia dans des cas d'utilisation spécifiques où les options par défaut ne sont pas idéales.

Les options de lecture prennent effet lors du prochain appel à ` QMediaPlayer::setSource()`.

Cette énumération a été introduite dans Qt 6.10.

Fonctions d'accès :

Signal de notification :

playbackRate : qreal

Cette propriété détermine la vitesse de lecture du fichier multimédia actuel.

Cette valeur correspond à un multiplicateur appliqué à la vitesse de lecture standard du fichier multimédia. Par défaut, cette valeur est égale à 1,0, ce qui indique que le fichier multimédia est lu à la vitesse standard. Les valeurs supérieures à 1,0 augmentent la vitesse de lecture, tandis que les valeurs comprises entre 0,0 et 1,0 ralentissent la lecture. Les vitesses de lecture négatives ne sont pas prises en charge.

Tous les services de lecture ne prennent pas en charge la modification de la vitesse de lecture. Le comportement en termes de qualité audio et vidéo lors de l'avance rapide ou du retour en arrière est défini par le framework.

Fonctions d’accès :

Signal de notification :

[read-only] playbackState : PlaybackState

Renvoie l'PlaybackState.

Fonctions d'accès :

Signal de notification :

Voir aussi playing.

[read-only, since 6.5] playing : bool

Cette propriété indique si le média est en cours de lecture.

Cette énumération a été introduite dans Qt 6.5.

Fonctions d'accès :

Signal de notification :

Voir également playbackState et PlayingState.

position : qint64

Cette propriété contient la position de lecture du fichier multimédia actuel.

La valeur correspond à la position de lecture actuelle, exprimée en millisecondes depuis le début du média. Les changements périodiques de position seront signalés par le signal ` positionChanged()`.

Si la propriété « seekable » est définie sur « true », cette propriété peut être définie en millisecondes.

Fonctions d'accès :

Signal de notification :

[read-only] seekable : bool

Cette propriété indique si le média actuel permet la recherche

Si le défilement est pris en charge, cette propriété prend la valeur « true » ; sinon, elle prend la valeur « false ». La valeur de cette propriété peut évoluer au cours du cycle de vie de l'objet QMediaPlayer; utilisez le signal « seekableChanged » pour surveiller ces changements.

Fonctions d'accès :

Signal de notification :

source : QUrl

Cette propriété contient la source multimédia active utilisée par l'objet « player ».

L'objet lecteur utilisera l'QUrl pour sélectionner le contenu à lire.

Par défaut, cette propriété a une QUrl nulle.

Si vous attribuez à cette propriété une QUrl nulle, le lecteur supprimera toutes les informations relatives à la source multimédia actuelle et interrompra toutes les opérations d’E/S associées à ce média.

Fonctions d’accès :

Signal de notification :

Voir également QUrl.

[read-only] subtitleTracks : QList<QMediaMetaData>

Répertorie l'ensemble des pistes de sous-titres disponibles dans le fichier multimédia.

L'QMediaMetaData e renvoyée décrit les propriétés de chaque piste.

Fonctions d'accès :

Signal de notification :

videoOutput : QObject*

Cette propriété définit la sortie vidéo qui sera utilisée par le lecteur multimédia.

Un lecteur multimédia ne pouvant être associé qu'à une seule sortie vidéo, la définition de cette propriété remplacera la sortie vidéo précédemment connectée.

Si vous définissez cette propriété sur « nullptr », la sortie vidéo sera désactivée.

Fonctions d'accès :

Signal de notification :

[read-only] videoTracks : QList<QMediaMetaData>

Répertorie l'ensemble des pistes vidéo disponibles dans le fichier multimédia.

L'QMediaMetaData e renvoyée décrit les propriétés de chaque piste.

Fonctions d'accès :

Signal de notification :