MediaPlayer QML Type

Fügt die Medienwiedergabe zu einer Szene hinzu. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• 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>

Signale

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

Methoden

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

Ausführliche Beschreibung

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() }
    }
}

Sie können MediaPlayer zusammen mit einem MultiMedia::AudioOutput verwenden, um Audioinhalte abzuspielen, oder Sie können ihn in Verbindung mit einem Multimedia::VideoOutput für die Wiedergabe von Videos verwenden.

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();
    }
}

Siehe auch AudioOutput und VideoOutput.

Dokumentation der Eigenschaft

activeAudioTrack : int

Diese Eigenschaft enthält die Spurnummer der derzeit aktiven Audiospur. Setzen Sie sie auf -1, um die Audiospur zu deaktivieren.

Der Standardwert der Eigenschaft ist 0: die erste Tonspur.

activeSubtitleTrack : int

Diese Eigenschaft enthält die Spurnummer der derzeit aktiven Untertitelspur. Setzen Sie sie auf -1, um die Untertitelspur zu deaktivieren.

Der Standardwert der Eigenschaft ist -1: keine Untertitel aktiv.

activeVideoTrack : int

Diese Eigenschaft enthält die Spurnummer der derzeit aktiven Video-Audiospur. Setzen Sie sie auf -1, um die Videospur zu deaktivieren.

Der Standardwert der Eigenschaft ist 0: die erste Videospur.

audioBufferOutput : QAudioBufferOutput [since 6.8]

Diese Eigenschaft enthält die Ausgabe des Ziel-Audiopuffers.

Die normale Verwendung von MediaPlayer aus QML sollte die Verwendung dieser Eigenschaft nicht erfordern.

Diese Eigenschaft wurde in Qt 6.8 eingeführt.

Siehe auch QMediaPlayer::audioBufferOutput().

audioOutput : AudioOutput

Diese Eigenschaft enthält die Ziel-Audioausgabe. Akzeptiert ein AudioOutput Element.

Siehe auch QMediaPlayer::setAudioOutput().

audioTracks : list<mediaMetaData> [read-only]

Diese Eigenschaft enthält eine Liste von Metadaten. Jeder Index bezieht sich auf eine Audiospur.

Die Metadaten enthalten Eigenschaften, die die einzelnen Spuren beschreiben. Für Audiotracks ist die Language in der Regel die wichtigste Eigenschaft.

Siehe auch mediaMetaData.

autoPlay : bool [since 6.7]

Diese Eigenschaft steuert, ob die Medien nach dem Laden automatisch abgespielt werden sollen. Die Standardeinstellung ist false.

Diese Eigenschaft wurde in Qt 6.7 eingeführt.

bufferProgress : real [read-only]

Diese Eigenschaft gibt an, wie stark der Datenpuffer derzeit gefüllt ist, von 0.0 (leer) bis 1.0 (voll).

Die Wiedergabe kann nur beginnen oder fortgesetzt werden, wenn der Puffer vollständig gefüllt ist. Wenn der Puffer gefüllt ist, ist MediaPlayer.Buffered wahr. Wenn der Pufferfortschritt zwischen 0.0 und 1.0 liegt, wird MediaPlayer.Buffering auf true gesetzt.

Ein Wert kleiner als 1.0 bedeutet, dass die Eigenschaft MediaPlayer.StalledMedia true ist.

Siehe auch mediaStatus.

duration : int [read-only]

Diese Eigenschaft enthält die Dauer des Mediums in Millisekunden.

Wenn die Medien keine feste Dauer haben (z. B. bei einem Live-Stream), wird diese Eigenschaft auf 0 gesetzt.

error : enumeration [read-only]

Diese Eigenschaft enthält den Fehlerstatus des Audios. Sie kann eine der folgenden sein.

errorString : string [read-only]

Diese Eigenschaft enthält eine Zeichenfolge, die den aktuellen Fehlerzustand genauer beschreibt.

hasAudio : bool [read-only]

Diese Eigenschaft gibt an, ob das Medium Audio enthält.

hasVideo : bool [read-only]

Diese Eigenschaft gibt an, ob das Medium Video enthält.

loops : int

Bestimmt, wie oft die Medien abgespielt werden, bevor der Player anhält. Setzen Sie den Wert auf MediaPlayer::Infinite, um die aktuelle Mediendatei in einer Endlosschleife abzuspielen.

Der Standardwert ist 1. Die Einstellung dieser Eigenschaft auf 0 hat keine Auswirkungen.

mediaStatus : enumeration [read-only]

Diese Eigenschaft enthält den Status des Medienladens. Sie kann einer der folgenden Werte sein:

