MediaCaptureInitializationSettings 클래스

정의

MediaCapture.InitializeAsync 메서드에 전달되는 MediaCapture 개체에 대한 초기화 설정을 포함합니다.

public ref class MediaCaptureInitializationSettings 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.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class MediaCaptureInitializationSettings final
/// [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.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class MediaCaptureInitializationSettings 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.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class MediaCaptureInitializationSettings
[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.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class MediaCaptureInitializationSettings
function MediaCaptureInitializationSettings()
Public NotInheritable Class MediaCaptureInitializationSettings
상속
Object Platform::Object IInspectable MediaCaptureInitializationSettings
특성

Windows 요구 사항

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

예제

다음 예제에서는 MediaCaptureInitializationSettings를 초기화합니다. 이러한 설정을 사용하여 InitializeAsync 를 호출하여 MediaCapture 개체를 초기화합니다.

private void InitCaptureSettings()
{
    _captureInitSettings = null;
    _captureInitSettings = new Windows.Media.Capture.MediaCaptureInitializationSettings();
    _captureInitSettings.AudioDeviceId = "";
    _captureInitSettings.VideoDeviceId = "";
    _captureInitSettings.StreamingCaptureMode = Windows.Media.Capture.StreamingCaptureMode.AudioAndVideo;
    _captureInitSettings.PhotoCaptureSource = Windows.Media.Capture.PhotoCaptureSource.VideoPreview;
    
    if (_deviceList.Count > 0)
        _captureInitSettings.VideoDeviceId = _deviceList[0].Id;
}

설명

MediaCapture 개체를 초기화하고 종료하는 방법에 대한 방법 지침은 MediaCapture를 사용하여 기본 사진, 비디오 및 오디오 캡처를 참조하세요.

참고

MediaCaptureSharingMode::SharedReadOnly를 사용하는 경우 MediaCaptureInitializationSettings 속성 중 일부를 구성할 수 없습니다. 자세한 내용은 SharingMode 를 참조하세요.

버전 기록

Windows 버전 SDK 버전 추가된 값
1607 14393 MemoryPreference
1607 14393 SharingMode
1607 14393 SourceGroup
1703 15063 AlwaysPlaySystemShutterSound
2004 19041 DeviceUri
2004 19041 DeviceUriPasswordCredential

생성자

MediaCaptureInitializationSettings()

MediaCaptureInitializationSettings 개체의 새 instance 만듭니다.

속성

AlwaysPlaySystemShutterSound

사진을 캡처할 때 시스템이 항상 셔터 소리를 재생해야 하는지 여부를 나타내는 값을 가져옵니다.

AudioDeviceId

마이크의 DeviceInformation.Id 가져옵니다.

AudioProcessing

오디오 처리 모드를 지정하는 값을 가져오거나 설정합니다.

AudioSource

캡처 작업의 오디오 원본을 가져오거나 설정합니다.

DeviceUri

초기화할 원격 캡처 디바이스의 URI를 가져오거나 설정합니다.

DeviceUriPasswordCredential

초기화할 원격 캡처 디바이스에 액세스하는 데 사용되는 자격 증명을 나타내는 PasswordCredential 개체를 가져오거나 설정합니다.

MediaCategory

미디어 범주를 가져오거나 설정합니다.

MemoryPreference

MediaCapture에서 사용하는 MediaFrameSource에서 가져온 프레임을 저장하기 위한 기본 메모리 위치를 지정하는 개체를 가져오거나 설정합니다.

PhotoCaptureSource

사진 캡처에 사용되는 스트림을 가져오거나 설정합니다.

PhotoMediaDescription

사진 캡처에 대한 미디어 설명을 가져오거나 설정합니다.

PreviewMediaDescription

미리 보기 비디오에 대한 미디어 설명을 가져오거나 설정합니다.

RecordMediaDescription

비디오 녹화에 대한 미디어 설명을 가져오거나 설정합니다.

SharingMode

MediaCapture의 공유 모드를 지정하는 개체를 가져오거나 설정합니다.

SourceGroup

MediaCapture를 초기화할 MediaFrameSourceGroup을 가져오거나 설정합니다. 이 속성은 동시에 사용할 수 있는 미디어 프레임 원본 집합을 정의합니다.

StreamingCaptureMode

스트리밍 모드를 가져오거나 설정합니다.

VideoDeviceId

비디오 카메라의 DeviceInformation.Id 가져옵니다.

VideoProfile

다양한 캡처 시나리오에 최적화할 수 있도록 드라이버에 힌트를 제공하는 비디오 프로필을 가져오거나 설정합니다.

VideoSource

캡처 작업의 비디오 원본을 가져오거나 설정합니다.

적용 대상

추가 정보