MediaCaptureInitializationSettings.VideoProfile 属性

定义

命名空间:

Windows.Media.Capture

获取或设置视频配置文件，该配置文件向驱动程序提供提示，使其能够针对不同的捕获方案进行优化。

public:
 property MediaCaptureVideoProfile ^ VideoProfile { MediaCaptureVideoProfile ^ get(); void set(MediaCaptureVideoProfile ^ value); };

MediaCaptureVideoProfile VideoProfile();

void VideoProfile(MediaCaptureVideoProfile value);

public MediaCaptureVideoProfile VideoProfile { get; set; }

var mediaCaptureVideoProfile = mediaCaptureInitializationSettings.videoProfile;
mediaCaptureInitializationSettings.videoProfile = mediaCaptureVideoProfile;

Public Property VideoProfile As MediaCaptureVideoProfile

属性值

MediaCaptureVideoProfile

视频配置文件。

Windows 要求

应用功能	backgroundMediaRecording

注解

视频配置文件提供了一种简单的方法来配置视频捕获设备，其中包含一组保证适用于特定捕获设备的设置，并针对所需的捕获方案进行优化。 系统为常见方案提供一组已知视频配置文件，例如在视频捕获或视频会议期间捕获高质量照片。 若要获取给定视频设备的已知视频配置文件列表，请使用 MediaCapture.FindKnownVideoProfiles。 某些硬件供应商可能会公开可以通过调用 MediaCapture.FindAllVideoProfiles 获取的其他视频配置文件。 有关视频配置文件的详细信息，请参阅 MediaCaptureVideoProfile。

用于此属性的值确定系统如何处理 MediaCaptureInitializationSettings 的其他属性的值。

• 如果将 VideoProfile 设置为有效的 MediaCaptureVideoProfile 对象，系统将使用与配置文件关联的驱动程序提示，并使用为 PhotoMediaDescription、 PreviewMediaDescription 和 RecordMediaDescription 属性指定的媒体说明值。
• 如果将 VideoProfile 设置为有效的 MediaCaptureVideoProfile 对象，并且未设置 PhotoMediaDescription， PreviewMediaDescription 或 RecordMediaDescription 属性，系统将使用与配置文件关联的驱动程序提示，并使用配置文件的 SupportedPhotoMediaDescription、 SupportedPreviewMediaDescription 和 SupportedRecordMediaDescription 中的第一个 (0 索引) 条目列出作为相应属性的媒体说明。
• 如果根本不设置 VideoProfile 的值，则系统会忽略 PhotoMediaDescription、PreviewMediaDescription 和 RecordMediaDescription 的值，并在引入视频配置文件 API 之前还原为旧行为。

在使用视频配置文件之前，应检查 MediaCapture.IsVideoProfileSupported 返回的值，以确保捕获设备支持视频配置文件。

有关使用视频配置文件的操作指南，请参阅 使用相机配置文件发现和选择相机功能