이 페이지에서

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 }

속성

공용 함수

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::WMA9Windows Media Audio
QMediaFormat::AudioCodec::AC32돌비 디지털
QMediaFormat::AudioCodec::AAC1고급 오디오 코딩
QMediaFormat::AudioCodec::ALAC10Apple Lossless 오디오 코덱
QMediaFormat::AudioCodec::DolbyTrueHD5돌비 트루HD
QMediaFormat::AudioCodec::EAC33돌비 디지털 플러스 (EAC3)
QMediaFormat::AudioCodec::MP30MPEG-1 오디오 레이어 III 또는 MPEG-2 오디오 레이어 III
QMediaFormat::AudioCodec::Wave8웨이브폼 오디오 파일 형식
QMediaFormat::AudioCodec::Vorbis7Ogg Vorbis
QMediaFormat::AudioCodec::FLAC4무손실 오디오 코덱
QMediaFormat::AudioCodec::Opus6오퍼스 오디오 형식
QMediaFormat::AudioCodec::Unspecified-1미지정 코덱

enum QMediaFormat::ConversionMode

대부분의 경우, 시스템은 비대칭적인 기능을 가지고 있어 인코딩할 수 있는 것보다 더 많은 형식이나 코덱을 디코딩할 수 있는 경우가 많습니다. 이 열거형은 특정 파일 형식이나 코덱이 지원되는지 확인할 때 사용될 요청된 변환 모드를 설명합니다.

상수값설명
QMediaFormat::Encode0특정 파일 형식이나 코덱을 인코딩할 수 있는지 확인하는 데 사용됩니다.
QMediaFormat::Decode1특정 파일 형식이나 코덱을 디코딩할 수 있는지 확인하는 데 사용됩니다.

supportedFileFormats, supportedAudioCodecs 및 supportedVideoCodecs도 참조하십시오 .

enum QMediaFormat::FileFormat

멀티미디어 파일이나 스트림에서 사용되는 컨테이너 형식을 설명합니다.

상수값설명
QMediaFormat::WMA9Windows Media Audio
QMediaFormat::AAC8고급 오디오 코딩
QMediaFormat::Matroska2마트로스카(MKV)
QMediaFormat::WMV0Windows Media Video
QMediaFormat::MP310MPEG-1 오디오 레이어 III 또는 MPEG-2 오디오 레이어 III
QMediaFormat::Wave12웨이브폼 오디오 파일 형식
QMediaFormat::Ogg4Ogg
QMediaFormat::MPEG43MPEG-4
QMediaFormat::AVI1오디오 비디오 인터리브
QMediaFormat::QuickTime5퀵타임
QMediaFormat::WebM6WebM
QMediaFormat::Mpeg4Audio7MPEG-4 Part 3 또는 MPEG-4 오디오 (공식 명칭 ISO/IEC 14496-3)
QMediaFormat::FLAC11무손실 오디오 코덱
QMediaFormat::UnspecifiedFormat-1이 형식은 지정되지 않았습니다.

enum QMediaFormat::ResolveFlags

QMediaRecorder 에 적합한 형식을 결정하기 위한 요건을 설명합니다.

상수값설명
QMediaFormat::NoFlags0요구 사항 없음
QMediaFormat::RequiresVideo1비디오 코덱이 필요합니다

resolveForEncoding()도 참조하십시오 .

enum class QMediaFormat::VideoCodec

멀티미디어 파일이나 스트림에 사용된 영상 코딩 방식을 설명합니다.

상수값설명
QMediaFormat::VideoCodec::VP85VP8
QMediaFormat::VideoCodec::MPEG21MPEG-2
QMediaFormat::VideoCodec::MPEG10MPEG-1
QMediaFormat::VideoCodec::WMV9Windows Media Video
QMediaFormat::VideoCodec::H2654고효율 비디오 코딩(HEVC)
QMediaFormat::VideoCodec::H2643고급 비디오 코딩
QMediaFormat::VideoCodec::MPEG42MPEG-4
QMediaFormat::VideoCodec::AV17AOMedia Video 1
QMediaFormat::VideoCodec::MotionJPEG10MotionJPEG
QMediaFormat::VideoCodec::VP96VP9
QMediaFormat::VideoCodec::Theora8Theora
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 에서 지원하는 형식으로 변환합니다.

이 메서드는 지정되지 않은 설정에 대해 가능한 한 가장 적합한 값을 찾으려고 시도합니다. 레코더에서 지원되지 않는 설정은 지원되는 설정 중 가장 유사한 값으로 수정됩니다.

변환 시에는 다음 순서대로 우선순위가 적용됩니다:

  1. 파일 형식
  2. 비디오 코덱
  3. 오디오 코덱

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.