QMediaFormat Class
멀티미디어 파일 또는 스트림의 인코딩 형식을 설명합니다. 더 보기...
| 헤더: | #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 } |
속성
- audioCodec : AudioCodec
- fileFormat : FileFormat
- videoCodec : VideoCodec
공용 함수
| 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=(QMediaFormat &&other) |
| QMediaFormat & | operator=(const 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은 멀티미디어 파일 또는 스트림의 인코딩 형식을 설명합니다.
QMediaFormat을 사용하여 특정 미디어 형식을 인코딩 또는 디코딩에 사용할 수 있는지 확인할 수 있습니다.
멤버 유형 문서
enum class QMediaFormat::AudioCodec
멀티미디어 파일이나 스트림에 사용되는 오디오 코덱을 설명합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QMediaFormat::AudioCodec::WMA | 9 | Windows Media Audio |
QMediaFormat::AudioCodec::AC3 | 2 | 돌비 디지털 |
QMediaFormat::AudioCodec::AAC | 1 | 고급 오디오 코딩 |
QMediaFormat::AudioCodec::ALAC | 10 | Apple Lossless 오디오 코덱 |
QMediaFormat::AudioCodec::DolbyTrueHD | 5 | 돌비 트루HD |
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 | 무손실 오디오 코덱 |
QMediaFormat::AudioCodec::Opus | 6 | 오퍼스 오디오 형식 |
QMediaFormat::AudioCodec::Unspecified | -1 | 미지정 코덱 |
enum QMediaFormat::ConversionMode
대부분의 경우, 시스템은 비대칭적인 기능을 가지고 있어 인코딩할 수 있는 것보다 더 많은 형식이나 코덱을 디코딩할 수 있는 경우가 많습니다. 이 열거형은 특정 파일 형식이나 코덱이 지원되는지 확인할 때 사용될 요청된 변환 모드를 설명합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QMediaFormat::Encode | 0 | 특정 파일 형식이나 코덱을 인코딩할 수 있는지 확인하는 데 사용됩니다. |
QMediaFormat::Decode | 1 | 특정 파일 형식이나 코덱을 디코딩할 수 있는지 확인하는 데 사용됩니다. |
supportedFileFormats, supportedAudioCodecs 및 supportedVideoCodecs도 참조하십시오 .
enum QMediaFormat::FileFormat
멀티미디어 파일이나 스트림에서 사용되는 컨테이너 형식을 설명합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QMediaFormat::WMA | 9 | Windows Media Audio |
QMediaFormat::AAC | 8 | 고급 오디오 코딩 |
QMediaFormat::Matroska | 2 | 마트로스카(MKV) |
QMediaFormat::WMV | 0 | Windows Media Video |
QMediaFormat::MP3 | 10 | MPEG-1 오디오 레이어 III 또는 MPEG-2 오디오 레이어 III |
QMediaFormat::Wave | 12 | 웨이브폼 오디오 파일 형식 |
QMediaFormat::Ogg | 4 | Ogg |
QMediaFormat::MPEG4 | 3 | MPEG-4 |
QMediaFormat::AVI | 1 | 오디오 비디오 인터리브 |
QMediaFormat::QuickTime | 5 | 퀵타임 |
QMediaFormat::WebM | 6 | WebM |
QMediaFormat::Mpeg4Audio | 7 | MPEG-4 Part 3 또는 MPEG-4 오디오 (공식 명칭 ISO/IEC 14496-3) |
QMediaFormat::FLAC | 11 | 무손실 오디오 코덱 |
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 Video |
QMediaFormat::VideoCodec::H265 | 4 | 고효율 비디오 코딩(HEVC) |
QMediaFormat::VideoCodec::H264 | 3 | 고급 비디오 코딩 |
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::FileFormat format = UnspecifiedFormat)
format 용 QMediaFormat 객체를 생성합니다.
[noexcept] QMediaFormat::QMediaFormat(const QMediaFormat &other)
other 에서 내용을 복사하여 QMediaFormat 객체를 생성합니다.
[constexpr noexcept default] QMediaFormat::QMediaFormat(QMediaFormat &&other)
other 를 기반으로 QMediaFormat 객체를 생성합니다.
[noexcept] 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
Qt Multimedia 가 이 형식을 인코딩하거나 디코딩할 수 있는 경우, mode 에 따라 true 를 반환합니다.
참고: 이 함수는 메타 객체 시스템과 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도 참조하십시오 .
[noexcept] void QMediaFormat::swap(QMediaFormat &other)
other 를 사용하여 미디어 형식을 변경합니다.
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`을 참조하십시오.
bool QMediaFormat::operator!=(const QMediaFormat &other) const
other 가 현재 미디어 형식과 다를 경우 ` true `을 반환하고, 그렇지 않은 경우 ` false`을 반환합니다.
[noexcept] QMediaFormat &QMediaFormat::operator=(QMediaFormat &&other)
other 를 이 QMediaFormat 객체로 이동합니다.
[noexcept] QMediaFormat &QMediaFormat::operator=(const QMediaFormat &other)
other 를 이 QMediaFormat 객체에 복사합니다.
bool QMediaFormat::operator==(const QMediaFormat &other) const
other 가 현재 미디어 형식과 동일한 경우 ` true `를 반환하고, 그렇지 않은 경우 ` false`를 반환합니다.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.