描述多媒体文件 (或流) 的编码格式。 更多...
头: | #include <QMediaFormat> |
CMake: |
find_package(Qt6 REQUIRED COMPONENTS Multimedia)
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 } |
QMediaFormat (QMediaFormat::FileFormat format = UnspecifiedFormat) | |
QMediaFormat (const QMediaFormat & other ) | |
QMediaFormat (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 ) |
void | swap (QMediaFormat & other ) |
QMediaFormat::VideoCodec | videoCodec () const |
bool | operator!= (const QMediaFormat & other ) const |
QMediaFormat & | operator= (const QMediaFormat & other ) |
QMediaFormat & | operator= (QMediaFormat && other ) |
bool | operator== (const QMediaFormat & other ) 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.
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
|
未指定编解码器 |
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 .
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. |
Describes the requirements for resolving a suitable format for QMediaRecorder .
常量 | 值 | 描述 |
---|---|---|
QMediaFormat::NoFlags
|
0
|
No requirements |
QMediaFormat::RequiresVideo
|
1
|
A video codec is required |
另请参阅 resolveForEncoding ().
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 |
This property holds the audio codec of the media.
访问函数:
QMediaFormat::AudioCodec | audioCodec () const |
void | setAudioCodec (QMediaFormat::AudioCodec codec ) |
另请参阅 QMediaFormat::AudioCodec .
This property holds the file (container) format of the media.
访问函数:
QMediaFormat::FileFormat | fileFormat () const |
void | setFileFormat (QMediaFormat::FileFormat f ) |
另请参阅 QMediaFormat::FileFormat .
This property holds the video codec of the media.
访问函数:
QMediaFormat::VideoCodec | videoCodec () const |
void | setVideoCodec (QMediaFormat::VideoCodec codec ) |
另请参阅 QMediaFormat::VideoCodec .
构造 QMediaFormat 对象为 format .
[noexcept]
QMediaFormat::
QMediaFormat
(const
QMediaFormat
&
other
)
构造 QMediaFormat 对象通过拷贝自 other .
[noexcept]
QMediaFormat::
QMediaFormat
(
QMediaFormat
&&
other
)
构造 QMediaFormat 对象通过移动自 other .
[noexcept]
QMediaFormat::
~QMediaFormat
()
销毁 QMediaFormat 对象。
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 .
返回 MIME 类型 for the file format used in this media format.
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:
将音频编解码器设为 codec .
注意: setter 函数对于特性 audioCodec .
另请参阅 audioCodec () 和 QMediaFormat::AudioCodec .
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 .
[noexcept]
void
QMediaFormat::
swap
(
QMediaFormat
&
other
)
Swaps the media format with other .
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 .
返回
true
if
other
is not equal to the current media format, otherwise returns
false
.
[noexcept]
QMediaFormat
&QMediaFormat::
operator=
(const
QMediaFormat
&
other
)
拷贝 other 到此 QMediaFormat 对象。
[noexcept]
QMediaFormat
&QMediaFormat::
operator=
(
QMediaFormat
&&
other
)
移动 other 到此 QMediaFormat 对象。
返回
true
if
other
is equal to the current media format, otherwise returns
false
.