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(50);
player->play();

Dokumentation der Eigenschaft

activeAudioTrack : int

Gibt die derzeit aktive Tonspur zurück.

Standardmäßig wird die erste verfügbare Tonspur gewählt.

Setzen Sie index auf -1, um alle Tonspuren 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 gewählt.

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

Zugriffsfunktionen:

Benachrichtigungssignal:

[since 6.8] audioBufferOutput : QAudioBufferOutput*

Diese Eigenschaft enthält den vom Mediaplayer verwendeten Ausgabe-Audiopuffer.

Legt einen Audiopuffer output für den Media Player fest.

Wenn QAudioBufferOutput angegeben ist und die Medienquelle einen Audiostrom enthält, gibt der Medienplayer das Signal QAudioBufferOutput::audioBufferReceived mit Audiopuffern aus, die dekodierte Audiodaten enthalten. Am Ende des Audiostroms gibt QMediaPlayer ein leeres QAudioBuffer aus.

QMediaPlayer Der Media Player gibt die Audiopuffer gleichzeitig mit den passenden Daten an den Audioausgang aus, sofern dieser angegeben ist. Der Ton kann jedoch aufgrund der Audiopufferung mit einer kleinen Verzögerung abgespielt werden.

Das Format der ausgegebenen Audiopuffer wird aus dem angegebenen output oder aus dem passenden Audiostrom übernommen, wenn output ein ungültiges Format zurückgibt. Die ausgegebenen Audiodaten werden nicht in Abhängigkeit von der aktuellen Wiedergaberate skaliert.

Potenzielle Anwendungsfälle für die Verwendung von QAudioBufferOutput mit QMediaPlayer könnten sein:

• Audio-Visualisierung. Wenn die Wiedergaberate des Mediaplayers nicht 1 ist, können Sie die Abmessungen des ausgegebenen Bildes oder das Bildaktualisierungsintervall entsprechend den Anforderungen des Visualisierers skalieren.
• Beliebige KI-Tonverarbeitung, z. B. Spracherkennung.
• Senden der Daten an einen externen Audioausgang. Die Änderung der Wiedergaberate, die Synchronisierung mit dem Video und die manuelle Spülung beim Anhalten und Suchen sollten in Betracht gezogen werden. Wir empfehlen nicht, den Audiopufferausgang für diesen Zweck zu verwenden, es sei denn, Sie haben einen triftigen Grund dafür.

Diese Eigenschaft wurde in Qt 6.8 eingeführt.

Zugriffsfunktionen:

Notifier Signal:

audioOutput : QAudioOutput*

Diese Eigenschaft enthält das vom Medienplayer verwendete Audioausgabegerät.

Die aktuelle Audioausgabe, die bei der Wiedergabe von Medien verwendet wird. Das Setzen eines neuen Audioausgangs ersetzt den aktuell verwendeten Ausgang.

Wenn Sie diese Eigenschaft auf nullptr setzen, werden alle Audioausgänge deaktiviert.

Zugriffsfunktionen:

Benachrichtigungssignal:

[read-only] audioTracks : const QList<QMediaMetaData>

Listet die Menge der verfügbaren Audiospuren innerhalb des Mediums auf.

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

Verschiedene Audiospuren können zum Beispiel Audio in verschiedenen Sprachen enthalten.

Zugriffsfunktionen:

Notifier Signal:

[read-only] bufferProgress : const float

Diese Eigenschaft enthält den Prozentsatz des temporären Puffers, der gefüllt ist, bevor die Wiedergabe beginnt oder fortgesetzt wird, von 0(leer) bis 1(voll).

Wenn das Player-Objekt puffert, enthält diese Eigenschaft den Prozentsatz des temporären Puffers, der gefüllt ist. Der Puffer muss zu 100 % gefüllt sein, bevor die Wiedergabe beginnen oder fortgesetzt werden kann. Zu diesem Zeitpunkt gibt mediaStatus() BufferedMedia oder BufferingMedia zurück. Wenn der Wert niedriger als 100 ist, gibt mediaStatus() StalledMedia zurück.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch mediaStatus().

[read-only] duration : const qint64

Diese Eigenschaft enthält die Dauer des aktuellen Mediums.

