Qt Multimedia

Qt Multimedia ist ein Zusatzmodul, das einen umfangreichen Satz von QML-Typen und C++-Klassen für den Umgang mit Multimedia-Inhalten bietet. Es enthält eine einfach zu verwendende API für die Wiedergabe von Audio- und Videodateien und deren Darstellung auf dem Bildschirm sowie eine umfassende API für die Aufnahme von Audio- und Videodaten aus verschiedenen Quellen, einschließlich Systemkameras und Mikrofonen, Bildschirm- oder Fensteraufnahmen und Audio- oder Videospeicherpuffern.

Die Funktionalität dieses Moduls ist in die folgenden Untermodule unterteilt:

Erste Schritte

Wenn Sie von Qt 5 auf Qt 6 portieren, lesen Sie bitte Änderungen an Qt Multimedia.

Wenn Sie neu bei Qt Multimedia sind, können Sie die QML-Typen in eine Anwendung importieren, indem Sie die folgende Anweisung in Ihrer .qml Datei verwenden.

import QtMultimedia

Um gegen die C++-Bibliotheken zu linken, fügen Sie die folgende Anweisung in die CMakeLists.txt Datei Ihres Projekts ein. Ersetzen Sie my_project durch den Namen Ihres Projekts.

find_package(Qt6 REQUIRED COMPONENTS Multimedia)
target_link_libraries(my_project PRIVATE Qt6::Multimedia)

Eine Anleitung zum Erstellen von Qt Multimedia aus den Quellen finden Sie unter Qt Multimedia aus den Quellen erstellen.

Übersichten und wichtige Themen

• Änderungen in Qt 6
• Multimedia-Übersicht
• Audio-Übersicht
• Überblick über Spatial Audio
• Video-Übersicht
• Kamera-Übersicht
• Unterstützte Medienformate

QML-Typen

In der folgenden Tabelle sind einige wichtige QML-Typen aufgeführt.

C++-Klassen

In der folgenden Tabelle sind einige wichtige C++-Klassen aufgeführt.

Für die Wiedergabe von Audio und Video enthalten die Klassen QMediaPlayer, QAudioOutput und QVideoWidget alle notwendigen Funktionen. Andere Klassen sind der Aufnahme von Audio- und Videoinhalten gewidmet, wobei QMediaCaptureSession als zentrale Klasse dient, die den gesamten Aufnahme- und Aufzeichnungsprozess verwaltet.

Lizenzen und Namensnennung

Das Modul Qt Multimedia ist unter kommerziellen Lizenzen von The Qt Company erhältlich. Darüber hinaus ist es unter freien Software-Lizenzen verfügbar. Seit Qt 5.6 sind diese Lizenzen für freie Software die GNU Lesser General Public License, Version 3, oder die GNU General Public License, Version 2. Siehe Qt Licensing für weitere Details.

Darüber hinaus kann Qt Multimedia in Qt 6.8.2 Module von Drittanbietern unter den folgenden zulässigen Lizenzen enthalten:

Beachten Sie, dass Videokompressionsstandards, wie z. B. der H.264-Medienkompressionsstandard, durch Patente abgedeckt sein können und Lizenzgebühren anfallen können. Dies kann für jede Implementierung gelten, auch wenn die Implementierung als Betriebssystemdienst, durch eine Bibliothek eines Drittanbieters oder eines der Backends von Qt Multimedia bereitgestellt wird. Die Qt-Lizenzen decken solche Gebühren nicht ab.

Hinweise zu Zielplattform und Backend

Qt Multimedia bietet benutzerfreundliche, plattformübergreifende APIs für Medienwiedergabe, Aufnahme und Geräteverwaltung. Die Implementierung der Kern-APIs, einschließlich QMediaDevices, QAudioDevice, QSoundEffect, QAudioSink und QAudioSource, sind in die Hauptbibliothek Qt Multimedia integriert, so dass keine zusätzlichen Bibliotheken erforderlich sind. Andere APIs von Qt Multimedia werden mithilfe von Plugin-Bibliotheken implementiert, die als Medien-Backends bekannt sind. Das Hauptmedien-Backend, das auf FFmpeg aufbaut, gewährleistet eine nahtlose plattformübergreifende Funktionalität und ist die Standardeinstellung auf allen Plattformen außer WebAssembly und Embedded Linux/Boot2Qt. Bei Boot2Qt basiert das Standard-Backend auf GStreamer, aber das FFmpeg-Media-Backend kann über die Umgebungsvariable QT_MEDIA_BACKEND aktiviert werden.

