Qt Multimedia

Qt Multimedia 是提供一组丰富 QML 类型和 C++ 类来处理多媒体内容的必需模块。它还提供访问摄像头和无线电功能的必要 API。包括 Qt Audio Engine 提供用于 3D 位置音频回放和内容管理的类型。

该模块功能分为下列子模块:

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

快速入门

可以将 QML 类型导入应用程序使用以下 import 语句在 .qml 文件。

import QtMultimedia 5.12
					

若打算在应用程序中使用 C++ 类,包括 C++ 定义使用以下伪指令:

#include <QtMultimedia>
#include <QtMultimediaWidgets>
					

注意: 若正在使用来自此模块的一些类,推荐仅包括那些特定类而不是模块。

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

QT += multimedia multimediawidgets
					

QML 类型和 C++ 类

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

类型 描述
Audio 把音频回放功能添加到场景
Playlist 用于指定要播放媒体的列表。
Camera 访问摄像头取景器帧
MediaPlayer 向场景添加媒体回放功能。它如同 Audio 类型,但可以用于视频回放采用 VideoOutput 类型。
Radio 访问无线电功能
Video 把视频回放功能添加到场景。它使用 MediaPlayer and VideoOutput 类型以提供视频回放功能。
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 提供可用于此模块各平台插件的支持特征摘要。以下话题提供更多特定平台信息。

参考

范例