QMediaPlayer Class

player = new QMediaPlayer;
audioOutput = new QAudioOutput;
player->setAudioOutput(audioOutput);
connect(player, &QMediaPlayer::positionChanged, this, &MediaExample::positionChanged);
player->setSource(QUrl::fromLocalFile("/Users/me/Music/coolsong.mp3"));
audioOutput->setVolume(0.5);
player->play();

Eigenschaftsdokumentation

activeAudioTrack : int

Gibt die derzeit aktive Audiospur zurück.

Standardmäßig wird die erste verfügbare Audiospur ausgewählt.

Setzen Sie ` index ` auf ` -1 `, um alle Audiospuren zu deaktivieren.

Zugriffsfunktionen:

Benachrichtigungssignal:

activeSubtitleTrack : int

Gibt die derzeit aktive Untertitelspur zurück.

Setzen Sie „ index “ auf „ -1 “, um Untertitel zu deaktivieren.

Untertitel sind standardmäßig deaktiviert.

Zugriffsfunktionen:

Benachrichtigungssignal:

activeVideoTrack : int

Gibt die derzeit aktive Videospur zurück.

Standardmäßig wird die erste verfügbare Audiospur ausgewählt.

Setzen Sie „ index “ auf „ -1 “, um alle Videospuren zu deaktivieren.

Zugriffsfunktionen:

Benachrichtigungssignal:

[since 6.8] audioBufferOutput : QAudioBufferOutput*

Diese Eigenschaft enthält den vom Media Player verwendeten Audio-Ausgabepuffer.

Legt eine Audio-Puffer- output für den Media Player fest.

Wenn „ QAudioBufferOutput “ angegeben ist und die Medienquelle einen Audiostream enthält, gibt der Media Player das Signal „ QAudioBufferOutput::audioBufferReceived “ mit Audio-Puffern aus, die dekodierte Audiodaten enthalten. Am Ende des Audiostreams gibt „ QMediaPlayer “ einen leeren „ QAudioBuffer “ aus.

QMediaPlayer gibt Audio-Puffer aus und überträgt gleichzeitig die entsprechenden Daten an den Audioausgang, sofern dieser angegeben ist. Aufgrund der Pufferung des Audiosignals kann die Wiedergabe jedoch mit einer geringen Verzögerung erfolgen.

Das Format der ausgegebenen Audio-Puffer wird aus dem angegebenen „ output “ übernommen oder, falls „ output “ ein ungültiges Format zurückgibt, aus dem entsprechenden Audiostream. Die ausgegebenen Audiodaten werden nicht entsprechend der aktuellen Wiedergaberate skaliert.

Mögliche Anwendungsfälle für die Verwendung von „ QAudioBufferOutput “ in Verbindung mit „ QMediaPlayer “ sind beispielsweise:

• Audio-Visualisierung. Wenn die Wiedergaberate des Media Players nicht „ 1 “ ist, können Sie die Abmessungen des Ausgabebildes oder das Bildaktualisierungsintervall entsprechend den Anforderungen des Visualisierers skalieren.
• Jede Art von KI-basierter Klangverarbeitung, z. B. Spracherkennung.
• Übertragung der Daten an einen externen Audioausgang. Dabei sollten Änderungen der Wiedergaberate, die Synchronisation mit Video sowie das manuelle Leeren des Puffers beim Anhalten und beim Springen berücksichtigt werden. Wir raten davon ab, die Audio-Pufferausgabe für diesen Zweck zu verwenden, es sei denn, Sie haben einen triftigen Grund dafür.

Diese Aufzählung wurde in Qt 6.8 eingeführt.

Zugriffsfunktionen:

Notifier-Signal:

audioOutput : QAudioOutput*

Diese Eigenschaft gibt das vom Mediaplayer verwendete Audioausgabegerät an.

Die derzeitige Audioausgabe, die bei der Wiedergabe von Medien verwendet wird. Durch das Festlegen einer neuen Audioausgabe wird die derzeit verwendete Ausgabe ersetzt.

Wird diese Eigenschaft auf „ nullptr “ gesetzt, wird jegliche Audioausgabe deaktiviert.

Zugriffsfunktionen:

Benachrichtigungssignal:

[read-only] audioTracks : QList<QMediaMetaData>

