MediaPlayer QML Type

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

• Liste aller Mitglieder, einschließlich vererbter 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()
• tracksChanged()

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 in Verbindung mit einem Multimedia::VideoOutput zur Wiedergabe von Videos.

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 zu den Eigenschaften

activeAudioTrack : int

Diese Eigenschaft enthält die Nummer der derzeit aktiven Audiospur. Setzen Sie den Wert auf „ -1 “, um die Audiospur zu deaktivieren.

Der Standardwert der Eigenschaft ist „ 0 “: die erste Audiospur.

activeSubtitleTrack : int

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

Der Standardwert der Eigenschaft lautet „ -1 “: keine Untertitel aktiv.

activeVideoTrack : int

Diese Eigenschaft enthält die Nummer der derzeit aktiven Video-Audiospur. Setzen Sie den Wert 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 den Ziel-Audio-Ausgabepuffer.

Bei normaler Verwendung von „ MediaPlayer “ aus QML sollte die Nutzung dieser Eigenschaft nicht erforderlich sein.

Diese Eigenschaft wurde in Qt 6.8 eingeführt.

Siehe auch „ QMediaPlayer::audioBufferOutput()“.

audioOutput : AudioOutput

Diese Eigenschaft enthält die Ziel-Audioausgabe. Akzeptiert ein Element vom Typ „ AudioOutput “.

Siehe auch ` QMediaPlayer::setAudioOutput()`.

audioTracks : list<mediaMetaData> [read-only]

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

Die Metadaten enthalten Eigenschaften, die die einzelnen Spuren beschreiben. Bei Audiospuren ist „ Language “ in der Regel die wichtigste Eigenschaft.

Diese Eigenschaft löst bei einer Änderung das Signal „ tracksChanged “ aus.

Siehe auch „ mediaMetaData “.

autoPlay : bool [since 6.7]

Diese Eigenschaft legt fest, ob die Wiedergabe des Mediums automatisch beginnt, sobald es geladen wurde. Der Standardwert ist „ false “.

Diese Eigenschaft wurde in Qt 6.7 eingeführt.

bufferProgress : real [read-only]

Diese Eigenschaft gibt an, zu wie viel Prozent der Datenpuffer derzeit gefüllt ist, wobei die Werte von „ 0.0 “ (leer) bis „ 1.0 “ (voll) reichen.

Die Wiedergabe kann erst gestartet oder fortgesetzt werden, wenn der Puffer vollständig gefüllt ist. Ist der Puffer gefüllt, ist „ MediaPlayer.Buffered “ wahr. Liegt der Füllstand des Puffers zwischen „ 0.0 “ und „ 1.0 “, wird „ MediaPlayer.Buffering “ auf „ true “ gesetzt.

Ein Wert, der kleiner als „ 1.0 “ ist, bedeutet, dass die Eigenschaft „ MediaPlayer.StalledMedia “ auf „ true “ gesetzt ist.

Siehe auch „ mediaStatus “.

duration : int [read-only]

Diese Eigenschaft gibt die Dauer des Mediums in Millisekunden an.

Wenn das Medium keine feste Dauer hat (z. B. ein Live-Stream), wird dieser Wert auf „ 0 “ gesetzt.

error : enumeration [read-only]

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

errorString : string [read-only]

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

hasAudio : bool [read-only]

Diese Eigenschaft gilt unabhängig davon, ob das Medium Audio enthält.

hasVideo : bool [read-only]

Diese Eigenschaft gilt unabhängig davon, ob das Medium ein Video enthält.

loops : int

Legt fest, wie oft die Mediendatei abgespielt wird, bevor der Player stoppt. Setzen Sie den Wert auf „MediaPlayer::Infinite“, um die aktuelle Mediendatei endlos zu wiederholen.

Der Standardwert ist „ 1 “. Die Einstellung dieser Eigenschaft auf „ 0 “ hat keine Auswirkung.

mediaStatus : enumeration [read-only]

