MediaPlayer QML Type

Ajoute la lecture de médias à une scène. Plus d'informations...

Import Statement: import QtMultimedia
In C++: QMediaPlayer

Propriétés

Signaux

Méthodes

Description détaillée

Text {
    text: "Click Me!";
    font.pointSize: 24;
    width: 150; height: 50;

    MediaPlayer {
        id: playMusic
        source: "music.wav"
        audioOutput: AudioOutput {}
    }
    MouseArea {
        anchors.fill: parent
        onPressed:  { playMusic.play() }
    }
}

Vous pouvez utiliser MediaPlayer avec un MultiMedia::AudioOutput pour lire du contenu audio, ou vous pouvez l'utiliser en conjonction avec un Multimedia::VideoOutput pour rendre de la vidéo.

Item {
    MediaPlayer {
        id: mediaplayer
        source: "groovy_video.mp4"
        audioOutput: AudioOutput {}
        videoOutput: videoOutput
    }

    VideoOutput {
        id: videoOutput
        anchors.fill: parent
    }

    MouseArea {
        anchors.fill: parent
        onPressed: mediaplayer.play();
    }
}

Voir également AudioOutput et VideoOutput.

Propriété Documentation

activeAudioTrack : int

Cette propriété contient le numéro de la piste audio actuellement active. La valeur -1 permet de désactiver la piste audio.

La valeur par défaut de cette propriété est 0: la première piste audio.


activeSubtitleTrack : int

Cette propriété contient le numéro de la piste de sous-titres actuellement active. Définissez cette propriété sur -1 pour désactiver la piste de sous-titres.

La valeur par défaut est -1: aucun sous-titre actif.


activeVideoTrack : int

Cette propriété contient le numéro de la piste audio vidéo actuellement active. La valeur -1 permet de désactiver la piste vidéo.

La valeur par défaut de cette propriété est 0: la première piste vidéo.


audioBufferOutput : QAudioBufferOutput [since 6.8]

Cette propriété contient la sortie du tampon audio cible.

L'utilisation normale de MediaPlayer à partir de QML ne devrait pas nécessiter l'utilisation de cette propriété.

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

Voir également QMediaPlayer::audioBufferOutput().


audioOutput : AudioOutput

Cette propriété contient la sortie audio cible. Accepte un élément AudioOutput.

Voir aussi QMediaPlayer::setAudioOutput().


audioTracks : list<mediaMetaData> [read-only]

Cette propriété contient une liste de métadonnées. Chaque index renvoie à une piste audio.

Les métadonnées contiennent des propriétés décrivant les pistes individuelles. Pour les pistes audio, la propriété Language est généralement la plus importante.

Voir également mediaMetaData.


autoPlay : bool [since 6.7]

Cette propriété détermine si la lecture du média commence automatiquement après son chargement. La valeur par défaut est false.

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


bufferProgress : real [read-only]

Cette propriété indique dans quelle mesure le tampon de données est actuellement rempli, de 0.0 (vide) à 1.0 (plein).

La lecture ne peut commencer ou reprendre que lorsque la mémoire tampon est entièrement remplie. Lorsque la mémoire tampon est remplie, MediaPlayer.Buffered est vrai. Lorsque la progression de la mémoire tampon se situe entre 0.0 et 1.0, MediaPlayer.Buffering est défini sur true.

Une valeur inférieure à 1.0 implique que la propriété MediaPlayer.StalledMedia est true.

Voir également mediaStatus.


duration : int [read-only]

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

Si le média n'a pas de durée fixe (un flux en direct par exemple), cette propriété sera définie sur 0.


error : enumeration [read-only]

Cette propriété indique l'état d'erreur de l'audio. Elle peut être l'une des suivantes.

ValeurDescription
NoErrorIl n'y a pas d'erreur en cours.
ResourceErrorL'audio ne peut pas être joué en raison d'un problème d'allocation des ressources.
FormatErrorLe format audio n'est pas pris en charge.
Erreur de réseauL'audio ne peut pas être lu en raison d'un problème de réseau.
Erreur d'accès (AccessDeniedError)L'audio ne peut pas être lu en raison de permissions insuffisantes.

errorString : string [read-only]

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


hasAudio : bool [read-only]

Cette propriété indique si le média contient de l'audio.


hasVideo : bool [read-only]

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


loops : int

Détermine le nombre de fois que le média est lu avant que le lecteur ne s'arrête. La valeur MediaPlayer::Infinite permet de lire en boucle le fichier multimédia en cours pour toujours.

La valeur par défaut est 1. La définition de cette propriété à 0 n'a aucun effet.


mediaStatus : enumeration [read-only]

Cette propriété indique l'état de chargement du média. Il peut s'agir de l'une des valeurs suivantes :

Valeur de la propriétéValeur de la propriété Description
NoMediaAucun média n'a été défini.
LoadingMediaLe média est en cours de chargement.
LoadedMediaLe média a été chargé.
BufferingMediaLe média est en train de mettre des données en mémoire tampon.
Média bloquéLa lecture a été interrompue pendant que le média met des données en mémoire tampon.
Média en mémoire tamponLe média a mis des données en mémoire tampon.
Fin du médiaLa lecture du média s'est terminée.
InvalidMediaLe média ne peut pas être lu.

metaData : mediaMetaData [read-only]

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.

Remarque : l'implémentation Windows ne fournit des métadonnées que pour les médias situés sur le système de fichiers local.


pitchCompensation : bool [since 6.10]

Cette propriété indique si la compensation de hauteur est activée.

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


pitchCompensationAvailability : enumeration [read-only, since 6.10]

Indique la disponibilité de la compensation de hauteur du site MediaPlayer sur le backend actuel. L'énumération PitchCompensationAvailability est limitée.

ConstanteDescription
MediaPlayer.AlwaysOnLe lecteur multimédia effectue toujours une compensation de hauteur.
MediaPlayer.AvailableLe lecteur multimédia peut être configuré pour utiliser la compensation de hauteur. Si la compensation de hauteur est disponible sur la plate-forme actuelle, elle est activée par défaut, mais les utilisateurs peuvent la désactiver si nécessaire.
MediaPlayer.UnavailableLe lecteur multimédia n'est pas en mesure d'effectuer une compensation de hauteur sur la plate-forme actuelle.

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


playbackOptions : playbackOptions [since 6.10]

Cette propriété expose l'API playbackOptions 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 MediaPlayer, 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 à la prochaine modification de MediaPlayer::source.

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


playbackRate : real

Cette propriété indique la vitesse de lecture des médias en tant que multiple de la vitesse normale.

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

La valeur par défaut est 1.0.


playbackState : enumeration [read-only]

Cette propriété indique l'état de la lecture du média. Il peut s'agir de l'un des éléments suivants :

Valeur de la propriétéDescription
PlayingState (État de lecture)Le média est en cours de lecture. Cette valeur est identique à celle de la propriété playing.
PausedState (état de pause)La lecture du média a été suspendue.
StoppedStateLa lecture du média n'a pas encore commencé.

playing : bool [read-only, since 6.5]

Indique si le média est en cours de lecture.

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

Voir également playbackState.


position : int

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

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


seekable : bool [read-only]

Cette propriété indique si l'adresse position du média peut être modifiée.


source : url

Cette propriété indique l'URL source du média.

Item {
    MediaPlayer {
        id: mediaplayer
        source: "file:///test.mp4"
        videoOutput: videoOutput
        audioOutput: AudioOutput {

        }
    }

    VideoOutput {
        id: videoOutput
        anchors.fill: parent
    }

    MouseArea {
        id: playArea
        anchors.fill: parent
        onPressed: mediaplayer.play();
    }
}

Voir également QMediaPlayer::setSource().


subtitleTracks : list<mediaMetaData> [read-only]

Cette propriété contient une liste de métadonnées. Chaque index renvoie à une piste de sous-titres.

Les métadonnées contiennent des propriétés décrivant les différentes pistes. Pour les pistes de sous-titres, la propriété Language est généralement la plus importante.

Voir également mediaMetaData.


videoOutput : VideoOutput

Cette propriété contient la sortie vidéo cible. Accepte un élément VideoOutput.

Voir également QMediaPlayer::setVideoOutput().


videoTracks : list<mediaMetaData> [read-only]

Cette propriété contient une liste de métadonnées. Chaque index fait référence à une piste vidéo.

Les métadonnées contiennent des propriétés décrivant les pistes individuelles.

Voir également mediaMetaData.


Signal Documentation

errorOccurred(error, errorString)

Ce signal est émis lorsqu'une erreur s'est produite à l'adresse error. Le paramètre errorString peut contenir des informations plus détaillées sur l'erreur.

Remarque : le gestionnaire correspondant est onErrorOccurred.

Voir aussi QMediaPlayer::Error.


playbackStateChanged()

Ce signal est émis lorsque la propriété playbackState est modifiée.

Remarque : Le gestionnaire correspondant est onPlaybackStateChanged.


playingChanged()

Ce signal est émis lorsque la propriété playing est modifiée.

Note : Le gestionnaire correspondant est onPlayingChanged.


Documentation de la méthode

pause()

Met en pause la lecture du média.

Attribue la valeur PausedState à la propriété playbackState et remplace playing par false.


play()

Démarre ou reprend la lecture du média.

Attribue à la propriété playbackState la valeur PlayingState et remplace playing par true.


stop()

Arrête la lecture du média.

Attribue à la propriété playbackState la valeur StoppedState et remplace playing par false.


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.