MediaCapture.SetEncodingPropertiesAsync 메서드

  • 참조

정의

네임스페이스:
Windows.Media.Capture
편집

미디어 인코딩 속성을 비동기적으로 설정합니다.

public:
 virtual IAsyncAction ^ SetEncodingPropertiesAsync(MediaStreamType mediaStreamType, IMediaEncodingProperties ^ mediaEncodingProperties, MediaPropertySet ^ encoderProperties) = SetEncodingPropertiesAsync;
IAsyncAction SetEncodingPropertiesAsync(MediaStreamType const& mediaStreamType, IMediaEncodingProperties const& mediaEncodingProperties, MediaPropertySet const& encoderProperties);
public IAsyncAction SetEncodingPropertiesAsync(MediaStreamType mediaStreamType, IMediaEncodingProperties mediaEncodingProperties, MediaPropertySet encoderProperties);
function setEncodingPropertiesAsync(mediaStreamType, mediaEncodingProperties, encoderProperties)
Public Function SetEncodingPropertiesAsync (mediaStreamType As MediaStreamType, mediaEncodingProperties As IMediaEncodingProperties, encoderProperties As MediaPropertySet) As IAsyncAction

매개 변수

mediaStreamType
MediaStreamType

스트림이 나타내는 미디어 데이터 형식(예: 비디오 또는 오디오)입니다.

mediaEncodingProperties
IMediaEncodingProperties

미디어 인코딩의 속성입니다.

encoderProperties
MediaPropertySet

인코더의 속성입니다.

반환

IAsyncAction

비동기 작업을 제어하는 데 사용되는 개체입니다.

Windows 요구 사항

앱 기능
backgroundMediaRecording

설명

이 메서드는 데이터를 CaptureElement 에 전달하여 표시하거나, IRandomAccessStream 또는 StorageFile에 기록하거나, 사용자 지정 미디어 싱크에 전달하기 전에 데이터를 처리하는 인코더의 인코딩 속성을 설정합니다. 이 메서드는 카메라 디바이스인 데이터 원본의 구성을 변경하지 않습니다. 인코딩 속성을 카메라에서 기본적으로 지원하지 않는 해상도로 설정할 수 있습니다. 이 경우 MediaCapture 파이프라인은 인코더를 사용하여 요청된 형식으로 변환을 수행합니다. 이 변환은 시스템 리소스를 사용하며, 특히 그래픽 가속이 제한되거나 없는 디바이스에서 성능이 저하되거나 오류가 발생할 수 있습니다. 일반적인 시나리오의 경우 원하는 해상도에 가장 가까운 카메라에서 지원하는 해상도를 선택하는 것이 좋습니다. VideoDeviceController.GetAvailableMediaStreamProperties를 호출하여 캡처 디바이스의 지원되는 해상도 목록을 가져올 수 있습니다. 자세한 내용은 MediaCapture의 형식, 해상도 및 프레임 속도 설정 및카메라 해상도 샘플을 참조하세요.

참고

SetEncodingPropertiesAsync 는 기본 미리 보기 스트림이 스트리밍 상태인 경우에만 성공합니다. 즉, StartPreviewAsync 가 성공적으로 호출된 후에만 성공합니다. MediaCapture 개체가 MediaPlayerElement 또는 MediaFrameReader를 통해 MediaFrameSource에서 비디오를 스트리밍하는 동안 SetEncodingPropertiesAsync가 호출되면 이 호출이 실패합니다.

레코드 또는 미리 보기 스트림을 회전하려면 MF_MT_VIDEO_ROTATION 정의된 GUID를 사용하여 스트림에 메타데이터를 추가합니다. 이 회전은 CaptureElement 또는 비디오 플레이어 앱과 같은 스트림의 소비자가 수행하는 반면 스트림의 실제 픽셀은 원래 방향을 유지합니다. 카메라를 사용할 때 방향 처리에 대한 방법 지침은 MediaCapture를 사용하여 디바이스 방향 처리를 참조하세요.

캡처 디바이스의 속성을 수정하려면 VideoDeviceController.SetMediaStreamPropertiesAsync를 사용합니다.

적용 대상

추가 정보