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.15
					

若打算在应用程序中使用 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 类型以提供视频回放功能。
类 描述
QAudioOutput 把音频数据发送到音频输出设备
QAudioRecorder 从音频源录制媒体内容。
QCamera 访问摄像头取景器。
QCameraImageCapture 以摄像头捕获静止图像。
QMediaRecorder 录制摄像头或无线电调谐源的媒体内容。
QMediaPlayer 从源回放媒体。
QMediaPlaylist 要播放的媒体列表。
QAbstractVideoSurface 视频呈现基类。

许可和归属

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

指南

平台注意事项

The Qt Multimedia Backends Wiki 提供可用于此模块各平台插件的支持特征摘要。以下话题提供更多特定平台信息。

参考

范例