class QMediaFormat#

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

新增于版本 6.1。

摘要#

属性#

方法#

静态函数#

注意

本文档可能包含自动从C++翻译到Python的代码片段。我们始终欢迎对片段翻译的贡献。如果您发现翻译有问题，您也可以通过在https:/bugreports.qt.io/projects/PYSIDE上创建票据来告知我们

详细描述#

QMediaFormat 表示多媒体文件或流的一种编码格式。

您可以使用 QMediaFormat 检查特定多媒体格式是否可用于编码或解码。

class FileFormat#

描述多媒体文件或流中使用的容器格式。

常量

描述

QMediaFormat.WMA

Windows Media Audio

QMediaFormat.AAC

高级音频编码

QMediaFormat.Matroska

Matroska (MKV)

QMediaFormat.WMV

Windows Media Video

QMediaFormat.MP3

MPEG-1 音频层 III 或 MPEG-2 音频层 III

QMediaFormat.Wave

波形音频文件格式

QMediaFormat.Ogg

Ogg

QMediaFormat.MPEG4

MPEG-4

QMediaFormat.AVI

音频视频交错

QMediaFormat.QuickTime

QuickTime

QMediaFormat.WebM

WebM

QMediaFormat.Mpeg4Audio

MPEG-4第3部分或MPEG-4音频（正式名称ISO/IEC 14496-3）

QMediaFormat.FLAC

免费无损音频编解码器

QMediaFormat.UnspecifiedFormat

格式未指定。
class AudioCodec#

描述多媒体文件或流中使用的声音编解码器。

常量

描述

QMediaFormat.AudioCodec.WMA

Windows Media Audio

QMediaFormat.AudioCodec.AC3

杜比数字

QMediaFormat.AudioCodec.AAC

高级音频编码

QMediaFormat.AudioCodec.ALAC

Apple无损音频编解码器

QMediaFormat.AudioCodec.DolbyTrueHD

杜比TrueHD

QMediaFormat.AudioCodec.EAC3

杜比数字+（EAC3）

QMediaFormat.AudioCodec.MP3

MPEG-1 音频层 III 或 MPEG-2 音频层 III

QMediaFormat.AudioCodec.Wave

波形音频文件格式

QMediaFormat.AudioCodec.Vorbis

Ogg Vorbis

QMediaFormat.AudioCodec.FLAC

免费无损音频编解码器

QMediaFormat.AudioCodec.Opus

Opus音频格式

QMediaFormat.AudioCodec.Unspecified

未指定编解码器
class VideoCodec#

描述多媒体文件或流中使用的视频编解码器。

常量

描述

QMediaFormat.VideoCodec.VP8

VP8

QMediaFormat.VideoCodec.MPEG2

MPEG-2

QMediaFormat.VideoCodec.MPEG1

MPEG-1

QMediaFormat.VideoCodec.WMV

Windows Media Video

QMediaFormat.VideoCodec.H265

高效视频编解码器（HEVC）

QMediaFormat.VideoCodec.H264

高级视频编码

QMediaFormat.VideoCodec.MPEG4

MPEG-4

QMediaFormat.VideoCodec.AV1

AOMedia Video 1

QMediaFormat.VideoCodec.MotionJPEG

MotionJPEG

QMediaFormat.VideoCodec.VP9

VP9

QMediaFormat.VideoCodec.Theora

Theora

QMediaFormat.VideoCodec.Unspecified

视频编解码器未指定
class ConversionMode#

在许多情况下，系统具有非对称能力，可以解码更多格式或编解码器，而不能编码。此枚举描述在检查是否支持特定文件格式或编解码器时使用的请求转换模式。

常量

描述

QMediaFormat.Encode

用于检查是否可以编码特定文件格式或编解码器。

QMediaFormat.Decode

用于检查某些文件格式或编解码器是否可以被解码。

参见

supportedFileFormats supportedAudioCodecs supportedVideoCodecs

class ResolveFlags#

描述了解决适宜的格式以用于 QMediaRecorder 的要求。

常量

描述

QMediaFormat.NoFlags

无要求

QMediaFormat.RequiresVideo

需要视频编解码器

参见

resolveForEncoding()

注意

当使用 from __feature__ import true_property 时，可以直接使用属性，否则通过访问函数。

