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
        }
    }
}

지정된 미디어 포맷이 지원되지 않는 경우 MediaRecorder 은 자동으로 가능한 최상의 대체 포맷을 찾아서 대신 사용합니다.

MediaRecorderCaptureSession참조하세요 .

속성 문서

audioCodec : enumeration

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

속성 값설명
MediaFormat.WMAWindows 미디어 오디오
MediaFormat.AC3돌비 디지털
MediaFormat.AAC고급 오디오 코딩
MediaFormat.ALACApple 무손실 오디오 코덱
MediaFormat.DolbyTrueHDDolby TrueHD
MediaFormat.EAC3돌비 디지털 플러스(EAC3)
MediaFormat.MP3MPEG-1 오디오 레이어 III 또는 MPEG-2 오디오 레이어 III
MediaFormat.Wave파형 오디오 파일 포맷
MediaFormat.VorbisOgg Vorbis
MediaFormat.FLAC무료 무손실 오디오 코덱
MediaFormat.Opus오푸스 오디오 포맷
MediaFormat.Unspecified지정되지 않은 코덱

fileFormat : enumeration

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

속성 값설명
MediaFormat.WMAWindows 미디어 오디오
MediaFormat.AAC고급 오디오 코딩
MediaFormat.MatroskaMatroska (MKV)
MediaFormat.WMVWindows 미디어 비디오
MediaFormat.MP3MPEG-1 오디오 레이어 III 또는 MPEG-2 오디오 레이어 III
MediaFormat.Wave파형 오디오 파일 포맷
MediaFormat.OggOgg
MediaFormat.MPEG4MPEG-4
MediaFormat.AVI오디오 비디오 인터리브
MediaFormat.QuickTimeQuickTime
MediaFormat.WebMWebM
MediaFormat.Mpeg4AudioMPEG-4 파트 3 또는 MPEG-4 오디오(공식 ISO/IEC 14496-3)
MediaFormat.FLAC무료 무손실 오디오 코덱
MediaFormat.UnspecifiedFormat지정되지 않은 형식입니다.

videoCodec : enumeration

멀티미디어 파일 또는 스트림에 사용되는 동영상 코덱을 설명합니다. 다음 값 중 하나를 사용할 수 있습니다:

속성 값설명
MediaFormat.VP8VP8
MediaFormat.MPEG2MPEG-2
MediaFormat.MPEG1MPEG-1
MediaFormat.WMVWindows 미디어 비디오
MediaFormat.H265고효율 비디오 코딩(HEVC)
MediaFormat.H264고급 비디오 코딩
MediaFormat.MPEG4MPEG-4
MediaFormat.AV1AOMedia 비디오 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에서 이 쿼리를 실행합니다. 파일 형식과 비디오 코덱의 특정 조합에 대해 지원되는 오디오 코덱 목록을 가져오려면 이 쿼리를 실행하기 전에 fileFormatvideoCodec 속성을 설정하면 됩니다.

QMediaFormat::ConversionMode도 참조하세요 .


list<FileFormat> supportedFileFormats(conversionMode)

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

지원되는 모든 파일 형식을 가져오려면 기본적으로 구성된 MediaFormat에서 이 쿼리를 실행하세요. 오디오 및 비디오 코덱의 특정 조합을 지원하는 파일 형식 목록을 가져오려면 이 쿼리를 실행하기 전에 audioCodecvideoCodec 속성을 설정하면 됩니다.

QMediaFormat::ConversionMode도 참조하세요 .


list<VideoCodec> supportedVideoCodecs(conversionMode)

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

지원되는 모든 동영상 코덱을 가져오려면 기본으로 구성된 MediaFormat에서 이 쿼리를 실행하세요. 파일 형식과 오디오 코덱의 특정 조합에 대해 지원되는 비디오 코덱 목록을 가져오려면 이 쿼리를 실행하기 전에 fileFormataudioCodec 속성을 설정하면 됩니다.

QMediaFormat::ConversionMode도 참조하세요 .


string videoCodecDescription(codec)

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


string videoCodecName(codec)

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


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