Das FFmpeg-Backend

Das FFmpeg-Media-Backend basiert auf den FFmpeg 7.1-Bibliotheken, die in Qt Online Installer enthalten und von den Betreuern getestet sind. Die Binärpakete des Online-Installers verwenden dynamisches Linking zu FFmpeg. Daher müssen Anwendungen entweder FFmpeg-Binärdateien in ihrem Installationsprogramm bündeln oder davon abhängen, dass FFmpeg auf dem Betriebssystem installiert ist. Die FFmpeg-Bibliotheken werden automatisch mit den Qt-Bereitstellungswerkzeugen bereitgestellt, wie in der Dokumentation Bereitstellung von Qt-Anwendungen beschrieben, außer für Linux/X11. Anwendungen können auch ihren eigenen Build von FFmpeg bereitstellen, entweder als gemeinsam genutzte oder statische Bibliotheken, vorausgesetzt die FFmpeg-Hauptversion stimmt mit der von Qt verwendeten Version überein.

Während Qt Multimedia das FFmpeg Media Backend auf den meisten Betriebssystemen nutzt, können plattformspezifische funktionale oder visuelle Unterschiede zwischen Anwendungen auf verschiedenen Plattformen auftreten. FFmpeg bietet nicht auf allen Plattformen eine identische Codec- und Formatunterstützung, und die Leistung der Funktionen von Qt Multimedia kann von der Hardwareunterstützung abhängen, die nur auf bestimmten Plattformen verfügbar ist. So hat FFmpeg beispielsweise spezielle Probleme mit der Hardware-Beschleunigung auf Linux-Zielen mit ARM-Architekturen. Es wird daher empfohlen, Qt Multimedia Anwendungen auf allen Zielplattformen zu testen.

Um die Entwicklung und Fehlersuche zu erleichtern, sind einige FFmpeg-Funktionen über Umgebungsvariablen konfigurierbar, die Teil der privaten Qt Multimedia API sind.

Native Backends

Um die Kompatibilität mit bestehenden Anwendungen zu gewährleisten, bieten wir native Medien-Backends für jedes Betriebssystem an:

• GStreamer unter Linux
• AVFoundation für macOS und iOS
• Windows Media Foundation für Windows
• MediaCodec-Framework für Android

Die Qt-Maintainer bemühen sich, kritische Probleme mit den nativen Backends zu beheben, garantieren aber nicht die Behebung kleinerer Probleme, einschließlich inkonsistentem Verhalten auf verschiedenen Plattformen. Neue Funktionen werden nur im FFmpeg Media Backend implementiert.

Das GStreamer-Backend verfügt über einige private APIs, die eine feinere Steuerung ermöglichen. Es gibt jedoch bekannte Fehler im GStreamer-Backend. Weitere Einzelheiten finden Sie unter GStreamer.

Backend-Einschränkungen werden dokumentiert, und ihr Status wird in den jeweiligen Klassen gepflegt.

Wechseln von Backends

Im Falle von Problemen mit dem Standard-FFmpeg-Backend empfehlen wir, mit einem nativen Backend zu testen. Sie können zu nativen Backends wechseln, indem Sie die Umgebungsvariable QT_MEDIA_BACKEND auf windows, gstreamer (unter Linux), darwin (unter macOS und iOS) oder android setzen:

export QT_MEDIA_BACKEND=darwin

Um die Zuweisung von FFmpeg als das verwendete Backend zu erzwingen, setzen Sie die Variable auf ffmpeg:

export QT_MEDIA_BACKEND=ffmpeg

In der Kompilierungsphase Qt Multimedia kann das Standard-Medien-Backend über die cmake-Variable QT_DEFAULT_MEDIA_BACKEND konfiguriert werden.

Hinweise zur Zielplattform

Auf den folgenden Seiten werden Probleme für bestimmte Zielplattformen aufgeführt, die nicht mit dem Multimedia-Backend zusammenhängen.

• Windows
• macOS und iOS
• WebAssembly
• Linux unter Verwendung des Wayland-Compositors

Berechtigungen

Ab Qt 6.6 verwendet das Qt Multimedia Modul die neue QPermission API, um camera und microphone Berechtigungen zu behandeln. Das bedeutet, dass Qt selbst diese Berechtigungen nicht mehr abfragt, so dass dies direkt in der Client-Anwendung erfolgen muss.

Auf der Seite Anwendungsberechtigungen finden Sie ein Beispiel für die Integration der neuen QPermission API in die Anwendung.

Referenz und Beispiele

• QML Types
• C++-Klassen
• Beispiele