Listet die verfügbaren Audiospuren innerhalb der Mediendatei auf.

Der zurückgegebene „ QMediaMetaData “ beschreibt die Eigenschaften der einzelnen Spuren.

Verschiedene Audiospuren können beispielsweise Audioinhalte in verschiedenen Sprachen enthalten.

Zugriffsfunktionen:

Benachrichtigungssignal:

[read-only] bufferProgress : float

Diese Eigenschaft gibt den Prozentsatz an, zu dem der temporäre Puffer gefüllt ist, bevor die Wiedergabe beginnt oder fortgesetzt wird, und reicht von „ 0 “ (leer) bis „ 1 “ (voll).

Wenn das Player-Objekt puffert, gibt diese Eigenschaft den Prozentsatz des gefüllten temporären Puffers an. Der Puffer muss zu 100 % gefüllt sein, bevor die Wiedergabe gestartet oder fortgesetzt werden kann. Zu diesem Zeitpunkt gibt „ mediaStatus()“ entweder „ BufferedMedia “ oder „ BufferingMedia “ zurück. Liegt der Wert unter „ 100 “, gibt „ mediaStatus()“ „ StalledMedia “ zurück.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch ` mediaStatus()`.

[read-only] duration : qint64

Diese Eigenschaft enthält die Dauer des aktuellen Mediums.

Der Wert entspricht der gesamten Wiedergabezeit des aktuellen Mediums in Millisekunden. Der Wert kann sich während der Lebensdauer des Objekts „ QMediaPlayer “ ändern und steht möglicherweise zu Beginn der Wiedergabe noch nicht zur Verfügung. Verbinden Sie sich mit dem Signal „ durationChanged()“, um Statusbenachrichtigungen zu erhalten.

Zugriffsfunktionen:

Benachrichtigungssignal:

[read-only] error : Error

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

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ error()“.

[read-only] errorString : QString

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

Zugriffsfunktionen:

Benachrichtigungssignal:

[read-only] hasAudio : bool

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

Zugriffsfunktionen:

Benachrichtigungssignal:

[read-only] hasVideo : bool

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

Zugriffsfunktionen:

Benachrichtigungssignal:

loops : int

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

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

Zugriffsfunktionen:

Benachrichtigungssignal:

[read-only] mediaStatus : MediaStatus

Diese Eigenschaft gibt den Status des aktuellen Medien-Streams an.

Der Stream-Status beschreibt, wie die Wiedergabe des aktuellen Streams voranschreitet.

Standardmäßig ist diese Eigenschaft QMediaPlayer::NoMedia

Zugriffsfunktionen:

Benachrichtigungssignal:

[read-only] metaData : QMediaMetaData

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.

Zugriffsfunktionen:

Benachrichtigungssignal:

[since 6.10] pitchCompensation : bool

Diese Eigenschaft gibt den Status der Tonhöhenkompensation des Media Players an.

Gibt an, ob die Tonhöhenkompensation aktiviert ist. Ist sie aktiviert, hat eine Änderung der Wiedergabegeschwindigkeit keinen Einfluss auf die Tonhöhe des Audiosignals.

Standardmäßig lautet der Wert „ true “, sofern eine Tonhöhenkompensation verfügbar ist, andernfalls „ false “.

Diese Aufzählung wurde in Qt 6.10 eingeführt.

Zugriffsfunktionen:

Notifier-Signal:

[read-only, since 6.10] pitchCompensationAvailability : const PitchCompensationAvailability

Diese Eigenschaft gibt an, ob die Tonhöhenkompensation des aktuellen „ QtMultimedia “-Backends verfügbar ist.

Zeigt die Verfügbarkeit der Tonhöhenkompensation des „ QMediaPlayer “ auf dem aktuellen Backend an.

Weitere Informationen finden Sie unter „ QMediaPlayer::PitchCompensationAvailability “.

Diese Aufzählung wurde in Qt 6.10 eingeführt.

Zugriffsfunktionen:

[since 6.10] playbackOptions : QPlaybackOptions

Erweiterte Wiedergabeoptionen zur Konfiguration der Medienwiedergabe und -dekodierung.

