MediaCaptureVideoProfile 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
비디오 캡처 디바이스에서 지원하는 구성을 나타내는 비디오 프로필을 나타냅니다.
public ref class MediaCaptureVideoProfile 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.Both)]
class MediaCaptureVideoProfile 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.Both)]
public sealed class MediaCaptureVideoProfilePublic NotInheritable Class MediaCaptureVideoProfile- 상속
- 특성
Windows 요구 사항
| 디바이스 패밀리 |
Windows 10 (10.0.10240.0에서 도입되었습니다.)
|
| API contract |
Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)
|
| 앱 기능 |
backgroundMediaRecording
|
설명
비디오 프로필은 특정 캡처 디바이스에서 작동하도록 보장되고 원하는 캡처 시나리오에 최적화된 설정 그룹으로 비디오 캡처 디바이스를 구성하는 간단한 방법을 제공합니다. 시스템에서 고품질 사진 또는 비디오 캡처, 사진 시퀀스 캡처 또는 비디오 회의와 같은 일반적인 시나리오에 대해 제공하는 알려진 비디오 프로필 집합이 있습니다. 지정된 비디오 디바이스에 대해 알려진 비디오 프로필 목록을 얻으려면 MediaCapture.FindKnownVideoProfiles를 사용합니다. 일부 하드웨어 공급업체는 MediaCapture.FindAllVideoProfiles를 호출하여 얻을 수 있는 다른 비디오 프로필을 노출할 수 있습니다.
비디오 프로필은 MediaCaptureVideoProfileMediaDescription 개체, SupportedPhotoMediaDescription, SupportedPreviewMediaDescription 및 SupportedRecordMediaDescription의 세 가지 목록을 노출합니다. 이러한 목록의 각 항목은 해당 작업에 대해 지원되는 설정 그룹입니다. 예를 들어 단일 비디오 프로필은 HDR 비디오 지원을 통해 30fps에서 720p 비디오 녹화를 지원하고 HDR 비디오 지원 없이 30fps에서 1080p 비디오 녹화를 지원할 수도 있습니다. 이 경우 이러한 각 항목은 비디오 프로필의 SupportedRecordMediaDescription 목록에 있는 MediaCaptureVideoProfileMediaDescription 개체로 표시됩니다.
MediaCaptureInitializationSettings 개체를 사용하여 특정 비디오 프로필을 사용하도록 캡처 디바이스를 구성합니다. 디바이스를 구성할 때 사용하는 비디오 프로필이 다른 초기화 설정과 호환되는 것이 중요합니다. MediaCaptureInitializationSettings에서 미디어 프로필 설명을 올바르게 사용하는 방법에 대한 자세한 내용은 MediaCaptureInitializationSettings.VideoProfile을 참조하세요.
비디오 프로필을 사용하기 전에 MediaCapture.IsVideoProfileSupported에서 반환된 값을 검사 비디오 프로필이 캡처 디바이스에서 지원되는지 확인해야 합니다.
비디오 프로필 작업에 대한 방법 지침은 카메라 프로필을 사용하여 카메라 기능 검색 및 선택을 참조하세요.
버전 기록
| Windows 버전 | SDK 버전 | 추가된 값 |
|---|---|---|
| 1803 | 17134 | FrameSourceInfos |
| 1803 | 17134 | 속성 |
속성
| FrameSourceInfos |
MediaFrameSource의 기능에 대한 세부 정보를 제공하는 MediaFrameSourceInfo 개체의 읽기 전용 목록을 가져옵니다. |
| Id |
비디오 프로필의 고유 식별자를 가져옵니다. |
| Properties |
캡처 디바이스 제조업체에서 제공하는 사용자 지정 특성의 읽기 전용 맵을 가져옵니다. |
| SupportedPhotoMediaDescription |
사진 캡처에 지원되는 비디오 디바이스 설정을 나타내는 MediaCaptureVideoProfileMediaDescription 개체의 목록을 가져옵니다. |
| SupportedPreviewMediaDescription |
비디오 미리 보기에 지원되는 비디오 디바이스 설정을 나타내는 MediaCaptureVideoProfileMediaDescription 개체의 목록을 가져옵니다. |
| SupportedRecordMediaDescription |
비디오 녹화에 지원되는 비디오 디바이스 설정을 나타내는 MediaCaptureVideoProfileMediaDescription 개체의 목록을 가져옵니다. |
| VideoDeviceId |
비디오 프로필과 연결된 비디오 디바이스의 디바이스 ID를 가져옵니다. |
메서드
| GetConcurrency() |
이 비디오 프로필과 동시에 사용할 수 있는 MediaCaptureVideoProfile 개체의 목록을 가져옵니다. |