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 sur les propriétés

activeAudioTrack : int

Renvoie la piste audio actuellement active.

Par défaut, la première piste audio disponible est choisie.

Définissez index à -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.

Réglez 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 est choisie.

Réglez 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 la mémoire tampon audio de sortie utilisée par le lecteur multimédia.

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

Si QAudioBufferOutput est spécifié 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 signal vide QAudioBuffer.

QMediaPlayer émet des sorties de tampons audio en même temps qu'il pousse les données correspondantes vers la sortie audio si elle est spécifiée. Cependant, le son peut être joué avec un léger retard en raison de la bufferisation audio.

Le format des tampons audio émis provient du site output spécifié ou du flux audio correspondant si le site output renvoie un format non valide. Les données audio émises ne sont pas mises à l'échelle en fonction du taux de lecture actuel.

Les cas d'utilisation potentiels de l'utilisation de QAudioBufferOutput avec QMediaPlayer sont les suivants :

• Visualisation audio. Si la vitesse de lecture du lecteur multimédia n'est pas 1, vous pouvez mettre à l'échelle les dimensions de l'image de sortie ou l'intervalle de mise à jour de l'image en fonction des exigences du visualiseur.
• Tout traitement du son par l'IA, par exemple la reconnaissance vocale.
• Envoi des données à une sortie audio externe. La modification de la vitesse de lecture, la synchronisation avec la vidéo et le rinçage manuel lors de l'arrêt et de la recherche doivent être pris en compte. Nous ne recommandons pas d'utiliser la sortie du tampon audio à cette fin, à moins que vous n'ayez une bonne raison de le faire.

Cette propriété a été introduite dans Qt 6.8.

Fonctions d'accès :

Notificateur signal :

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 actuelle à utiliser lors de la lecture d'un média. La définition d'une nouvelle sortie audio remplacera la sortie actuellement utilisée.

La définition de cette propriété à nullptr désactive toute sortie audio.

Fonctions d'accès :

Signal de notification :

[read-only] audioTracks : QList<QMediaMetaData>

Liste l'ensemble des pistes audio disponibles dans le média.

Le site QMediaMetaData décrit les propriétés des différentes pistes.

Différentes pistes audio peuvent, par exemple, contenir de l'audio dans différentes langues.

Fonctions d'accès :

Signal de notification :

[read-only] bufferProgress : float

Cette propriété indique le pourcentage de la mémoire tampon temporaire remplie avant le début ou la reprise de la lecture, de 0(vide) à 1(pleine).

Lorsque l'objet lecteur met en mémoire tampon, cette propriété indique le pourcentage de la mémoire tampon temporaire qui est remplie. La mémoire tampon devra être remplie à 100 % avant que la lecture puisse commencer ou reprendre, auquel cas mediaStatus() renverra BufferedMedia ou BufferingMedia. Si la valeur est inférieure à 100, mediaStatus() renverra StalledMedia.

Fonctions d'accès :

Signal de notification :

Voir également mediaStatus().

[read-only] duration : qint64

Cette propriété indique la durée du média en cours.

La valeur correspond à la durée totale de lecture en millisecondes du média en cours. La valeur peut changer au cours de la durée de vie de l'objet QMediaPlayer et peut ne pas être disponible lorsque la lecture initiale commence. Connectez-vous au signal durationChanged() pour recevoir des notifications d'état.

Fonctions d'accès :

Signal Notifier :

[read-only] error : Error

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

Fonctions d'accès :

Signal du notificateur :

Voir aussi 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 du notificateur :

[read-only] hasAudio : bool

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

Fonctions d'accès :

Signal de notification :

[read-only] hasVideo : bool

Cette propriété indique si le média contient de la 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. La valeur QMediaPlayer::Infinite permet de lire en boucle le fichier multimédia actuel pour toujours.

La valeur par défaut est 1. La définition de cette propriété à 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 actuel.

L'état du flux décrit la progression de la lecture du flux en cours.

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

Fonctions d'accès :

Notificateur signal :

[read-only] metaData : QMediaMetaData