metaData : mediaMetaData [read-only]

Liefert Metadaten für das aktuelle Medium, das vom Medienplayer verwendet wird.

Metadaten können Informationen wie den Titel des Videos oder sein Erstellungsdatum enthalten.

pitchCompensation : bool [since 6.10]

Diese Eigenschaft gibt an, ob der Neigungsausgleich aktiviert ist.

Diese Eigenschaft wurde in Qt 6.10 eingeführt.

pitchCompensationAvailability : enumeration [read-only, since 6.10]

Zeigt die Verfügbarkeit des Neigungsausgleichs der MediaPlayer auf dem aktuellen Backend an. Die Aufzählung PitchCompensationAvailability ist skaliert.

Diese Eigenschaft wurde in Qt 6.10 eingeführt.

playbackOptions : playbackOptions [since 6.10]

Diese Eigenschaft stellt die PlaybackOptions-API zur Verfügung, die eine Steuerung der Medienwiedergabeoptionen auf niedriger Ebene ermöglicht. Obwohl wir dringend empfehlen, sich auf die Standardeinstellungen von MediaPlayer zu verlassen, kann diese API verwendet werden, um die Medienwiedergabe für bestimmte Anwendungsfälle zu optimieren, in denen die Standardoptionen nicht ideal sind.

Die Wiedergabeoptionen werden bei der nächsten Änderung von MediaPlayer::source wirksam.

Diese Eigenschaft wurde in Qt 6.10 eingeführt.

playbackRate : real

Diese Eigenschaft enthält die Rate, mit der Medien abgespielt werden, als ein Vielfaches der normalen Rate.

Weitere Informationen finden Sie unter QMediaPlayer::playbackRate.

Die Standardeinstellung ist 1.0.

playbackState : enumeration [read-only]

Diese Eigenschaft enthält den Status der Medienwiedergabe. Sie kann eine der folgenden sein:

playing : bool [read-only, since 6.5]

Zeigt an, ob das Medium gerade abgespielt wird.

Diese Eigenschaft wurde in Qt 6.5 eingeführt.

Siehe auch playbackState.

position : int

Der Wert ist die aktuelle Abspielposition, ausgedrückt in Millisekunden seit Beginn des Mediums. Regelmäßige Änderungen der Position werden mit dem Signal positionChanged() angezeigt.

Wenn die Eigenschaft seekable true ist, kann diese Eigenschaft auf Millisekunden gesetzt werden.

seekable : bool [read-only]

Diese Eigenschaft gibt an, ob die position des Mediums geändert werden kann.

source : url

Diese Eigenschaft enthält die Quell-URL des Mediums.

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();
    }
}

Siehe auch QMediaPlayer::setSource().

subtitleTracks : list<mediaMetaData> [read-only]

Diese Eigenschaft enthält eine Liste von Metadaten. Jeder Index bezieht sich auf eine Untertitelspur.

Die Metadaten enthalten Eigenschaften, die die einzelnen Spuren beschreiben. Für Untertitelspuren ist die Language normalerweise die wichtigste Eigenschaft.

Siehe auch mediaMetaData.

videoOutput : VideoOutput

Diese Eigenschaft enthält die Zielvideoausgabe. Akzeptiert ein VideoOutput Element.

Siehe auch QMediaPlayer::setVideoOutput().

videoTracks : list<mediaMetaData> [read-only]

Diese Eigenschaft enthält eine Liste von Metadaten. Jeder Index bezieht sich auf eine Videospur.

Die Metadaten enthalten Eigenschaften, die die einzelnen Spuren beschreiben.

Siehe auch mediaMetaData.

Signal-Dokumentation

errorOccurred(error, errorString)

Dieses Signal wird ausgegeben, wenn ein error aufgetreten ist. Der Parameter errorString kann genauere Informationen über den Fehler enthalten.

Siehe auch QMediaPlayer::Error.

playbackStateChanged()

Dieses Signal wird ausgegeben, wenn die Eigenschaft playbackState geändert wird.

playingChanged()

Dieses Signal wird ausgegeben, wenn sich die Eigenschaft playing ändert.

Dokumentation der Methode

void pause()

Hält die Wiedergabe der Medien an.

Setzt die Eigenschaft playbackState auf PausedState und ändert playing in false.

void play()

Startet die Wiedergabe der Medien oder setzt sie fort.

Setzt die Eigenschaft playbackState auf PlayingState und ändert playing in true.

void stop()

Stoppt die Wiedergabe der Medien.

Setzt die Eigenschaft playbackState auf StoppedState und ändert playing in false.