内容

• 公共类型
• 特性
• 公共函数
• 静态公共成员
• 详细描述

QMediaFormat 类

描述多媒体文件 (或流) 的编码格式。 更多...

头：	#include <QMediaFormat>
CMake:	find_package(Qt6 COMPONENTS Multimedia REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Multimedia)
qmake:	QT += multimedia

• 所有成员列表，包括继承成员

公共类型

enum class	AudioCodec { WMA, AC3, AAC, ALAC, DolbyTrueHD, …, Unspecified }
enum	ConversionMode { Encode, Decode }
enum	FileFormat { WMA, AAC, Matroska, WMV, MP3, …, UnspecifiedFormat }
enum	ResolveFlags { NoFlags, RequiresVideo }
enum class	VideoCodec { VP8, MPEG2, MPEG1, WMV, H265, …, Unspecified }

特性

• audioCodec : AudioCodec
• fileFormat : FileFormat
• videoCodec : VideoCodec

公共函数

	QMediaFormat (QMediaFormat && other )
	QMediaFormat (const QMediaFormat & other )
	QMediaFormat (QMediaFormat::FileFormat format = UnspecifiedFormat)
QMediaFormat &	operator= (QMediaFormat && other )
QMediaFormat &	operator= (const QMediaFormat & other )
	~QMediaFormat ()
QMediaFormat::AudioCodec	audioCodec () const
QMediaFormat::FileFormat	fileFormat () const
bool	isSupported (QMediaFormat::ConversionMode mode ) const
QMimeType	mimeType () const
void	resolveForEncoding (QMediaFormat::ResolveFlags flags )
void	setAudioCodec (QMediaFormat::AudioCodec codec )
void	setFileFormat (QMediaFormat::FileFormat f )
void	setVideoCodec (QMediaFormat::VideoCodec codec )
QList<QMediaFormat::AudioCodec>	supportedAudioCodecs (QMediaFormat::ConversionMode m )
QList<QMediaFormat::FileFormat>	supportedFileFormats (QMediaFormat::ConversionMode m )
QList<QMediaFormat::VideoCodec>	supportedVideoCodecs (QMediaFormat::ConversionMode m )
QMediaFormat::VideoCodec	videoCodec () const

静态公共成员

QString	audioCodecDescription (QMediaFormat::AudioCodec codec )
QString	audioCodecName (QMediaFormat::AudioCodec codec )
QString	fileFormatDescription (QMediaFormat::FileFormat fileFormat )
QString	fileFormatName (QMediaFormat::FileFormat fileFormat )
QString	videoCodecDescription (QMediaFormat::VideoCodec codec )
QString	videoCodecName (QMediaFormat::VideoCodec codec )

详细描述

QMediaFormat 描述多媒体文件 (或流) 的编码格式。

You can check whether a certain media format can be used for encoding or decoding using QMediaFormat.

成员类型文档编制

enum class QMediaFormat:: AudioCodec

Describes the audio codec used in multimedia file or stream.

常量	值	描述
QMediaFormat::AudioCodec::WMA	9	WMA (Windows 媒体音频)
QMediaFormat::AudioCodec::AC3	2	杜比数字
QMediaFormat::AudioCodec::AAC	1	AAC (高级音频编码)
QMediaFormat::AudioCodec::ALAC	10	ALAC (Apple 无损音频编解码器)
QMediaFormat::AudioCodec::DolbyTrueHD	5	杜比 TrueHD
QMediaFormat::AudioCodec::EAC3	3	杜比数字 + (EAC3)
QMediaFormat::AudioCodec::MP3	0	MPEG-1 音频层 III (或 MPEG-2 音频层 III)
QMediaFormat::AudioCodec::Wave	8	波形音频文件格式
QMediaFormat::AudioCodec::Vorbis	7	Ogg Vorbis
QMediaFormat::AudioCodec::FLAC	4	FLAC (自由无损音频编解码器)
QMediaFormat::AudioCodec::Opus	6	Opus 音频格式
QMediaFormat::AudioCodec::Unspecified	-1	未指定编解码器

enum QMediaFormat:: ConversionMode

In many cases, systems have asymmetric capabilities and can often decode more formats or codecs than can be encoded. This enum describes the requested conversion mode to be used when checking whether a certain file format or codec is supported.

常量	值	描述
QMediaFormat::Encode	0	Used to check whether a certain file format or codec can be encoded.
QMediaFormat::Decode	1	Used to check whether a certain file format or codec can be decoded.

