MediaCapture.GetPreviewFrameAsync 메서드

정의

네임스페이스:

Windows.Media.Capture

오버로드

GetPreviewFrameAsync()	캡처 디바이스에서 미리 보기 프레임을 가져옵니다.
GetPreviewFrameAsync(VideoFrame)	캡처 디바이스에서 미리 보기 프레임을 가져오고 제공된 대상 VideoFrame 에 복사하여 대상 프레임의 형식으로 변환합니다.

GetPreviewFrameAsync()

캡처 디바이스에서 미리 보기 프레임을 가져옵니다.

public:
 virtual IAsyncOperation<VideoFrame ^> ^ GetPreviewFrameAsync() = GetPreviewFrameAsync;

/// [Windows.Foundation.Metadata.Overload("GetPreviewFrameAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<VideoFrame> GetPreviewFrameAsync();

[Windows.Foundation.Metadata.Overload("GetPreviewFrameAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<VideoFrame> GetPreviewFrameAsync();

function getPreviewFrameAsync()

Public Function GetPreviewFrameAsync () As IAsyncOperation(Of VideoFrame)

반환

IAsyncOperation<VideoFrame>

성공적으로 완료될 때 VideoFrame 을 반환하는 비동기 작업입니다.

특성

OverloadAttribute RemoteAsyncAttribute

Windows 요구 사항

앱 기능	backgroundMediaRecording

설명

이 메서드는 프레임을 복사하거나 변환하지 않고 캡처 디바이스의 현재 형식으로 미리 보기 프레임을 반환합니다. 미리 보기 프레임을 다른 형식으로 얻으려면 GetPreviewFrameAsync(VideoFrame) 오버로드를 사용하고 원하는 형식으로 VideoFrame 을 전달합니다.

미리 보기 프레임에 대한 방법 지침은 미리 보기 프레임 가져오기를 참조하세요.

참고

컴퓨터 비전 시나리오와 같이 시퀀스에서 많은 수의 프레임을 캡처하도록 요구하는 앱 시나리오의 경우 GetPreviewFrameAsync 대신 MediaFrameReader 클래스를 사용하는 것이 좋습니다. 자세한 내용 및 방법 지침은 MediaFrameReader를 사용하여 미디어 프레임 처리를 참조하세요.

추가 정보

• GetPreviewFrameAsync(VideoFrame)
• 미리 보기 프레임 가져오기

GetPreviewFrameAsync(VideoFrame)

캡처 디바이스에서 미리 보기 프레임을 가져오고 제공된 대상 VideoFrame 에 복사하여 대상 프레임의 형식으로 변환합니다.

public:
 virtual IAsyncOperation<VideoFrame ^> ^ GetPreviewFrameAsync(VideoFrame ^ destination) = GetPreviewFrameAsync;

/// [Windows.Foundation.Metadata.Overload("GetPreviewFrameCopyAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<VideoFrame> GetPreviewFrameAsync(VideoFrame const& destination);

[Windows.Foundation.Metadata.Overload("GetPreviewFrameCopyAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<VideoFrame> GetPreviewFrameAsync(VideoFrame destination);

function getPreviewFrameAsync(destination)

Public Function GetPreviewFrameAsync (destination As VideoFrame) As IAsyncOperation(Of VideoFrame)

매개 변수

destination

VideoFrame

미리 보기 프레임을 복사할 비디오 프레임입니다.

반환

IAsyncOperation<VideoFrame>

성공적으로 완료될 때 VideoFrame 을 반환하는 비동기 작업입니다.

특성

OverloadAttribute RemoteAsyncAttribute

Windows 요구 사항

앱 기능	backgroundMediaRecording

설명

복사 또는 변환 작업을 거치지 않고 미리 보기 프레임을 얻으려면 GetPreviewFrameAsync의 인수 오버로드 없음을 사용합니다.

미리 보기 프레임에 대한 방법 지침은 미리 보기 프레임 가져오기를 참조하세요.

참고

컴퓨터 비전 시나리오와 같이 시퀀스에서 많은 수의 프레임을 캡처하도록 요구하는 앱 시나리오의 경우 GetPreviewFrameAsync 대신 MediaFrameReader 클래스를 사용하는 것이 좋습니다. 자세한 내용 및 방법 지침은 MediaFrameReader를 사용하여 미디어 프레임 처리를 참조하세요.

추가 정보

• GetPreviewFrameAsync()
• 미리 보기 프레임 가져오기