多媒体概述
Qt 中的多媒体支持由 Qt Multimedia模块提供。Qt Multimedia 模块提供了丰富的功能集，可让您轻松利用平台的多媒体功能，如媒体播放和使用摄像头设备。
功能介绍
以下是Qt Multimedia API 的一些功能：
- 访问原始音频设备进行输入和输出。
- 播放低延迟音效。
- 播放 3D 空间音频。
- 播放播放列表中的媒体文件（如压缩音频或视频文件）。
- 录制并压缩音频
- 使用相机，包括取景器、图像捕捉和电影录制
- 将音频媒体文件解码到内存中进行处理。
多媒体组件
Qt Multimedia API 主要分为三个组件。有关每个组件的更多信息，请参阅概述页面。您还可以查看一些配方。
多媒体食谱
有关一些快速配方，请参阅本表：
| 使用案例 | 示例 | QML 类型 | C++ 类 |
|---|---|---|---|
| 播放音效 | SoundEffect | QSoundEffect | |
| 播放 3D 声音 | 声音扫描 | SpatialSound,AudioEngine | QSpatialSound,QAudioEngine |
| 播放编码音频（MP3、AAC 等） | 播放器 | MediaPlayer | QMediaPlayer |
| 播放低延迟的原始音频数据 | 音频输出 | QAudioSink | |
| 访问原始音频输入数据 | 音频源 | QAudioSource | |
| 录制编码音频数据 | 录音机 | CaptureSession,AudioInput 、MediaRecorder | QMediaCaptureSession,QAudioInput 、QMediaRecorder |
| 发现音频和视频设备 | 音频设备 | MediaDevices,audioDevice 、cameraDevice | QMediaDevices,QAudioDevice 、QCameraDevice |
| 视频播放 | 播放器，媒体播放器 | MediaPlayer,VideoOutput 、Video | QMediaPlayer,QVideoWidget 、QGraphicsVideoItem |
| 捕捉音频和视频 | 摄像机、录音机 | CaptureSession,Camera,AudioInput VideoOutput | QMediaCaptureSession,QCamera,QAudioInput 、QVideoWidget |
| 拍摄照片 | 照相机、录音机 | CaptureSession,Camera 、ImageCapture | QMediaCaptureSession,QCamera 、QImageCapture |
| 拍摄电影 | 照相机、录音机 | CaptureSession,Camera 、MediaRecorder | QMediaCaptureSession,QCamera 、QMediaRecorder |
限制
Qt Multimedia API 基于底层平台的多媒体框架。这可能意味着不同机器对各种编解码器或容器的支持会有所不同。这种支持取决于最终用户安装了哪些设备。更多详情，请参阅支持的媒体格式。
注意： Qt Multimedia API 依赖于QCoreApplication 提供的功能，使用Qt Multimedia API 创建的多媒体对象只能在此应用对象的生命周期内使用。因此，在访问任何Qt Multimedia API 之前，必须先创建QCoreApplication 、QGuiApplication 或QApplication 。如果应用程序对象被重新创建，请确保任何Qt Multimedia 对象也被重新创建。
以前版本的更改
如果您以前在 Qt 5 中使用过Qt Multimedia ，请参阅 Qt Multimedia 的更改，了解有关更改的详细信息，以及将代码移植到 Qt 6 时可能需要更改的内容。
参考文档
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