另请参阅 supportedFileFormats , supportedAudioCodecs ，和 supportedVideoCodecs .

enum QMediaFormat:: FileFormat

Describes the container format used in a multimedia file or stream.

常量	值	描述
QMediaFormat::WMA	9	WMA (Windows 媒体音频)
QMediaFormat::AAC	8	AAC (高级音频编码)
QMediaFormat::Matroska	2	Matroska (MKV)
QMediaFormat::WMV	0	WMV (Windows 媒体视频)
QMediaFormat::MP3	10	MPEG-1 音频层 III (或 MPEG-2 音频层 III)
QMediaFormat::Wave	12	波形音频文件格式
QMediaFormat::Ogg	4	Ogg
QMediaFormat::MPEG4	3	MPEG-4
QMediaFormat::AVI	1	AVI (音频视频交错)
QMediaFormat::QuickTime	5	QuickTime
QMediaFormat::WebM	6	WebM
QMediaFormat::Mpeg4Audio	7	MPEG-4 第 3 部分或 MPEG-4 音频 (正式 ISO/IEC 14496-3)
QMediaFormat::FLAC	11	FLAC (自由无损音频编解码器)
QMediaFormat::UnspecifiedFormat	-1	The format is unspecified.

enum QMediaFormat:: ResolveFlags

Describes the requirements for resolving a suitable format for QMediaRecorder .

常量	值	描述
QMediaFormat::NoFlags	0	No requirements
QMediaFormat::RequiresVideo	1	A video codec is required

另请参阅 resolveForEncoding ().

enum class QMediaFormat:: VideoCodec

Describes the video coded used in multimedia file or stream.

常量	值	描述
QMediaFormat::VideoCodec::VP8	5	VP8
QMediaFormat::VideoCodec::MPEG2	1	MPEG-2
QMediaFormat::VideoCodec::MPEG1	0	MPEG-1
QMediaFormat::VideoCodec::WMV	9	WMV (Windows 媒体视频)
QMediaFormat::VideoCodec::H265	4	High Efficiency Video Coding (HEVC)
QMediaFormat::VideoCodec::H264	3	Advanced Video Coding
QMediaFormat::VideoCodec::MPEG4	2	MPEG-4
QMediaFormat::VideoCodec::AV1	7	AOMedia Video 1
QMediaFormat::VideoCodec::MotionJPEG	10	MotionJPEG
QMediaFormat::VideoCodec::VP9	6	VP9
QMediaFormat::VideoCodec::Theora	8	Theora
QMediaFormat::VideoCodec::Unspecified	-1	Video codec not specified

特性文档编制

audioCodec : AudioCodec

This property holds the audio codec of the media.

访问函数：

QMediaFormat::AudioCodec	audioCodec () const
void	setAudioCodec (QMediaFormat::AudioCodec codec )

另请参阅 QMediaFormat::AudioCodec .

fileFormat : FileFormat

This property holds the file (container) format of the media.

访问函数：

QMediaFormat::FileFormat	fileFormat () const
void	setFileFormat (QMediaFormat::FileFormat f )

另请参阅 QMediaFormat::FileFormat .

videoCodec : VideoCodec

This property holds the video codec of the media.

访问函数：

QMediaFormat::VideoCodec	videoCodec () const
void	setVideoCodec (QMediaFormat::VideoCodec codec )

另请参阅 QMediaFormat::VideoCodec .

成员函数文档编制

QMediaFormat:: QMediaFormat ( QMediaFormat && other )

构造 QMediaFormat 对象通过移动自 other .

QMediaFormat:: QMediaFormat (const QMediaFormat & other )

构造 QMediaFormat 对象通过拷贝自 other .

QMediaFormat:: QMediaFormat ( QMediaFormat::FileFormat format = UnspecifiedFormat)

构造 QMediaFormat 对象为 format .

QMediaFormat &QMediaFormat:: operator= ( QMediaFormat && other )

移动 other 到此 QMediaFormat 对象。

QMediaFormat &QMediaFormat:: operator= (const QMediaFormat & other )

拷贝 other 到此 QMediaFormat 对象。

QMediaFormat:: ~QMediaFormat ()

销毁 QMediaFormat 对象。

QMediaFormat::AudioCodec QMediaFormat:: audioCodec () const

Returns the audio codec used in this format.

注意： Getter function for property audioCodec.