Der Wert ist die Gesamtwiedergabezeit des aktuellen Mediums in Millisekunden. Der Wert kann sich während der Lebensdauer des QMediaPlayer Objekts ändern und ist möglicherweise nicht verfügbar, wenn die erste Wiedergabe beginnt. Verbinden Sie sich mit dem Signal durationChanged(), um Statusbenachrichtigungen zu erhalten.

Zugriffsfunktionen:

Benachrichtigungssignal:

[read-only] error : const Error

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

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch error().

[read-only] errorString : const QString

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

Zugriffsfunktionen:

Melder-Signal:

[read-only] hasAudio : const bool

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

Zugriffsfunktionen:

Benachrichtigungssignal:

[read-only] hasVideo : const bool

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

Zugriffsfunktionen:

Benachrichtigungssignal:

loops : int

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

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

Zugriffsfunktionen:

Benachrichtigungssignal:

[read-only] mediaStatus : const MediaStatus

Diese Eigenschaft enthält den Status des aktuellen Medienstroms.

Der Stream-Status beschreibt, wie die Wiedergabe des aktuellen Streams abläuft.

Standardmäßig ist diese Eigenschaft QMediaPlayer::NoMedia

Zugriffsfunktionen:

Benachrichtigungssignal:

[read-only] metaData : const QMediaMetaData

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.

Zugriffsfunktionen:

Benachrichtigungssignal:

playbackRate : qreal

Diese Eigenschaft enthält die Wiedergaberate des aktuellen Mediums.

Dieser Wert ist ein Multiplikator, der auf die Standard-Wiedergabegeschwindigkeit des Mediums angewendet wird. Standardmäßig ist dieser Wert 1,0, was bedeutet, dass das Medium mit der Standardgeschwindigkeit abgespielt 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 Wiedergaberate. Der Status und die Qualität von Audio- und Videodaten beim schnellen Vorlauf oder Rücklauf wird durch den Rahmen definiert.

Zugriffsfunktionen:

Benachrichtigungssignal:

[read-only] playbackState : const PlaybackState

Gibt die PlaybackState zurück.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch playing.

[read-only, since 6.5] playing : const bool

Diese Eigenschaft gibt an, ob das Medium abgespielt wird.

Diese Eigenschaft wurde in Qt 6.5 eingeführt.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch playbackState und PlayingState.

position : qint64

Diese Eigenschaft enthält die Abspielposition des aktuellen Mediums.

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 wahr ist, kann diese Eigenschaft auf Millisekunden gesetzt werden.

Zugriffsfunktionen:

Benachrichtigungssignal:

[read-only] seekable : const bool

Diese Eigenschaft enthält den Status der Suchbarkeit des aktuellen Mediums

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

Zugriffsfunktionen:

Signal "Notifier":

source : QUrl

Diese Eigenschaft enthält die aktive Medienquelle, die vom Playerobjekt verwendet wird.

Das Player-Objekt verwendet QUrl für die Auswahl des abzuspielenden Inhalts.

Standardmäßig hat diese Eigenschaft den Wert null QUrl.

Wenn diese Eigenschaft auf null QUrl gesetzt wird, verwirft der Player alle Informationen zur aktuellen Medienquelle und stellt alle E/A-Vorgänge in Bezug auf diese Medien ein.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch QUrl.

[read-only] subtitleTracks : const QList<QMediaMetaData>

Listet die Menge der verfügbaren Untertitelspuren innerhalb des Mediums auf.

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

Zugriffsfunktionen:

Benachrichtigungssignal:

videoOutput : QObject*

Diese Eigenschaft enthält den Videoausgang, der vom Media Player verwendet werden soll.

Ein Mediaplayer kann nur einen Videoausgang haben, daher wird durch das Setzen dieser Eigenschaft der zuvor angeschlossene Videoausgang ersetzt.

Wenn Sie diese Eigenschaft auf nullptr setzen, wird die Videoausgabe deaktiviert.

Zugriffsfunktionen:

Benachrichtigungssignal:

[read-only] videoTracks : const QList<QMediaMetaData>

Listet die Menge der verfügbaren Videospuren innerhalb des Mediums auf.

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

Zugriffsfunktionen:

Benachrichtigungssignal: