Qt Multimedia

Qt Multimedia findet sich ein Zusatzmodul, das eine umfangreiche Sammlung von QML-Typen und C++-Klassen zur Verarbeitung von Multimedia-Inhalten bereitstellt. Es enthält eine benutzerfreundliche API zur Wiedergabe von Audio- und Videodateien und deren Darstellung auf dem Bildschirm sowie eine umfassende API zur Aufnahme von Audio und Video aus verschiedenen Quellen, darunter Systemkameras und -mikrofone, Bildschirm- oder Fenschaufnahmen sowie Audio- oder Video-Speicherpuffer.

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 den Abschnitt „Änderungen an Qt Multimedia “.

Wenn Sie noch keine Erfahrung mit „ Qt Multimedia “ haben, können die QML-Typen mithilfe der folgenden Anweisung in Ihrer Datei „ .qml “ in eine Anwendung importiert werden.

import QtMultimedia

Um eine Verknüpfung mit den C++-Bibliotheken herzustellen, fügen Sie Folgendes in die Datei „ CMakeLists.txt “ Ihres Projekts ein. Ersetzen Sie „ mytarget “ durch den Namen Ihres Projekts.

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

Anleitungen zum Erstellen von „ Qt Multimedia “ aus dem Quellcode finden Sie unter „ Qt Multimedia aus dem Quellcode erstellen “.

Übersichten und wichtige Themen

• Änderungen in Qt 6
• Multimedia-Übersicht
• Audio-Übersicht
• Übersicht über räumliches Audio
• Video-Übersicht
• Kamera – Überblick
• Unterstützte Medienformate

QML-Typen

Die folgende Tabelle gibt einen Überblick über einige wichtige QML-Typen.

C++-Klassen

Die folgende Tabelle gibt einen Überblick über einige wichtige C++-Klassen.

Für die Wiedergabe von Audio und Video enthalten „ QMediaPlayer “, „ QAudioOutput “ und „ QVideoWidget “ alle erforderlichen Funktionen. Andere Klassen sind für die Erfassung von Audio- und Videoinhalten vorgesehen, wobei „ QMediaCaptureSession “ als zentrale Klasse dient, die den gesamten Erfassungs- und Aufzeichnungsprozess verwaltet.

Lizenzen und Namensnennungen

Das Modul „ Qt Multimedia “ ist unter kommerziellen Lizenzen von The Qt Company erhältlich. Darüber hinaus ist es unter freien Softwarelizenzen verfügbar. Seit Qt 5.6 sind diese freien Softwarelizenzen die GNU Lesser General Public License, Version 3, oder die GNU General Public License, Version 2. Weitere Details finden Sie unter „Qt-Lizenzierung “.

Darüber hinaus kann „ Qt Multimedia “ in Qt 6.12.0 Module von Drittanbietern enthalten, die unter den folgenden freizügigen Lizenzen stehen:

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

Hinweise zu Zielplattformen und Backends

Qt Multimedia bietet benutzerfreundliche, plattformübergreifende APIs für die Medienwiedergabe, -aufzeichnung und -geräteverwaltung. Die Implementierung der Kern-APIs, darunter QMediaDevices, QAudioDevice, QSoundEffect, QAudioSink und QAudioSource, ist in die Hauptbibliothek „ Qt Multimedia “ integriert, sodass keine zusätzlichen Bibliotheken erforderlich sind. Andere Qt Multimedia -APIs werden mithilfe von Plugin-Bibliotheken implementiert, die als Medien-Backends bezeichnet werden. Das auf FFmpeg basierende Haupt-Medien-Backend gewährleistet nahtlose plattformübergreifende Funktionalität und ist auf allen Plattformen außer WebAssembly und eingebettetem Linux/Boot2Qt die Standardeinstellung. Bei Boot2Qt basiert das Standard-Backend auf GStreamer, das FFmpeg-Medien-Backend kann jedoch mithilfe der Umgebungsvariable „ QT_MEDIA_BACKEND “ aktiviert werden.

Das FFmpeg-Backend