另请参阅 setAudioCodec () 和 QMediaFormat::AudioCodec .

[static invokable] QString QMediaFormat:: audioCodecDescription ( QMediaFormat::AudioCodec codec )

Returns a description for codec .

注意： 此函数可以被援引，通过元对象系统和从 QML。见 Q_INVOKABLE .

[static invokable] QString QMediaFormat:: audioCodecName ( QMediaFormat::AudioCodec codec )

Returns a string based name for codec .

注意： 此函数可以被援引，通过元对象系统和从 QML。见 Q_INVOKABLE .

[static invokable] QString QMediaFormat:: fileFormatDescription ( QMediaFormat::FileFormat fileFormat )

Returns a description for fileFormat .

注意： 此函数可以被援引，通过元对象系统和从 QML。见 Q_INVOKABLE .

[static invokable] QString QMediaFormat:: fileFormatName ( QMediaFormat::FileFormat fileFormat )

Returns a string based name for fileFormat .

注意： 此函数可以被援引，通过元对象系统和从 QML。见 Q_INVOKABLE .

[invokable] bool QMediaFormat:: isSupported ( QMediaFormat::ConversionMode mode ) const

返回 true if Qt Multimedia can encode or decode this format, depending on mode .

注意： 此函数可以被援引，通过元对象系统和从 QML。见 Q_INVOKABLE .

QMimeType QMediaFormat:: mimeType () const

返回 MIME 类型 for the file format used in this media format.

void QMediaFormat:: resolveForEncoding ( QMediaFormat::ResolveFlags flags )

Resolves the format, based on flags , to a format that is supported by QMediaRecorder .

This method tries to find the best possible match for unspecified settings. Settings that are not supported by the recorder will be modified to the closest match that is supported.

When resolving, priority is given in the following order:

1. 文件格式
2. 视频编解码器
3. 音频编解码器

void QMediaFormat:: setAudioCodec ( QMediaFormat::AudioCodec codec )

将音频编解码器设为 codec .

注意： setter 函数对于特性 audioCodec .

另请参阅 audioCodec () 和 QMediaFormat::AudioCodec .

void QMediaFormat:: setVideoCodec ( QMediaFormat::VideoCodec codec )

Sets the video codec to codec .

注意： setter 函数对于特性 videoCodec .

另请参阅 videoCodec () 和 QMediaFormat::VideoCodec .

[invokable] QList < QMediaFormat::AudioCodec > QMediaFormat:: supportedAudioCodecs ( QMediaFormat::ConversionMode m )

Returns a list of audio codecs for the chosen file format and video codec ( m ).

To get all supported audio codecs, run this query on a default constructed QMediaFormat .

注意： 此函数可以被援引，通过元对象系统和从 QML。见 Q_INVOKABLE .

另请参阅 QMediaFormat::ConversionMode .

[invokable] QList < QMediaFormat::FileFormat > QMediaFormat:: supportedFileFormats ( QMediaFormat::ConversionMode m )

Returns a list of file formats for the audio and video codec indicated by m .

To get all supported file formats, run this query on a default constructed QMediaFormat .

注意： 此函数可以被援引，通过元对象系统和从 QML。见 Q_INVOKABLE .

另请参阅 QMediaFormat::ConversionMode .

[invokable] QList < QMediaFormat::VideoCodec > QMediaFormat:: supportedVideoCodecs ( QMediaFormat::ConversionMode m )

Returns a list of video codecs for the chosen file format and audio codec ( m ).

To get all supported video codecs, run this query on a default constructed MediaFormat.

注意： 此函数可以被援引，通过元对象系统和从 QML。见 Q_INVOKABLE .

另请参阅 QMediaFormat::ConversionMode .

QMediaFormat::VideoCodec QMediaFormat:: videoCodec () const

Returns the video codec used in this format.

注意： Getter function for property videoCodec.

另请参阅 setVideoCodec () 和 QMediaFormat::VideoCodec .

[static invokable] QString QMediaFormat:: videoCodecDescription ( QMediaFormat::VideoCodec codec )

Returns a description for codec .

注意： 此函数可以被援引，通过元对象系统和从 QML。见 Q_INVOKABLE .

[static invokable] QString QMediaFormat:: videoCodecName ( QMediaFormat::VideoCodec codec )

Returns a string based name for codec .

注意： 此函数可以被援引，通过元对象系统和从 QML。见 Q_INVOKABLE .