Класс QMediaFormat
Описывает формат кодирования для мультимедийного файла или потока. Подробнее...
| Заголовок: | #include <QMediaFormat> |
| CMake: | find_package(Qt6 COMPONENTS Multimedia REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Multimedia) |
| qmake: | QT += multimedia |
Типы публичного доступа
| Перечисление | AudioCodec { WMA, AC3, AAC, ALAC, DolbyTrueHD, …, Unspecified } |
| Перечисление | ConversionMode { Encode, Decode } |
| Перечисление | FileFormat { WMA, AAC, Matroska, WMV, MP3, …, UnspecifiedFormat } |
| Перечисление | ResolveFlags { NoFlags, RequiresVideo } |
| Перечисление | 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 описывает формат кодирования для мультимедийного файла или потока.
Вы можете проверить, можно ли использовать определенный формат мультимедиа для кодирования или декодирования с помощью QMediaFormat.
Документация по типам членов
Перечисление QMediaFormat::AudioCodec
Описывает аудиокодек, используемый в мультимедийном файле или потоке.
| Постоянная | Значение | Описание |
|---|---|---|
QMediaFormat::AudioCodec::WMA |
9 |
Windows Media Audio |
QMediaFormat::AudioCodec::AC3 |
2 |
Dolby Digital |
QMediaFormat::AudioCodec::AAC |
1 |
Advanced Audio Coding |
QMediaFormat::AudioCodec::ALAC |
10 |
Apple Lossless Audio Codec |
QMediaFormat::AudioCodec::DolbyTrueHD |
5 |
Dolby TrueHD |
QMediaFormat::AudioCodec::EAC3 |
3 |
Dolby Digital Plus (EAC3) |
QMediaFormat::AudioCodec::MP3 |
0 |
MPEG-1 Audio Layer III или MPEG-2 Audio Layer III |
QMediaFormat::AudioCodec::Wave |
8 |
Waveform Audio File Format |
QMediaFormat::AudioCodec::Vorbis |
7 |
Ogg Vorbis |
QMediaFormat::AudioCodec::FLAC |
4 |
Free Lossless Audio Codec |
QMediaFormat::AudioCodec::Opus |
6 |
Opus Audio Format |
QMediaFormat::AudioCodec::Unspecified |
-1 |
Неуказанный кодек |
Перечисление QMediaFormat::ConversionMode
Во многих случаях системы имеют асимметричные возможности и часто могут декодировать больше форматов или кодеков, чем могут кодировать. Это перечисление описывает запрашиваемый режим преобразования, который используется при проверке поддержки определенного формата файла или кодека.
| Постоянная | Значение | Описание |
|---|---|---|
QMediaFormat::Encode |
0 |
Используется для проверки возможности кодирования определенного формата файла или кодека. |
QMediaFormat::Decode |
1 |
Используется для проверки возможности декодирования определенного формата файла или кодека. |
См. также supportedFileFormats, supportedAudioCodecs и supportedVideoCodecs.
END_OF_DOCUMENT_MARKER ```enum QMediaFormat::FileFormat
Описывает формат контейнера, используемый в медиафайле или потоке.
| Константа | Значение | Описание |
|---|---|---|
QMediaFormat::WMA |
9 |
Аудио Windows Media |
QMediaFormat::AAC |
8 |
Advanced Audio Coding |
QMediaFormat::Matroska |
2 |
Matroska (MKV) |
QMediaFormat::WMV |
0 |
Видео Windows Media |
QMediaFormat::MP3 |
10 |
MPEG-1 Audio Layer III или MPEG-2 Audio Layer III |
QMediaFormat::Wave |
12 |
Формат волнового аудиофайла |
QMediaFormat::Ogg |
4 |
Ogg |
QMediaFormat::MPEG4 |
3 |
MPEG-4 |
QMediaFormat::AVI |
1 |
Audio Video Interleave |
QMediaFormat::QuickTime |
5 |
QuickTime |
QMediaFormat::WebM |
6 |
WebM |
QMediaFormat::Mpeg4Audio |
7 |
MPEG-4 Part 3 или MPEG-4 Audio (формально ISO/IEC 14496-3) |
QMediaFormat::FLAC |
11 |
Free Lossless Audio Codec |
QMediaFormat::UnspecifiedFormat |
-1 |
Формат не указан. |
enum QMediaFormat::ResolveFlags
Описывает требования к разрешению подходящего формата для QMediaRecorder.
| Константа | Значение | Описание |
|---|---|---|
QMediaFormat::NoFlags |
0 |
Нет требований |
QMediaFormat::RequiresVideo |
1 |
Требуется кодек видео |
См. также resolveForEncoding().
enum class QMediaFormat::VideoCodec
Описывает используемый кодек видео в медиафайле или потоке.
| Константа | Значение | Описание |
|---|---|---|
QMediaFormat::VideoCodec::VP8 |
5 |
VP8 |
QMediaFormat::VideoCodec::MPEG2 |
1 |
MPEG-2 |
QMediaFormat::VideoCodec::MPEG1 |
0 |
MPEG-1 |
QMediaFormat::VideoCodec::WMV |
9 |
Видео Windows Media |
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 |
Кодек видео не указан |
Документация свойств
audioCodec : AudioCodec
Это свойство содержит кодек аудио медиа.
Функции доступа:
| QMediaFormat::AudioCodec | audioCodec() const |
| void | setAudioCodec(QMediaFormat::AudioCodec codec) |
См. также QMediaFormat::AudioCodec.
fileFormat : FileFormat
Это свойство содержит формат файла (контейнера) медиа.
Функции доступа:
| QMediaFormat::FileFormat | fileFormat() const |
| void | setFileFormat(QMediaFormat::FileFormat f) |
См. также QMediaFormat::FileFormat.
videoCodec : VideoCodec
Это свойство содержит кодек видео медиа.
Функции доступа:
| 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
Возвращает используемый кодек аудио в этом формате.
Примечание: Функция-геттер для свойства audioCodec.
См. также setAudioCodec() и QMediaFormat::AudioCodec.
[static invokable] QString QMediaFormat::audioCodecDescription(QMediaFormat::AudioCodec codec)
Возвращает описание для codec.
Примечание: Эта функция может быть вызвана через систему метаобъектов и из QML. См. Q_INVOKABLE.
[static invokable] QString QMediaFormat::audioCodecName(QMediaFormat::AudioCodec codec)
Возвращает строковое имя для codec.
Примечание: Эту функцию можно вызывать через систему метаобъектов и из QML. См. Q_INVOKABLE.
[static invokable] QString QMediaFormat::fileFormatDescription(QMediaFormat::FileFormat fileFormat)
Возвращает описание для fileFormat.
Примечание: Эту функцию можно вызывать через систему метаобъектов и из QML. См. Q_INVOKABLE.
[static invokable] QString QMediaFormat::fileFormatName(QMediaFormat::FileFormat fileFormat)
Возвращает строковое имя для fileFormat.
Примечание: Эту функцию можно вызывать через систему метаобъектов и из QML. См. Q_INVOKABLE.
[invokable] bool QMediaFormat::isSupported(QMediaFormat::ConversionMode mode) const
Возвращает true если Qt Multimedia может кодировать или декодировать этот формат в зависимости от mode.
Примечание: Эту функцию можно вызывать через систему метаобъектов и из QML. См. Q_INVOKABLE.
QMimeType QMediaFormat::mimeType() const
Возвращает MIME-тип для используемого в этом формате файла.
void QMediaFormat::resolveForEncoding(QMediaFormat::ResolveFlags flags)
Разрешает формат, на основе flags, до формата, поддерживаемого QMediaRecorder.
Этот метод пытается найти наилучшее соответствие для неопределённых настроек. Настройки, которые не поддерживаются записывателем, будут изменены на самое близкое совместимое соответствие.
При разрешении приоритет предоставляется в следующем порядке:
- Формат файла
- Кодек видео
- Кодек аудио
void QMediaFormat::setAudioCodec(QMediaFormat::AudioCodec codec)
Устанавливает кодек аудио в codec.
Примечание: Функция-сеттер для свойства audioCodec.
См. также audioCodec() и QMediaFormat::AudioCodec.
void QMediaFormat::setVideoCodec(QMediaFormat::VideoCodec codec)
Устанавливает кодек видео в codec.
Примечание: Функция-сеттер для свойства videoCodec.
См. также videoCodec() и QMediaFormat::VideoCodec.
[invokable] QList<QMediaFormat::AudioCodec> QMediaFormat::supportedAudioCodecs(QMediaFormat::ConversionMode m)
Возвращает список кодеков аудио для выбранного формата файла и кодека видео (m).
Для получения всех поддерживаемых кодеков аудио выполните этот запрос для QMediaFormat по умолчанию.
Примечание: Эту функцию можно вызывать через систему метаобъектов и из QML. См. Q_INVOKABLE.
См. также QMediaFormat::ConversionMode.
[invokable] QList<QMediaFormat::FileFormat> QMediaFormat::supportedFileFormats(QMediaFormat::ConversionMode m)
Возвращает список форматов файлов для кодеков аудио и видео, указанных в m.
Для получения всех поддерживаемых форматов файлов выполните этот запрос для QMediaFormat по умолчанию.
Примечание: Эту функцию можно вызывать через систему метаобъектов и из QML. См. Q_INVOKABLE.
См. также QMediaFormat::ConversionMode.
[invokable] QList<QMediaFormat::VideoCodec> QMediaFormat::supportedVideoCodecs(QMediaFormat::ConversionMode m)
Возвращает список кодеков видео для выбранного формата файла и кодека аудио (m).
Для получения всех поддерживаемых кодеков видео выполните этот запрос для экземпляра MediaFormat по умолчанию.
Примечание: Эту функцию можно вызывать через систему метаобъектов и из QML. См. Q_INVOKABLE.
См. также QMediaFormat::ConversionMode.
QMediaFormat::VideoCodec QMediaFormat::videoCodec() const
Возвращает используемый в этом формате кодек видео.
Примечание: Функция-геттер для свойства videoCodec.
См. также setVideoCodec() и QMediaFormat::VideoCodec.
[static invokable] QString QMediaFormat::videoCodecDescription(QMediaFormat::VideoCodec codec)
Возвращает описание для codec.
Примечание: Эту функцию можно вызывать через систему метаобъектов и из QML. См. Q_INVOKABLE.
[static invokable] QString QMediaFormat::videoCodecName(QMediaFormat::VideoCodec codec)
Возвращает строковое имя для codec.
Примечание: Эту функцию можно вызывать через систему метаобъектов и из QML. См. Q_INVOKABLE.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qmediaformat.html