Das FFmpeg-Medien-Backend stützt sich auf die FFmpeg-9.0.1-Bibliotheken, die im „ Qt Online Installer “ enthalten sind und von den Betreuern getestet wurden. Die Binärpakete aus dem Online-Installationsprogramm nutzen eine dynamische Verknüpfung mit FFmpeg. Daher müssen Anwendungen entweder FFmpeg-Binärdateien in ihrem Installationsprogramm bündeln oder davon ausgehen, dass FFmpeg auf dem Betriebssystem installiert ist. Die FFmpeg-Bibliotheken werden automatisch mithilfe der Qt-Bereitstellungstools bereitgestellt, wie in der Dokumentation „Bereitstellung von Qt-Anwendungen“ beschrieben, mit Ausnahme von Linux/X11. Anwendungen können auch ihre eigene FFmpeg-Version bereitstellen, entweder als gemeinsam genutzte oder als statische Bibliotheken, vorausgesetzt, die Hauptversion von FFmpeg stimmt mit der von Qt verwendeten Version überein.

Zwar nutzt „ Qt Multimedia “ auf den meisten Betriebssystemen das FFmpeg-Medien-Backend, doch können plattformspezifische funktionale oder visuelle Unterschiede zwischen Anwendungen auf verschiedenen Plattformen auftreten. FFmpeg bietet nicht auf allen Plattformen identische Codec- und Formatunterstützung, und die Leistung von „ Qt Multimedia “-Funktionen kann von der Hardwareunterstützung abhängen, die nur auf bestimmten Plattformen verfügbar ist. Beispielsweise treten bei FFmpeg spezifische Probleme mit der Hardwarebeschleunigung auf Linux-Zielsystemen mit ARM-Architekturen auf. Daher wird empfohlen, „ Qt Multimedia “-Anwendungen auf allen Zielplattformen zu testen.

Um die Entwicklung und Fehlerbehebung zu vereinfachen, lassen sich einige FFmpeg-Funktionen über Umgebungsvariablen konfigurieren, die Teil der privaten „ Qt Multimedia “-API sind.

Native Backends

Zur Kompatibilität mit bestehenden Anwendungen pflegen wir für jedes Betriebssystem native Medien-Backends:

• GStreamer-Backend auf Embedded Linux
• AVFoundation unter macOS und iOS
• Windows Media Foundation unter Windows (seit Qt 6.10 veraltet)
• MediaCodec-Framework auf Android
• WebAudio und WebVideo auf WebAssembly

Die Qt-Betreuer werden sich bemühen, kritische Probleme mit den nativen Backends zu beheben, garantieren jedoch nicht die Behebung kleinerer Probleme, einschließlich plattformübergreifender Inkonsistenzen. Neue Funktionen werden ausschließlich im FFmpeg-Medien-Backend implementiert, mit Ausnahme von WebAssembly.

Das GStreamer-Backend verfügt über einige private APIs, die eine feinere Steuerung ermöglichen. Es sind jedoch Fehler im GStreamer-Backend bekannt. Weitere Details finden Sie in den Plattformhinweisen zum GStreamer-Backend.

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

Wechseln des Backends

Bei Problemen mit dem standardmäßigen FFmpeg-Backend empfehlen wir, ein natives Backend zu testen. Sie können zu nativen Backends wechseln, indem Sie die Umgebungsvariable ` QT_MEDIA_BACKEND ` auf ` windows`, ` gstreamer ` (unter Embedded Linux), ` darwin ` (unter macOS und iOS) oder ` android` setzen:

export QT_MEDIA_BACKEND=darwin

Um FFmpeg als Backend zu erzwingen, setzen Sie die Variable auf „ ffmpeg “:

export QT_MEDIA_BACKEND=ffmpeg

In der Kompilierungsphase von „ Qt Multimedia “ kann das Standard-Medien-Backend über die CMake-Variable „ QT_DEFAULT_MEDIA_BACKEND “ konfiguriert werden.

Hinweise zu den Zielplattformen

Auf den folgenden Seiten sind Probleme für bestimmte Zielplattformen aufgeführt.

• macOS und iOS
• WebAssembly
• Windows
• Linux
• GStreamer-Backend für Embedded-Linux

Berechtigungen

Ab Qt 6.6 nutzt das Modul „ Qt Multimedia “ die neue API „ QPermission “, um die Berechtigungen „ camera “ und „ microphone “ zu verwalten. Das bedeutet, dass Qt selbst diese Berechtigungen nicht mehr abfragt; dies muss daher direkt von der Client-Anwendung aus erfolgen.

Ein Beispiel für die Integration der neuen „ QPermission “-API in die Anwendung finden Sie auf der Seite „Anwendungsberechtigungen “.

Referenz und Beispiele

• QML Types
• C++-Klassen
• Beispiele