Qt Multimedia

Qt Multimedia is an essential module that provides a rich set of QML types and C++ classes to handle multimedia content. It also provides necessary APIs to access the camera and radio functionality. The included Qt Audio Engine provides types for 3D positional audio playback and content management.


Qt Multimedia 提供多媒体特定用例 API。
Qt Multimedia Widgets 提供基于 Widgets 的多媒体 API。


The QML types can be imported into your applciation using the following import statement in your .qml 文件。

import QtMultimedia 5.12

If you intend to use the C++ classes in your application, include the C++ definitions using the following directive:

#include <QtMultimedia>
#include <QtMultimediaWidgets>

注意: If you are using a few classes from this module, we recommend including those specific classes only instead of the module.

要链接到相应 C++ 库,添加以下到 qmake 工程文件:

QT += multimedia multimediawidgets

QML 类型和 C++ 类

以下是由本模块提供的重要 QML 类型和 C++ 类列表:

Type 描述
Audio 把音频回放功能添加到场景
Playlist 用于指定要播放媒体的列表。
Camera 访问摄像头取景器帧
MediaPlayer Add media playback functionality to a scene. It is same as Audio type, but can be used for video playback with the VideoOutput 类型。
Radio 访问无线电功能
Video 把视频回放功能添加到场景。它使用 MediaPlayer and VideoOutput types to provide video playback functionality.
Class 描述
QAudioOutput 把音频数据发送到音频输出设备
QAudioRecorder 从音频源录制媒体内容。
QCamera 访问摄像头取景器。
QCameraImageCapture 以摄像头捕获静止图像。
QMediaRecorder 录制摄像头或无线电调谐源的媒体内容。
QMediaPlayer 从源回放媒体。
QMediaPlaylist 要播放的媒体列表。
QRadioTuner 访问无线电设备。
QAbstractVideoSurface 视频呈现基类。


Qt Quick Multimedia 模块在商业许可下是可用的来自 Qt 公司 。此外,它在自由软件许可下是可用的。从 Qt 5.4 起,这些自由软件许可是 GNU LGPL (次一般公共许可) 第 3 版 ,或 GNU GPL (一般公共许可) 第 2 版 。见 Qt 许可 进一步了解细节。



Qt Multimedia Backends wiki provides a summary of features supported by each platform plugin made available by this module. The following topics provide more platform-specific information.