MediaEncodingProfile 클래스

정의

네임스페이스:

Windows.Media.MediaProperties

오디오 또는 비디오 파일의 인코딩 프로필에 대해 설명합니다. 인코딩 프로필에는 오디오 및 비디오 인코딩 형식에 대한 설명과 미디어 컨테이너에 대한 설명이 포함됩니다.

public ref class MediaEncodingProfile sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class MediaEncodingProfile final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class MediaEncodingProfile

function MediaEncodingProfile()

Public NotInheritable Class MediaEncodingProfile

상속

Object Platform::Object IInspectable MediaEncodingProfile

특성

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

설명

인코딩 품질 자동 은 현재 카메라 설정에 따라 적절한 설정을 채우는 특수한 사전 설정입니다. 수동으로 수정된 설정은 무시됩니다. 예를 들어 CreateM4a와 같은 정적 만들기 메서드 중 하나를 사용하여 미리 설정된 프로필을 만들고 Auto 를 인코딩 품질로 지정하면 속성에 대한 변경 내용을 현재 카메라 설정에 따라 값으로 덮어씁니다.

참고

특정 디바이스에서 지원되지 않는 MediaEncodingProfile 을 만들 수 있습니다. 예를 들어 CreateMp3을 성공적으로 호출할 수 있지만 mp3 인코더가 디바이스에 없으면 이 메서드에서 반환된 속성으로 오디오를 인코딩하려고 하면 실패합니다. 각 디바이스 패밀리에 대해 기본적으로 존재하는 코덱 목록은 지원되는 코덱을 참조하세요.

참고

비디오 인코딩 프로필 형식만 자동의 인코딩 품질 설정을 지원합니다. 오디오 프로필은 이 설정을 지원하지 않으며 설정을 사용할 때 오류가 발생합니다. 예: AudioEncodingQuality.Auto와 함께 MediaEncodingProfile.CreateMp3을 사용하여 프로필을 만든 다음 PrepareStreamTranscodeAsync를 호출하면 NullReferenceException 오류가 발생합니다. 이 경우 기능 프로필을 만들 수 있도록 자동 이외의 인코딩 품질 설정을 선택해야 합니다.

MediaEncodingProfile을 사용하여 캡처된 이미지에 대한 인코딩 속성을 설정하는 방법에 대한 지침은 MediaCapture를 사용하여 기본 사진, 비디오 및 오디오 캡처를 참조하세요. 미디어 파일을 코드 변환 할 때 MediaEncodingProfile 을 사용하는 방법에 대한 자세한 내용은 미디어 파일 코드 변환을 참조하세요.

버전 기록

Windows 버전	SDK 버전	추가된 값
1703	15063	CreateAlac
1703	15063	CreateFlac
1703	15063	CreateHevc
1709	16299	GetAudioTracks
1709	16299	GetVideoTracks
1709	16299	SetAudioTracks
1709	16299	SetVideoTracks
1803	17134	GetTimedMetadataTracks
1803	17134	SetTimedMetadataTracks

생성자

MediaEncodingProfile()

MediaEncodingProfile 클래스의 새 instance 만듭니다.

속성

Audio	오디오 스트림의 인코딩 속성을 가져오거나 설정합니다.
Container	미디어 컨테이너의 속성을 가져오거나 설정합니다.
Video	비디오 스트림의 인코딩 속성을 가져오거나 설정합니다.

메서드

CreateAlac(AudioEncodingQuality)	Apple ALAC(무손실 오디오 코덱) 오디오용 MediaEncodingProfile의 instance 만듭니다.
CreateAv1(VideoEncodingQuality)	AOMedia Video 1(AV1) 비디오에 대한 인코딩 프로필을 만듭니다.
CreateAvi(VideoEncodingQuality)	AVI용 MediaEncodingProfile의 instance 만듭니다.
CreateFlac(AudioEncodingQuality)	무료 FLAC(무손실 오디오 코덱) 오디오에 대한 MediaEncodingProfile의 instance 만듭니다.
CreateFromFileAsync(IStorageFile)	기존 미디어 파일에서 인코딩 프로필을 만듭니다.
CreateFromStreamAsync(IRandomAccessStream)	미디어 데이터가 포함된 스트림에서 인코딩 프로필을 만듭니다.
CreateHevc(VideoEncodingQuality)	H.265 비디오라고도 하는 HEVC(고효율 비디오 코딩) 비디오용 MediaEncodingProfile의 instance 만듭니다.
CreateM4a(AudioEncodingQuality)	AAC 오디오에 대한 인코딩 프로필을 만듭니다.
CreateMp3(AudioEncodingQuality)	MP3(MPEG-1 계층 3) 오디오에 대한 인코딩 프로필을 만듭니다.
CreateMp4(VideoEncodingQuality)	H.264 비디오에 대한 인코딩 프로필을 만듭니다.
CreateVp9(VideoEncodingQuality)	VP9 비디오에 대한 인코딩 프로필을 만듭니다.
CreateWav(AudioEncodingQuality)	WAV용 MediaEncodingProfile의 instance 만듭니다.
CreateWma(AudioEncodingQuality)	WMA(Windows Media Audio)에 대한 인코딩 프로필을 만듭니다.
CreateWmv(VideoEncodingQuality)	WMV(Windows Media Video)에 대한 인코딩 프로필을 만듭니다.
GetAudioTracks()	MediaEncodingProfile에 포함된 오디오 스트림을 설명하는 AudioStreamDescriptor 개체 목록을 검색합니다.
GetTimedMetadataTracks()	MediaEncodingProfile에 포함된 시간 제한 메타데이터 스트림을 설명하는 TimedMetadataStreamDescriptor 개체 목록을 검색합니다.
GetVideoTracks()	MediaEncodingProfile에 포함된 비디오 스트림을 설명하는 VideoStreamDescriptor 개체 목록을 검색합니다.
SetAudioTracks(IIterable<AudioStreamDescriptor>)	MediaEncodingProfile에 포함된 오디오 스트림을 설명하는 AudioStreamDescriptor 개체 목록을 설정합니다.
SetTimedMetadataTracks(IIterable<TimedMetadataStreamDescriptor>)	MediaEncodingProfile에 포함된 시간 제한 메타데이터 스트림을 설명하는 TimedMetadataStreamDescriptor 개체 목록을 설정합니다.
SetVideoTracks(IIterable<VideoStreamDescriptor>)	MediaEncodingProfile에 포함된 비디오 스트림을 설명하는 VideoStreamDescriptor 개체 목록을 설정합니다.

추가 정보

• 미디어 코드 변환 샘플(Windows 10)
• MediaCapture를 사용하여 기본적인 사진, 비디오 및 오디오 캡처
• 미디어 파일 코드 변환