PySide6.QtMultimedia.QMediaFormat

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

Free Lossless Audio Codec

QMediaFormat.UnspecifiedFormat

格式未指定。

class AudioCodec

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

常量

描述

QMediaFormat.AudioCodec.WMA

Windows Media Audio

QMediaFormat.AudioCodec.AC3

Dolby Digital

QMediaFormat.AudioCodec.AAC

高级音频编码

QMediaFormat.AudioCodec.ALAC

Apple Lossless Audio Codec

QMediaFormat.AudioCodec.DolbyTrueHD

Dolby TrueHD

QMediaFormat.AudioCodec.EAC3

Dolby Digital Plus (EAC3)

QMediaFormat.AudioCodec.MP3

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

QMediaFormat.AudioCodec.Wave

波形音频文件格式

QMediaFormat.AudioCodec.Vorbis

Ogg Vorbis

QMediaFormat.AudioCodec.FLAC

Free Lossless Audio Codec

QMediaFormat.AudioCodec.Opus

Opus Audio Format

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

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

class ResolveFlags

描述了为QMediaRecorder解析合适格式的要求。

常量

描述

QMediaFormat.NoFlags

无要求

QMediaFormat.RequiresVideo

需要视频编解码器

另请参阅

resolveForEncoding()

注意

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

property audioCodecᅟ: QMediaFormat.AudioCodec

此属性保存媒体的音频编解码器。

另请参阅

AudioCodec

Access functions:
property fileFormatᅟ: QMediaFormat.FileFormat

此属性保存媒体的文件(容器)格式。

另请参阅

FileFormat

Access functions:
property videoCodecᅟ: QMediaFormat.VideoCodec

此属性保存媒体的视频编解码器。

另请参阅

VideoCodec

Access functions:
PySide6.QtMultimedia.QMediaFormat.fmt
PySide6.QtMultimedia.QMediaFormat.audio
PySide6.QtMultimedia.QMediaFormat.video
__init__([format=QMediaFormat.FileFormat.UnspecifiedFormat])
Parameters:

格式FileFormat

format 构造一个 QMediaFormat 对象。

__init__(other)
Parameters:

其他QMediaFormat

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

audioCodec()
Return type:

AudioCodec

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

属性 audioCodecᅟ 的获取器。

static audioCodecDescription(codec)
Parameters:

编解码器AudioCodec

Return type:

字符串

返回codec的描述。

static audioCodecName(codec)
Parameters:

编解码器AudioCodec

Return type:

字符串

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

fileFormat()
Return type:

FileFormat

另请参阅

setFileFormat()

属性 fileFormatᅟ 的获取器。

static fileFormatDescription(fileFormat)
Parameters:

文件格式FileFormat

Return type:

字符串

返回fileFormat的描述。

static fileFormatName(fileFormat)
Parameters:

文件格式FileFormat

Return type:

字符串

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

isSupported(mode)
Parameters:

modeConversionMode

Return type:

布尔

如果Qt Multimedia可以编码或解码此格式,则返回true,具体取决于mode

mimeType()
Return type:

QMimeType

返回用于此媒体格式的文件格式的MIME类型

__ne__(other)
Parameters:

其他QMediaFormat

Return type:

布尔

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

__eq__(other)
Parameters:

其他QMediaFormat

Return type:

布尔

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

resolveForEncoding(flags)
Parameters:

flagsResolveFlags

根据flags解析格式,转换为QMediaRecorder支持的格式。

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

解析时,优先级按以下顺序确定:

  1. 文件格式

  2. 视频编解码器

  3. 音频编解码器

setAudioCodec(codec)
Parameters:

编解码器AudioCodec

将音频编解码器设置为 codec

另请参阅

audioCodec() AudioCodec

属性 audioCodecᅟ 的设置器。

setFileFormat(f)
Parameters:

fFileFormat

另请参阅

fileFormat()

属性 fileFormatᅟ 的设置器。

setVideoCodec(codec)
Parameters:

codecVideoCodec

将视频编解码器设置为 codec

另请参阅

videoCodec() VideoCodec

属性 videoCodecᅟ 的设置器。

supportedAudioCodecs(m)
Parameters:

mConversionMode

Return type:

QMediaFormat.AudioCodec 的列表

返回所选文件格式和视频编解码器(m)的音频编解码器列表。

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

另请参阅

ConversionMode

supportedFileFormats(m)
Parameters:

mConversionMode

Return type:

QMediaFormat.FileFormat 的列表

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

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

另请参阅

ConversionMode

supportedVideoCodecs(m)
Parameters:

mConversionMode

Return type:

QMediaFormat.VideoCodec的列表

返回所选文件格式和音频编解码器(m)的视频编解码器列表。

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

另请参阅

ConversionMode

swap(other)
Parameters:

其他QMediaFormat

将媒体格式与 other 交换。

videoCodec()
Return type:

VideoCodec

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

属性 videoCodecᅟ 的获取器。

static videoCodecDescription(codec)
Parameters:

codecVideoCodec

Return type:

字符串

返回codec的描述。

static videoCodecName(codec)
Parameters:

codecVideoCodec

Return type:

字符串

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