MediaPlayer QML Type

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

Import Statement:	`import QtMultimedia`
In C++:	QMediaPlayer

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

pause()
play()
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.

Eigenschaft Dokumentation

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 Audiospuren ist Language normalerweise 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 Voreinstellung 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 das Medium keine feste Dauer hat (z. B. ein Live-Stream), wird diese Eigenschaft auf 0 gesetzt.

error : enumeration [read-only]

Diese Eigenschaft enthält den Fehlerstatus des Audios. Sie kann einen der folgenden Werte annehmen.

Wert	Beschreibung
NoError	Es liegt kein aktueller Fehler vor.
RessourcenFehler	Das Audio kann aufgrund eines Problems bei der Ressourcenzuweisung nicht abgespielt werden.
FormatFehler	Das Audioformat wird nicht unterstützt.
NetzwerkFehler	Die Audiodatei kann aufgrund von Netzwerkproblemen nicht abgespielt werden.
AccessDeniedError	Die Audiodatei kann aufgrund unzureichender Berechtigungen nicht abgespielt werden.

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 die Medien Video enthalten.

loops : int

Bestimmt, wie oft das Medium abgespielt wird, 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 Medienladevorgangs. Sie kann einer der folgenden Werte sein:

Eigenschaft Wert	Beschreibung
NoMedia	Es wurden keine Medien eingestellt.
LoadingMedia	Das Medium wird gerade geladen.
GeladeneMedien	Die Medien wurden geladen.
BufferingMedia	Das Medium puffert gerade Daten.
GestopptMedien	Die Wiedergabe wurde unterbrochen, während der Datenträger Daten puffert.
GepufferteMedien	Der Datenträger hat Daten gepuffert.
EndOfMedia	Das Medium wurde bis zum Ende abgespielt.
UngültigeMedien	Das Medium kann nicht abgespielt werden.

metaData : mediaMetaData [read-only]

Gibt Metadaten für das aktuelle Medium zurück, das vom Medienplayer verwendet wird.

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

Hinweis: Die Windows-Implementierung liefert Metadaten nur für Medien, die sich im lokalen Dateisystem befinden.

playbackRate : real

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

Für weitere Informationen siehe QMediaPlayer::playbackRate.

Der Standardwert ist 1.0.

playbackState : enumeration [read-only]

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

Eigenschaft Wert	Beschreibung
Wiedergabestatus	Das Medium wird gerade abgespielt. Dieser Wert entspricht dem der Eigenschaft playing.
PausedState	Die Wiedergabe des Mediums wurde angehalten.
StoppedState	Die Wiedergabe des Mediums hat noch nicht begonnen.

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 dem Beginn des Mediums. Periodische Änderungen der Position werden mit dem Signal positionChanged() angezeigt.

Wenn die Eigenschaft seekable wahr 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 in der Regel 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.

Hinweis: Der entsprechende Handler ist onErrorOccurred.

Siehe auch QMediaPlayer::Error.

playbackStateChanged()

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

Hinweis: Der entsprechende Handler ist onPlaybackStateChanged.

playingChanged()

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

Hinweis: Der entsprechende Handler ist onPlayingChanged.

Methode Dokumentation

pause()

Hält die Wiedergabe der Medien an.

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

play()

Startet die Wiedergabe der Medien oder setzt sie fort.

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

stop()

Stoppt die Wiedergabe der Medien.

Setzt die Eigenschaft playbackState auf StoppedState und ändert playing in 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.