mediaFormat QML Value Type
MediaFormat은 미디어 파일의 형식을 설명합니다. 더 보기...
| Import Statement: | import QtMultimedia |
속성
- audioCodec : enumeration
- fileFormat : enumeration
- videoCodec : enumeration
방법
- string audioCodecDescription(codec)
- string audioCodecName(codec)
- string fileFormatDescription(fileFormat)
- string fileFormatName(fileFormat)
- list<AudioCodec> supportedAudioFormats(conversionMode)
- list<FileFormat> supportedFileFormats(conversionMode)
- list<VideoCodec> supportedVideoCodecs(conversionMode)
- string videoCodecDescription(codec)
- string videoCodecName(codec)
상세 설명
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.WMA | Windows Media Audio |
| MediaFormat.AC3 | 돌비 디지털 |
| MediaFormat.AAC | 고급 오디오 코딩 |
| MediaFormat.ALAC | Apple 무손실 오디오 코덱 |
| MediaFormat.DolbyTrueHD | Dolby TrueHD |
| MediaFormat.EAC3 | Dolby Digital Plus (EAC3) |
| MediaFormat.MP3 | MPEG-1 오디오 레이어 III 또는 MPEG-2 오디오 레이어 III |
| MediaFormat.Wave | 웨이브폼 오디오 파일 형식 |
| MediaFormat.Vorbis | Ogg Vorbis |
| MediaFormat.FLAC | 무손실 오디오 코덱 |
| MediaFormat.Opus | Opus 오디오 형식 |
| MediaFormat.Unspecified | 미지정 코덱 |
fileFormat : enumeration
멀티미디어 파일이나 스트림에서 사용되는 컨테이너 형식을 설명합니다. 다음 값 중 하나를 가질 수 있습니다:
| 속성 값 | 설명 |
|---|---|
| MediaFormat.WMA | Windows Media Audio |
| MediaFormat.AAC | 고급 오디오 코딩 |
| MediaFormat.Matroska | Matroska (MKV) |
| MediaFormat.WMV | Windows Media Video |
| MediaFormat.MP3 | MPEG-1 오디오 레이어 III 또는 MPEG-2 오디오 레이어 III |
| MediaFormat.Wave | 웨이브폼 오디오 파일 형식 |
| MediaFormat.Ogg | Ogg |
| MediaFormat.MPEG4 | MPEG-4 |
| MediaFormat.AVI | 오디오 비디오 인터리브 |
| MediaFormat.QuickTime | 퀵타임 |
| MediaFormat.WebM | WebM |
| MediaFormat.Mpeg4Audio | MPEG-4 Part 3 또는 MPEG-4 오디오 (공식 명칭: ISO/IEC 14496-3) |
| MediaFormat.FLAC | 무손실 오디오 코덱 |
| MediaFormat.UnspecifiedFormat | 포맷이 지정되지 않았습니다. |
videoCodec : enumeration
멀티미디어 파일이나 스트림에 사용된 비디오 코덱을 설명합니다. 다음 값 중 하나를 가질 수 있습니다:
| 속성 값 | 설명 |
|---|---|
| MediaFormat.VP8 | VP8 |
| MediaFormat.MPEG2 | MPEG-2 |
| MediaFormat.MPEG1 | MPEG-1 |
| MediaFormat.WMV | Windows Media Video |
| MediaFormat.H265 | 고효율 비디오 코딩(HEVC) |
| MediaFormat.H264 | 고급 비디오 코딩 |
| MediaFormat.MPEG4 | MPEG-4 |
| MediaFormat.AV1 | AOMedia Video 1 |
| MediaFormat.MotionJPEG | MotionJPEG |
| MediaFormat.VP9 | VP9 |
| MediaFormat.Theora | Theora |
| 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.