Renvoie les métadonnées du média en cours utilisé 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 du lecteur multimédia.

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

La valeur par défaut est true si la compensation de hauteur est disponible, sinon false.

Cette propriété a été introduite dans Qt 6.10.

Fonctions d'accès :

Notifier signal :

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

Cette propriété indique la disponibilité de la compensation de hauteur du backend QtMultimedia actuel.

Indique la disponibilité de la compensation de hauteur du site QMediaPlayer sur le backend actuel.

Pour plus d'informations, voir QMediaPlayer::PitchCompensationAvailability.

Cette propriété a été introduite dans Qt 6.10.

Fonctions d'accès :

[since 6.10] playbackOptions : QPlaybackOptions

Options de lecture avancées utilisées pour configurer la lecture et le décodage des médias.

Cette propriété expose l'API QPlaybackOptions qui permet un contrôle de bas niveau des options de lecture des médias. Bien qu'il soit fortement recommandé de se fier aux paramètres par défaut de QMediaPlayer, cette API peut être utilisée pour optimiser la lecture des médias 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 propriété a été introduite dans Qt 6.10.

Fonctions d'accès :

Signal Notifier :

playbackRate : qreal

Cette propriété indique la vitesse de lecture du média en cours.

Cette valeur est un multiplicateur appliqué à la vitesse de lecture standard du média. Par défaut, cette valeur est de 1,0, ce qui indique que le mé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 permettent pas de modifier la vitesse de lecture. Il s'agit d'un cadre défini quant à l'état et à la qualité de l'audio et de la vidéo lors de l'avance rapide ou du rembobinage.

Fonctions d'accès :

Signal de notification :

[read-only] playbackState : PlaybackState

Renvoie l'adresse PlaybackState.

Fonctions d'accès :

Signal du notificateur :

Voir aussi playing.

[read-only, since 6.5] playing : bool

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

Cette propriété a été introduite dans Qt 6.5.

Fonctions d'accès :

Signal Notifier :

Voir également playbackState et PlayingState.

position : qint64

Cette propriété indique la position de lecture du média en cours.

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

Si la propriété seekable est vraie, cette propriété peut être définie en millisecondes.

Fonctions d'accès :

Signal Notifier :

[read-only] seekable : bool

Cette propriété indique le statut de recherche du média actuel

Si la recherche est prise en charge, cette propriété aura la valeur true (vrai) ; false (faux) dans le cas contraire. L'état de cette propriété peut changer au cours de la durée de vie de l'objet QMediaPlayer. Utilisez le signal seekableChanged pour surveiller les changements.

Fonctions d'accès :

Signal Notificateur :

source : QUrl

Cette propriété contient la source média active utilisée par l'objet lecteur.

L'objet player utilisera le site QUrl pour sélectionner le contenu à lire.

Par défaut, cette propriété a la valeur null QUrl.

Si la valeur de cette propriété est null QUrl, le lecteur abandonne toutes les informations relatives à la source de média en cours et cesse toutes les opérations d'E/S liées à ce média.

Fonctions d'accès :

Signal Notifier :

Voir aussi QUrl.

[read-only] subtitleTracks : QList<QMediaMetaData>

Liste l'ensemble des pistes de sous-titres disponibles dans le média.

La page QMediaMetaData renvoyée décrit les propriétés des différentes pistes.

Fonctions d'accès :

Signal de notification :

videoOutput : QObject*

Cette propriété contient la sortie vidéo à utiliser par le lecteur multimédia.

Un lecteur multimédia ne peut avoir qu'une seule sortie vidéo attachée, donc la définition de cette propriété remplacera la sortie vidéo précédemment connectée.

La définition de cette propriété à nullptr désactive la sortie vidéo.

Fonctions d'accès :

Signal de notification :

[read-only] videoTracks : QList<QMediaMetaData>

Liste l'ensemble des pistes vidéo disponibles dans le média.

La page QMediaMetaData renvoyée décrit les propriétés des différentes pistes.

Fonctions d'accès :

Signal Notifier :