다음을 통해 공유


CameraCaptureUI 클래스

정의

카메라에서 오디오, 비디오 및 사진을 캡처하기 위한 전체 창 UI를 제공합니다. 비디오 트리밍, 시간 지연 캡처 및 카메라 설정에 대한 컨트롤뿐만 아니라

public ref class CameraCaptureUI sealed
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.None)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.STA)]
class CameraCaptureUI final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.None)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.STA)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class CameraCaptureUI final
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.None)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.STA)]
public sealed class CameraCaptureUI
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.None)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.STA)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class CameraCaptureUI
function CameraCaptureUI()
Public NotInheritable Class CameraCaptureUI
상속
Object Platform::Object IInspectable CameraCaptureUI
특성

Windows 요구 사항

디바이스 패밀리
Windows 10 (10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox에서 도입되었습니다.)
API contract
Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)
앱 기능
microphone webcam

예제

이 코드는 CameraCaptureUI 클래스를 사용하여 사진을 찍는 방법을 보여줍니다. 이 코드는 카메라 캡처 UI C# 샘플의 CapturePhoto.xaml.cs 파일에서 가져옵니다. 이와 동등한 카메라 캡처 UI C++ 샘플 도 사용할 수 있습니다. 사용자와의 대화 상자는 비동기 메서드 CaptureFileAsync를 호출할 때 발생합니다.

// Using Windows.Media.Capture.CameraCaptureUI API to capture a photo
CameraCaptureUI dialog = new CameraCaptureUI();
Size aspectRatio = new Size(16, 9);
dialog.PhotoSettings.CroppedAspectRatio = aspectRatio;

StorageFile file = await dialog.CaptureFileAsync(CameraCaptureUIMode.Photo);

설명

CameraCaptureUI는 오디오, 비디오 및 이미지를 캡처하기 위한 전체 창 UI 환경을 제공합니다. 사진 캡처 시 시간 지연을 설정하고, 비디오를 트리밍하고, 비디오 해상도, 오디오 장치, 밝기 및 대비와 같은 카메라 설정을 조정하기 위한 컨트롤을 제공합니다.

CaptureFileAsync를 호출하여 UI를 시작합니다. 사용자는 캡처를 시작할 시기를 제어할 수 있습니다. 비동기 CaptureFileAsync 작업이 완료되면 StorageFile 개체가 반환됩니다. CameraCaptureUI 사용에 대한 방법 지침은 Windows 기본 제공 카메라 UI를 사용하여 사진 및 비디오 캡처를 참조하세요.

참고

CameraCaptureUI를 사용하는 경우 앱 매니페스트 파일에서 웹캠 또는 마이크 기능을 지정해서는 안 됩니다. 이렇게 하면 앱이 디바이스의 카메라 개인 정보 설정에 표시되지만 사용자가 앱에 대한 카메라 액세스를 거부하더라도 CameraCaptureUI 가 미디어를 캡처하는 것을 방지하지는 않습니다. Windows 기본 제공 카메라 앱은 사용자가 단추를 눌러서 사진, 오디오 및 비디오 캡처를 시작해야 하는 신뢰할 수 있는 자사 앱이기 때문입니다. CameraCaptureUI를 사용할 때 웹캠 또는 마이크 기능을 지정하는 경우 스토어에 제출할 때 앱이 Windows 애플리케이션 인증 키트 인증에 실패할 수 있습니다.

MediaCapture를 사용하여 오디오, 사진 또는 비디오를 프로그래밍 방식으로 캡처하는 경우 앱 매니페스트 파일에서 웹캠 또는 마이크 기능을 지정해야 합니다.

참고

이 클래스는 민첩하지 않으므로 스레딩 모델 및 마샬링 동작을 고려해야 합니다. 자세한 내용은 스레딩 및 마샬링(C++/CX)다중 스레드 환경(.NET)에서 Windows 런타임 개체 사용을 참조하세요.

생성자

CameraCaptureUI()

CameraCaptureUI 개체를 만듭니다.

속성

PhotoSettings

사진을 캡처하기 위한 설정을 제공합니다. 설정에는 가로 세로 비율, 이미지 크기, 형식, 해상도 및 UI(사용자 인터페이스)에서 자르기가 허용되는지 여부가 포함됩니다.

VideoSettings

비디오 캡처 설정을 제공합니다. 설정에는 서식, 최대 해상도, 최대 기간 및 트리밍 허용 여부가 포함됩니다.

메서드

CaptureFileAsync(CameraCaptureUIMode)

CameraCaptureUI 사용자 인터페이스를 시작합니다.

적용 대상

추가 정보