property audioCodec}:{QMediaFormat.AudioCodec#

此属性包含媒体的音频编解码器。

参见

AudioCodec

访问函数
property fileFormat}:{QMediaFormat.FileFormat#

此属性包含媒体的文件（容器）格式。

参见

FileFormat

访问函数
property videoCodec}:{QMediaFormat.VideoCodec#

此属性包含媒体的视频编解码器。

参见

VideoCodec

访问函数
PySide6.QtMultimedia.QMediaFormat.fmt#
PySide6.QtMultimedia.QMediaFormat.audio#
PySide6.QtMultimedia.QMediaFormat.video#
__init__(other)#
参数:

其他 – QMediaFormat

通过从 other 复制来构造一个 QMediaFormat 对象。

__init__([format=QMediaFormat.FileFormat.UnspecifiedFormat])
参数:

format – FileFormat

为 format 构造一个 QMediaFormat 对象。

audioCodec()#
返回类型：:

AudioCodec

返回此格式使用的音频编解码器。

属性 audioCodecᅟ 的获取器。

静态 audioCodecDescription(codec)#
参数:

codec – AudioCodec

返回类型：:

字符串

返回对 codec 的描述。

静态 audioCodecName(codec)#
参数:

codec – AudioCodec

返回类型：:

字符串

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

fileFormat()#
返回类型：:

FileFormat

参见

setFileFormat()

属性 fileFormatᅟ 的获取器。

静态 fileFormatDescription(fileFormat)#
参数:

fileFormat – FileFormat

返回类型：:

字符串

返回对 fileFormat 的描述。

静态 fileFormatName(fileFormat)#
参数:

fileFormat – FileFormat

返回类型：:

字符串

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

isSupported ( mode ) #

参数:

mode – ConversionMode

返回类型：:

bool

如果根据 mode ，Qt 多媒体可以对此格式进行编码或解码，则返回 true 。

mimeType ( ) #
返回类型：:

QMediaType

返回在此媒体格式中使用文件格式的 MIME 类型 。

__ne__ ( other ) #
参数:

其他 – QMediaFormat

返回类型：:

bool

如果 other 不等于当前的媒体格式，则返回 true ，否则返回 false 。

__eq__ ( other ) #
参数:

其他 – QMediaFormat

返回类型：:

bool

如果 other 等于当前媒体格式，则返回 true ，否则返回 false 。

resolveForEncoding ( flags ) #
参数:

flags – ResolveFlags

基于 flags 解析格式，以得到受 QMediaRecorder 支持的格式。

此方法尝试为未指定的设置找到最佳匹配。不支持的录制器设置将被修改为可支持的最近匹配。

在解析时，优先级按以下顺序给出

  1. 文件格式

  2. 视频编解码器

  3. 音频编解码器

setAudioCodec ( codec ) #
参数:

codec – AudioCodec

将音频编解码器设置为 codec 。

属性 audioCodec 的设置器。

setFileFormat(f)#
参数:

f – FileFormat

参见

fileFormat()

属性 fileFormatᅟ 的设置器。

setVideoCodec(codec)#
参数:

codec – VideoCodec

将视频编解码器设置为 codec。

属性 videoCodecᅟ 的设置器。

supportedAudioCodecs(m)#
参数:

m – ConversionMode

返回类型：:

音频编解码器列表 QMediaFormat.AudioCodec

返回指定文件格式和视频编解码器（m）的音频编解码器列表。

要获取所有支持的音频编解码器，请在默认构造函数创建的 QMediaFormat 上运行此查询。

参见

转换模式

supportedFileFormats(m)#
参数:

m – ConversionMode

返回类型：:

文件格式列表 QMediaFormat.FileFormat

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

要获取所有支持的文件格式，请在默认构造函数创建的 QMediaFormat 上运行此查询。

参见

转换模式

supportedVideoCodecs(m)#
参数:

m – ConversionMode

返回类型：:

视频编解码器列表 QMediaFormat.VideoCodec

返回指定文件格式和音频编解码器（m）的视频编解码器列表。

要获取所有支持的视频编解码器，请在默认构造函数创建的 MediaFormat 上运行此查询。

参见

转换模式

swap(other)#
参数:

其他 – QMediaFormat

与 other 交换媒体格式。

videoCodec()#
返回类型：:

VideoCodec

返回该格式使用的视频编解码器。

属性 videoCodec 的读取器。

static videoCodecDescription(codec)#
参数:

codec – VideoCodec

返回类型：:

字符串

返回对 codec 的描述。

static videoCodecName(codec)#
参数:

codec – VideoCodec

返回类型：:

字符串

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