Diese Eigenschaft gibt den Status des Medienladevorgangs an. Sie kann einen der folgenden Werte annehmen:

metaData : mediaMetaData [read-only]

Gibt Metadaten für das aktuell vom Mediaplayer wiedergegebene Medium zurück.

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

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]

Gibt an, ob die Tonhöhenkompensation des „ MediaPlayer “ auf dem aktuellen Backend verfügbar ist. Die Aufzählung „ PitchCompensationAvailability “ ist auf den aktuellen Bereich beschränkt.

Diese Eigenschaft wurde in Qt 6.10 eingeführt.

playbackOptions : PlaybackOptions [since 6.10]

Diese Eigenschaft stellt die API „ PlaybackOptions “ bereit, die eine detaillierte Steuerung der Medienwiedergabeoptionen ermöglicht. Obwohl wir dringend empfehlen, die Standardeinstellungen unter „ MediaPlayer “ zu verwenden, kann diese API genutzt werden, um die Medienwiedergabe für bestimmte Anwendungsfälle zu optimieren, in denen die Standardoptionen nicht ideal sind.

Die Wiedergabeoptionen werden wirksam, sobald „ MediaPlayer::source “ das nächste Mal geändert wird.

Diese Eigenschaft wurde in Qt 6.10 eingeführt.

playbackRate : real

Diese Eigenschaft gibt die Wiedergabegeschwindigkeit der Medien als Vielfaches der normalen Geschwindigkeit an.

Weitere Informationen finden Sie unter QMediaPlayer::playbackRate.

Standardwert ist „ 1.0 “.

playbackState : enumeration [read-only]

Diese Eigenschaft gibt den Status der Medienwiedergabe an. Sie kann einen der folgenden Werte annehmen:

playing : bool [read-only, since 6.5]

Gibt an, ob die Mediendatei gerade abgespielt wird.

Diese Eigenschaft wurde in Qt 6.5 eingeführt.

Siehe auch playbackState.

position : int

Der Wert gibt die aktuelle Wiedergabeposition an, ausgedrückt in Millisekunden seit Beginn des Mediums. Regelmäßige Änderungen der Position werden über das Signal „positionChanged()“ angezeigt.

Wenn die Eigenschaft „ seekable “ auf „true“ gesetzt ist, kann diese Eigenschaft in Millisekunden angegeben 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 Eintrag bezieht sich auf eine Untertitelspur.

Die Metadaten enthalten Eigenschaften, die die einzelnen Spuren beschreiben. Bei Untertitelspuren ist der „ Language “ in der Regel die wichtigste Eigenschaft.

Diese Eigenschaft löst bei einer Änderung das Signal „ tracksChanged “ aus.

Siehe auch „ mediaMetaData “.

videoOutput : VideoOutput

Diese Eigenschaft enthält die Ziel-Videoausgabe. Akzeptiert ein Element vom Typ „ VideoOutput “.

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.

Diese Eigenschaft gibt bei einer Änderung das Signal „ tracksChanged “ aus.

Siehe auch „ mediaMetaData “.

Signaldokumentation

errorOccurred(error, errorString)

Dieses Signal wird ausgelöst, wenn ein „ error “ aufgetreten ist. Der Parameter „ errorString “ enthält möglicherweise detailliertere Informationen zum Fehler.

Siehe auch „ QMediaPlayer::Error “.

playbackStateChanged()

Dieses Signal wird ausgelöst, wenn die Eigenschaft „ playbackState “ geändert wird.

playingChanged()

Dieses Signal wird ausgelöst, wenn sich die Eigenschaft „ playing “ ändert.

tracksChanged()

Dieses Signal wird ausgelöst, wenn die Eigenschaften „ audioTracks “, „ subtitleTracks “ oder „ videoTracks “ geändert werden.

Methodendokumentation

void pause()

Hält die Wiedergabe des Mediums an.

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

void play()

Startet oder setzt die Wiedergabe des Mediums fort.

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

void stop()

Hält die Wiedergabe des Mediums an.

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