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

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 einer der folgenden Werte sein.

Konstante	Beschreibung
`MediaPlayer.NoError`	Es ist kein Fehler aufgetreten.
`MediaPlayer.ResourceError`	Eine Medienressource konnte nicht aufgelöst werden.
`MediaPlayer.FormatError`	Das Format einer Medienressource wird nicht (vollständig) unterstützt. Die Wiedergabe kann noch möglich sein, aber ohne Audio- oder Videokomponente.
`MediaPlayer.NetworkError`	Ein Netzwerkfehler ist aufgetreten.
`MediaPlayer.AccessDeniedError`	Es liegen nicht die entsprechenden Berechtigungen für die Wiedergabe einer Medienressource vor.

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 ein Video enthalten.

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 Medienladevorgangs. Sie kann einer der folgenden Werte sein:

Konstante	Beschreibung
`MediaPlayer.NoMedia`	Es gibt keine aktuellen Medien. Der Player befindet sich im StoppedState.
`MediaPlayer.LoadingMedia`	Die aktuellen Medien werden gerade geladen. Der Player kann sich in einem beliebigen Zustand befinden.
`MediaPlayer.LoadedMedia`	Die aktuellen Medien wurden geladen. Der Player befindet sich im StoppedState.
`MediaPlayer.StalledMedia`	Die Wiedergabe des aktuellen Mediums ist aufgrund unzureichender Pufferung oder einer anderen vorübergehenden Unterbrechung ins Stocken geraten. Der Player befindet sich im PlayingState oder PausedState.
`MediaPlayer.BufferingMedia`	Der Player puffert gerade Daten, verfügt jedoch über genügend Daten, um die Wiedergabe für die unmittelbare Zukunft fortzusetzen. Der Player befindet sich im PlayingState oder PausedState.
`MediaPlayer.BufferedMedia`	Der Player hat die aktuellen Medien vollständig gepuffert. Der Player befindet sich im PlayingState oder PausedState.
`MediaPlayer.EndOfMedia`	Die Wiedergabe hat das Ende des aktuellen Mediums erreicht. Der Player befindet sich im StoppedState.
`MediaPlayer.InvalidMedia`	Das aktuelle Medium kann nicht wiedergegeben werden. Der Player befindet sich im StoppedState.

metaData : mediaMetaData [read-only]

Gibt Metadaten für die vom Medienplayer verwendeten aktuellen Medien zurück.

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

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

pitchCompensation : bool [since 6.10]

Diese Eigenschaft gibt an, ob die Tonhöhenkompensation aktiviert ist.

Diese Eigenschaft wurde in Qt 6.10 eingeführt.

pitchCompensationAvailability : enumeration [read-only, since 6.10]

Zeigt die Verfügbarkeit des Tonhöhenausgleichs von MediaPlayer auf dem aktuellen Backend an. Die Aufzählung PitchCompensationAvailability ist skaliert.

Konstante	Beschreibung
`MediaPlayer.AlwaysOn`	Der Media Player führt immer einen Tonhöhenausgleich durch.
`MediaPlayer.Available`	Der Medienplayer kann für die Verwendung des Tonhöhenausgleichs konfiguriert werden. Wenn die Tonhöhenkompensation auf der aktuellen Plattform verfügbar ist, wird sie standardmäßig aktiviert, kann aber bei Bedarf vom Benutzer deaktiviert werden.
`MediaPlayer.Unavailable`	Der Media Player kann auf der aktuellen Plattform keine Tonhöhenkompensation durchführen.

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 Low-Level-Steuerung der Medienwiedergabeoptionen 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 wirksam, wenn MediaPlayer::source das nächste Mal geändert wird.

Diese Eigenschaft wurde in Qt 6.10 eingeführt.

playbackRate : real

Diese Eigenschaft enthält die Rate, mit der 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.