MediaCaptureInitializationSettings.VideoProfile Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает видеопрофиль, который предоставляет указания драйверу, чтобы позволить ему оптимизироваться для различных сценариев захвата.
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
Значение свойства
Видеопрофиль.
Требования к Windows
Возможности приложения |
backgroundMediaRecording
|
Комментарии
Профили видео предоставляют простой способ настройки устройства захвата видео с помощью группы параметров, которые гарантированно будут работать с определенным устройством захвата и оптимизированы для требуемого сценария захвата. Существует набор известных профилей видео, которые система предоставляет для распространенных сценариев, таких как запись высококачественных фотографий во время захвата видео или видеоконференций. Чтобы получить список известных профилей видео для данного видеоустройства, используйте MediaCapture.FindKnownVideoProfiles. Некоторые поставщики оборудования могут предоставлять другие профили видео, которые можно получить, вызвав MediaCapture.FindAllVideoProfiles. Дополнительные сведения о профилях видео см. в разделе MediaCaptureVideoProfile.
Значение, используемое для этого свойства, определяет, как система обрабатывает значения для других свойств MediaCaptureInitializationSettings.
- Если для VideoProfile задан допустимый объект MediaCaptureVideoProfile , система будет использовать указания драйвера, связанные с профилем, и использовать значения описания мультимедиа, указанные для свойств PhotoMediaDescription, PreviewMediaDescription и RecordMediaDescription .
- Если для VideoProfile задан допустимый объект MediaCaptureVideoProfile и вы не задали свойства PhotoMediaDescription, PreviewMediaDescription или RecordMediaDescription , система будет использовать указания драйвера, связанные с профилем, и использовать первую запись (индекс 0) в свойствах SupportedPhotoMediaDescription, SupportedPreviewMediaDescription и SupportedRecordMediaDescription профиля. список в качестве описания носителя для соответствующих свойств.
- Если значение VideoProfile не задано вообще, система игнорирует значение PhotoMediaDescription, PreviewMediaDescription и RecordMediaDescription и возвращается к устаревшей модели поведения до появления API видеопрофиля.
Перед использованием профилей видео следует проверка значение, возвращаемое MediaCapture.IsVideoProfileSupported, чтобы убедиться, что видеопрофили поддерживаются устройством захвата.
Инструкции по использованию видеопрофилей см. в статье Обнаружение и выбор возможностей камеры с помощью профилей камеры.