Diese Eigenschaft stellt die API „ QPlaybackOptions “ bereit, die eine Steuerung der Medienwiedergabeoptionen auf niedriger Ebene ermöglicht. Obwohl wir dringend empfehlen, sich auf die Standardeinstellungen von „ QMediaPlayer “ 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 beim nächsten Aufruf von ` QMediaPlayer::setSource()` wirksam.

Diese Aufzählung wurde in Qt 6.10 eingeführt.

Zugriffsfunktionen:

Notifier-Signal:

playbackRate : qreal

Diese Eigenschaft gibt die Wiedergabegeschwindigkeit des aktuellen Mediums an.

Dieser Wert ist ein Multiplikator, der auf die Standardwiedergaberate des Mediums angewendet wird. Standardmäßig beträgt dieser Wert 1,0, was bedeutet, dass das Medium mit Standardgeschwindigkeit wiedergegeben wird. Werte über 1,0 erhöhen die Wiedergabegeschwindigkeit, während Werte zwischen 0,0 und 1,0 zu einer langsameren Wiedergabe führen. Negative Wiedergaberaten werden nicht unterstützt.

Nicht alle Wiedergabedienste unterstützen die Änderung der Wiedergabegeschwindigkeit. Der Status und die Qualität von Audio und Video beim Vor- und Zurückspulen werden vom Framework festgelegt.

Zugriffsfunktionen:

Benachrichtigungssignal:

[read-only] playbackState : PlaybackState

Gibt die „ PlaybackState “ zurück.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch „ playing “.

[read-only, since 6.5] playing : bool

Diese Eigenschaft gibt an, ob die Medienwiedergabe läuft.

Diese Aufzählung wurde in Qt 6.5 eingeführt.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch playbackState und PlayingState.

position : qint64

Diese Eigenschaft enthält die Wiedergabeposition des aktuellen Mediums.

Der Wert entspricht der aktuellen Wiedergabeposition, ausgedrückt in Millisekunden seit Beginn des Mediums. Regelmäßige Änderungen der Position werden durch das Signal „ positionChanged()“ angezeigt.

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

Zugriffsfunktionen:

Benachrichtigungssignal:

[read-only] seekable : bool

Diese Eigenschaft gibt den Status der Suchbarkeit des aktuellen Mediums an

Wenn das Springen unterstützt wird, ist diese Eigenschaft „true“; andernfalls „false“. Der Status dieser Eigenschaft kann sich während der Lebensdauer des „ QMediaPlayer “-Objekts ändern. Verwenden Sie das Signal „ seekableChanged “, um Änderungen zu überwachen.

Zugriffsfunktionen:

Notifier-Signal:

source : QUrl

Diese Eigenschaft enthält die aktive Medienquelle, die vom Player-Objekt verwendet wird.

Das Player-Objekt verwendet die Eigenschaft „ QUrl “, um den abzuspielenden Inhalt auszuwählen.

Standardmäßig hat diese Eigenschaft eine Null- QUrl.

Wird diese Eigenschaft auf eine null- QUrl gesetzt, verwirft der Player alle Informationen zur aktuellen Medienquelle und bricht alle E/A-Vorgänge im Zusammenhang mit dieser Medienquelle ab.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ QUrl “.

[read-only] subtitleTracks : QList<QMediaMetaData>

Listet die verfügbaren Untertitel-Spuren innerhalb der Mediendatei auf.

Die zurückgegebene „ QMediaMetaData “ beschreibt die Eigenschaften der einzelnen Spuren.

Zugriffsfunktionen:

Benachrichtigungssignal:

videoOutput : QObject*

Diese Eigenschaft legt den vom Mediaplayer zu verwendenden Videoausgang fest.

Ein Mediaplayer kann nur einen Videoausgang verbunden haben; daher wird durch das Festlegen dieser Eigenschaft der zuvor verbundene Videoausgang ersetzt.

Wird diese Eigenschaft auf „ nullptr “ gesetzt, wird die Videoausgabe deaktiviert.

Zugriffsfunktionen:

Benachrichtigungssignal:

[read-only] videoTracks : QList<QMediaMetaData>

Listet die verfügbaren Videospuren innerhalb der Mediendatei auf.

Die zurückgegebene „ QMediaMetaData “ beschreibt die Eigenschaften der einzelnen Spuren.

Zugriffsfunktionen:

Benachrichtigungssignal: