MediaPlayer QML Type

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

• Liste de tous les membres, y compris les membres hérités

Propriétés

• activeAudioTrack : int
• activeSubtitleTrack : int
• activeVideoTrack : int
• audioBufferOutput : QAudioBufferOutput (since 6.8)
• audioOutput : AudioOutput
• audioTracks : list<mediaMetaData>
• autoPlay : bool (since 6.7)
• bufferProgress : real
• duration : int
• error : enumeration
• errorString : string
• hasAudio : bool
• hasVideo : bool
• loops : int
• mediaStatus : enumeration
• metaData : mediaMetaData
• pitchCompensation : bool (since 6.10)
• pitchCompensationAvailability : enumeration (since 6.10)
• playbackOptions : playbackOptions (since 6.10)
• playbackRate : real
• playbackState : enumeration
• playing : bool (since 6.5)
• position : int
• seekable : bool
• source : url
• subtitleTracks : list<mediaMetaData>
• videoOutput : VideoOutput
• videoTracks : list<mediaMetaData>

Signaux

• errorOccurred(error, errorString)
• playbackStateChanged()
• playingChanged()

Méthodes

• void pause()
• void play()
• void stop()

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.

Documentation sur les propriétés

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. La valeur -1 permet de désactiver la piste de sous-titres.

La valeur par défaut de cette propriété 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 la 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 aussi 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 fait référence à 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 la mémoire tampon est actuellement remplie, de 0.0 (vide) à 1.0 (pleine).

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 fixée à 0.

error : enumeration [read-only]

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

errorString : string [read-only]

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

hasAudio : bool [read-only]

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

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. Elle peut être l'une des suivantes :

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.

pitchCompensation : bool [since 6.10]

Cette propriété indique si la compensation du tangage 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 du pas de MediaPlayer sur le backend actuel. L'énumération PitchCompensationAvailability est cadrée.

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 :

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é contient 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 fait référence à une piste de sous-titres.

Les métadonnées contiennent des propriétés décrivant les pistes individuelles. 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 différentes pistes.

Voir également mediaMetaData.

Documentation sur les signaux

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.

Voir également QMediaPlayer::Error.

playbackStateChanged()

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

playingChanged()

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

Documentation de la méthode

void pause()

Met en pause la lecture du média.

Définit la propriété playbackState comme PausedState et remplace playing par false.

void play()

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

Définit la propriété playbackState comme PlayingState et remplace playing par true.

void stop()

Arrête la lecture du média.

Définit la propriété playbackState comme étant StoppedState et remplace playing par false.