媒体格式 QML 值类型

MediaFormat 描述了媒体文件的格式。更多信息...

导入语句	import QtMultimedia

属性

audioCodec : 枚举
fileFormat : 枚举
videoCodec : 枚举

方法

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
        }
    }
}

如果指定的媒体格式不支持，则 MediaRecorder 将自动尝试找到最佳可能的替代格式并使用该格式。

另请参阅MediaRecorder 和 CaptureSession。

属性文档

audioCodec : 枚举

描述在多媒体文件或流中使用的声音编解码器。它可以取以下值之一

属性值	描述
MediaFormat.WMA	Windows Media Audio
MediaFormat.AC3	Dolby Digital
MediaFormat.AAC	高级音频编码
MediaFormat.ALAC	Apple 无损音频编解码器
MediaFormat.DolbyTrueHD	Dolby TrueHD
MediaFormat.EAC3	Dolby Digital Plus (EAC3)
MediaFormat.MP3	MPEG-1 音频层 III 或 MPEG-2 音频层 III
MediaFormat.Wave	波形音频文件格式
MediaFormat.Vorbis	Ogg Vorbis
MediaFormat.FLAC	免费无损音频编解码器
MediaFormat.Opus	Opus 音频格式
MediaFormat.Unspecified	未指定编解码器

fileFormat : 枚举

描述在多媒体文件或流中使用的容器格式。它可以取以下值之一

属性值	描述
MediaFormat.WMA	Windows Media Audio
MediaFormat.AAC	高级音频编码
媒体格式：MediaFormat.Matroska	Matroska (MKV)
媒体格式：MediaFormat.WMV	Windows媒体视频
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第三部分或MPEG-4音频（正式ISO/IEC 14496-3）
MediaFormat.FLAC	免费无损音频编解码器
媒体格式：MediaFormat.UnspecifiedFormat	格式未指定。

videoCodec：枚举

描述多媒体文件或流中使用的视频编解码器。它可以取以下值之一

属性值	描述
媒体格式：MediaFormat.VP8	VP8
媒体格式：MediaFormat.MPEG2	MPEG-2
媒体格式：MediaFormat.MPEG1	MPEG-1
媒体格式：MediaFormat.WMV	Windows媒体视频
媒体格式：MediaFormat.H265	高效视频编码（HEVC）
媒体格式：MediaFormat.H264	高级视频编码
媒体格式：MediaFormat.MPEG4	MPEG-4
媒体格式：MediaFormat.AV1	AOMedia Video 1
媒体格式：MediaFormat.MotionJPEG	MotionJPEG
媒体格式：MediaFormat.VP9	VP9
媒体格式：MediaFormat.Theora	Theora
MediaFormat.Unspecified	视频编解码器未指定

方法文档

字符串 audioCodecDescription(codec)

返回对codec的描述。

字符串 audioCodecName(codec)

返回对codec的基于字符串的名称。

字符串 fileFormatDescription(fileFormat)

返回对fileFormat的描述。

字符串 fileFormatName(fileFormat)

返回对fileFormat的基于字符串的名称。

列表<AudioCodec> supportedAudioFormats(conversionMode)

返回所选文件格式和视频编解码器的音频编解码器列表（conversionMode）。

要获取所有支持的音频编解码器，请在对默认构建的MediaFormat运行此查询。要获取支持特定音频和视频编解码器组合的音频编解码器列表，您可以在运行此查询之前设置fileFormat和videoCodec属性。

另请参阅QMediaFormat::ConversionMode。

列表<FileFormat> supportedFileFormats(conversionMode)

返回由conversionMode指示的音频和视频编解码器的文件格式列表。

要获取所有支持的文件格式，请在对默认构建的MediaFormat运行此查询。要获取支持特定音频和视频编解码器组合的文件格式列表，您可以在运行此查询之前设置audioCodec和videoCodec属性。

另请参阅QMediaFormat::ConversionMode。

列表<VideoCodec> supportedVideoCodecs(conversionMode)

返回所选文件格式和音频编解码器的视频编解码器列表（conversionMode）。

要获取所有支持的音频编解码器，请在对默认构建的MediaFormat运行此查询。要获取支持特定文件格式和音频编解码器组合的视频编解码器列表，您可以在运行此查询之前设置fileFormat和audioCodec属性。

另请参阅QMediaFormat::ConversionMode。

字符串 videoCodecDescription(codec)

返回对codec的描述。

字符串 videoCodecName(codec)

返回对codec的基于字符串的名称。