이 페이지에서

mediaFormat QML Value Type

MediaFormat은 미디어 파일의 형식을 설명합니다. 더 보기...

Import Statement: import QtMultimedia

속성

방법

상세 설명

MediaFormat 유형은 미디어 파일의 형식을 설명합니다. 이 유형에는 파일 유형과 사용 중인 오디오 및 비디오 코덱을 설명하는 세 가지 속성이 포함되어 있습니다.

MediaFormat을 사용하면 MediaRecorder 가 생성해야 할 파일의 유형을 지정할 수 있습니다. 아래 코드 조각은 AAC로 인코딩된 오디오와 H265 비디오를 포함하는 mpeg4 비디오를 생성하도록 레코더를 설정하는 예제를 보여줍니다:

CaptureSession {
    ... // setup inputs
    MediaRecorder {
        mediaFormat {
            fileFormat: MediaFormat.MPEG4
            audioCodec: MediaFormat.AudioCodec.AAC
            videoCodec: MediaFormat.VideoCodec.H265
        }
    }
}

지정된 mediaFormat이 지원되지 않는 경우, MediaRecorder 는 자동으로 가능한 최상의 대체 형식을 찾아 대신 사용합니다.

MediaRecorder 및 CaptureSession도 참조하십시오 .

속성 설명서

audioCodec : enumeration

멀티미디어 파일이나 스트림에 사용된 오디오 코덱을 설명합니다. 다음 값 중 하나를 가질 수 있습니다:

속성 값설명
MediaFormat.WMAWindows Media Audio
MediaFormat.AC3돌비 디지털
MediaFormat.AAC고급 오디오 코딩
MediaFormat.ALACApple 무손실 오디오 코덱
MediaFormat.DolbyTrueHDDolby TrueHD
MediaFormat.EAC3Dolby Digital Plus (EAC3)
MediaFormat.MP3MPEG-1 오디오 레이어 III 또는 MPEG-2 오디오 레이어 III
MediaFormat.Wave웨이브폼 오디오 파일 형식
MediaFormat.VorbisOgg Vorbis
MediaFormat.FLAC무손실 오디오 코덱
MediaFormat.OpusOpus 오디오 형식
MediaFormat.Unspecified미지정 코덱

fileFormat : enumeration

멀티미디어 파일이나 스트림에서 사용되는 컨테이너 형식을 설명합니다. 다음 값 중 하나를 가질 수 있습니다:

속성 값설명
MediaFormat.WMAWindows Media Audio
MediaFormat.AAC고급 오디오 코딩
MediaFormat.MatroskaMatroska (MKV)
MediaFormat.WMVWindows Media Video
MediaFormat.MP3MPEG-1 오디오 레이어 III 또는 MPEG-2 오디오 레이어 III
MediaFormat.Wave웨이브폼 오디오 파일 형식
MediaFormat.OggOgg
MediaFormat.MPEG4MPEG-4
MediaFormat.AVI오디오 비디오 인터리브
MediaFormat.QuickTime퀵타임
MediaFormat.WebMWebM
MediaFormat.Mpeg4AudioMPEG-4 Part 3 또는 MPEG-4 오디오 (공식 명칭: ISO/IEC 14496-3)
MediaFormat.FLAC무손실 오디오 코덱
MediaFormat.UnspecifiedFormat포맷이 지정되지 않았습니다.

videoCodec : enumeration

멀티미디어 파일이나 스트림에 사용된 비디오 코덱을 설명합니다. 다음 값 중 하나를 가질 수 있습니다:

속성 값설명
MediaFormat.VP8VP8
MediaFormat.MPEG2MPEG-2
MediaFormat.MPEG1MPEG-1
MediaFormat.WMVWindows Media Video
MediaFormat.H265고효율 비디오 코딩(HEVC)
MediaFormat.H264고급 비디오 코딩
MediaFormat.MPEG4MPEG-4
MediaFormat.AV1AOMedia Video 1
MediaFormat.MotionJPEGMotionJPEG
MediaFormat.VP9VP9
MediaFormat.TheoraTheora
MediaFormat.Unspecified비디오 코덱이 지정되지 않음

메서드 문서

string audioCodecDescription(codec)

codec 에 대한 설명을 반환합니다.

string audioCodecName(codec)

codec 에 대한 문자열 형식의 이름을 반환합니다.

string fileFormatDescription(fileFormat)

fileFormat 에 대한 설명을 반환합니다.

string fileFormatName(fileFormat)

fileFormat 에 대한 문자열 형식의 이름을 반환합니다.

list<AudioCodec> supportedAudioFormats(conversionMode)

선택한 파일 형식과 비디오 코덱(conversionMode)에 대한 오디오 코덱 목록을 반환합니다.

지원되는 모든 오디오 코덱을 확인하려면 기본값으로 생성된 MediaFormat에 대해 이 쿼리를 실행하십시오. 특정 파일 형식과 비디오 코덱 조합에 대해 지원되는 오디오 코덱 목록을 확인하려면, 이 쿼리를 실행하기 전에 fileFormat 및 videoCodec 속성을 설정할 수 있습니다.

QMediaFormat::ConversionMode도 참조하십시오 .

list<FileFormat> supportedFileFormats(conversionMode)

conversionMode 로 지정된 오디오 및 비디오 코덱에 대한 파일 형식 목록을 반환합니다.

지원되는 모든 파일 형식을 확인하려면 기본값으로 생성된 MediaFormat에 대해 이 쿼리를 실행하십시오. 특정 오디오 및 비디오 코덱 조합을 지원하는 파일 형식 목록을 확인하려면, 이 쿼리를 실행하기 전에 audioCodec 및 videoCodec 속성을 설정할 수 있습니다.

QMediaFormat::ConversionMode도 참조하십시오 .

list<VideoCodec> supportedVideoCodecs(conversionMode)

선택한 파일 형식과 오디오 코덱(conversionMode)에 대한 비디오 코덱 목록을 반환합니다.

지원되는 모든 비디오 코덱을 확인하려면 기본값으로 생성된 MediaFormat에 대해 이 쿼리를 실행하십시오. 특정 파일 형식과 오디오 코덱 조합에 대해 지원되는 비디오 코덱 목록을 확인하려면, 이 쿼리를 실행하기 전에 fileFormat 및 audioCodec 속성을 설정할 수 있습니다.

QMediaFormat::ConversionMode도 참조하십시오 .

string videoCodecDescription(codec)

codec 에 대한 설명을 반환합니다.

string videoCodecName(codec)

codec 에 대한 문자열 형식의 이름을 반환합니다.

© 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.