mediaFormat QML Value Type
MediaFormat 描述了媒体文件的格式。更多内容...
| Import Statement: | import QtMultimedia |
属性
- audioCodec : enumeration
- fileFormat : enumeration
- videoCodec : enumeration
方法
- string audioCodecDescription(codec)
- string audioCodecName(codec)
- string fileFormatDescription(fileFormat)
- string fileFormatName(fileFormat)
- list<AudioCodec> supportedAudioFormats(conversionMode)
- list<FileFormat> supportedFileFormats(conversionMode)
- list<VideoCodec> supportedVideoCodecs(conversionMode)
- string videoCodecDescription(codec)
- string videoCodecName(codec)
详细说明
MediaFormat 类型用于描述媒体文件的格式。它包含三个属性,用于描述文件类型以及所使用的音频和视频编解码器。
MediaFormat 可用于指定MediaRecorder 应创建的文件类型。下面的代码片段展示了一个示例,该示例将录像机配置为创建带有 AAC 编码音频和 H265 视频的 mpeg4 视频:
CaptureSession {
... // setup inputs
MediaRecorder {
mediaFormat {
fileFormat: MediaFormat.MPEG4
audioCodec: MediaFormat.AudioCodec.AAC
videoCodec: MediaFormat.VideoCodec.H265
}
}
}如果指定的 mediaFormat 不受支持,MediaRecorder 将自动尝试查找最佳的替代格式并使用该格式。
另请参阅 MediaRecorder 和CaptureSession 。
属性文档
audioCodec : enumeration
描述多媒体文件或流中使用的音频编解码器。该属性可取以下值之一:
| 属性值 | 描述 |
|---|---|
| MediaFormat.WMA | Windows Media Audio |
| MediaFormat.AC3 | 杜比数字 |
| MediaFormat.AAC | 高级音频编码 |
| MediaFormat.ALAC | Apple 无损音频编解码器 |
| MediaFormat.DolbyTrueHD | 杜比TrueHD |
| MediaFormat.EAC3 | 杜比数字增强版 (EAC3) |
| MediaFormat.MP3 | MPEG-1 音频层 III 或 MPEG-2 音频层 III |
| MediaFormat.Wave | 波形音频文件格式 |
| MediaFormat.Vorbis | Ogg Vorbis |
| MediaFormat.FLAC | 免费无损音频编解码器 |
| MediaFormat.Opus | Opus 音频格式 |
| MediaFormat.Unspecified | 未指定的编解码器 |
fileFormat : enumeration
描述多媒体文件或流中使用的容器格式。该属性可取以下值之一:
| 属性值 | 描述 |
|---|---|
| MediaFormat.WMA | Windows Media Audio |
| MediaFormat.AAC | 高级音频编码 |
| MediaFormat.Matroska | Matroska (MKV) |
| MediaFormat.WMV | Windows Media Video |
| MediaFormat.MP3 | MPEG-1 音频层 III 或 MPEG-2 音频层 III |
| MediaFormat.Wave | 波形音频文件格式 |
| MediaFormat.Ogg | Ogg |
| MediaFormat.MPEG4 | MPEG-4 |
| MediaFormat.AVI | 音频视频交错格式 |
| MediaFormat.QuickTime | QuickTime |
| MediaFormat.WebM | WebM |
| MediaFormat.Mpeg4Audio | MPEG-4 第3部分或 MPEG-4 音频(正式名称为 ISO/IEC 14496-3) |
| MediaFormat.FLAC | 免费无损音频编解码器 |
| MediaFormat.UnspecifiedFormat | 该格式未指定。 |
videoCodec : enumeration
描述多媒体文件或流中使用的视频编解码器。该属性可取以下值之一:
| 属性值 | 描述 |
|---|---|
| MediaFormat.VP8 | VP8 |
| MediaFormat.MPEG2 | MPEG-2 |
| MediaFormat.MPEG1 | MPEG-1 |
| MediaFormat.WMV | Windows Media Video |
| MediaFormat.H265 | 高效视频编码 (HEVC) |
| MediaFormat.H264 | 高级视频编码 |
| MediaFormat.MPEG4 | MPEG-4 |
| MediaFormat.AV1 | AOMedia 视频 1 |
| MediaFormat.MotionJPEG | MotionJPEG |
| MediaFormat.VP9 | VP9 |
| MediaFormat.Theora | Theora |
| MediaFormat.Unspecified | 未指定视频编解码器 |
方法文档
string audioCodecDescription(codec)
返回codec 的描述。
string audioCodecName(codec)
返回codec 的字符串名称。
string fileFormatDescription(fileFormat)
返回fileFormat 的描述。
string fileFormatName(fileFormat)
返回fileFormat 的字符串名称。
list<AudioCodec> supportedAudioFormats(conversionMode)
返回所选文件格式和视频编解码器(conversionMode )对应的音频编解码器列表。
要获取所有受支持的音频编解码器,请在默认构造的 MediaFormat 上运行此查询。要获取特定文件格式与视频编解码器组合所支持的音频编解码器列表,可以在运行此查询之前设置fileFormat 和videoCodec 属性。
另请参阅 QMediaFormat::ConversionMode 。
list<FileFormat> supportedFileFormats(conversionMode)
返回由conversionMode 指定的音频和视频编解码器所支持的文件格式列表。
要获取所有受支持的文件格式,请在默认构造的 MediaFormat 上运行此查询。要获取支持特定音频和视频编解码器组合的文件格式列表,可以在运行此查询之前设置audioCodec 和videoCodec 属性。
另请参阅 QMediaFormat::ConversionMode 。
list<VideoCodec> supportedVideoCodecs(conversionMode)
返回所选文件格式和音频编解码器(conversionMode )对应的视频编解码器列表。
要获取所有受支持的视频编解码器,请在默认构造的 MediaFormat 上运行此查询。要获取特定文件格式和音频编解码器组合所支持的视频编解码器列表,可以在运行此查询之前设置fileFormat 和audioCodec 属性。
另请参阅 QMediaFormat::ConversionMode 。
string videoCodecDescription(codec)
返回codec 的描述。
string videoCodecName(codec)
返回codec 的字符串形式的名称。
© 2026 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.