MediaCaptureVideoProfile Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет видеопрофиль, указывающий конфигурацию, поддерживаемую устройством захвата видео.
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. Каждый элемент в этих списках представляет собой группу параметров, которые поддерживаются для соответствующей операции. Например, один видеопрофиль может поддерживать запись видео с разрешением 720p со разрешением 30 кадров/с с поддержкой видео в формате HDR, а также запись видео с разрешением 1080p с разрешением 30 кадров/с без поддержки видео в формате HDR. В этом случае каждый из них будет представлен объектом MediaCaptureVideoProfileMediaDescription в списке SupportedRecordMediaDescription видеопрофиля .
Устройство захвата настраивается для использования определенного видеопрофиля с помощью объекта MediaCaptureInitializationSettings . Важно, чтобы видеопрофиль, используемый при настройке устройства, был совместим с другими параметрами инициализации. Дополнительные сведения о том, как правильно использовать описания профилей мультимедиа в MediaCaptureInitializationSettings, см. в разделе MediaCaptureInitializationSettings.VideoProfile.
Перед использованием профилей видео следует проверка значение, возвращаемое MediaCapture.IsVideoProfileSupported, чтобы убедиться, что видеопрофили поддерживаются устройством захвата.
Инструкции по работе с видеопрофилями см. в статье Обнаружение и выбор возможностей камеры с помощью профилей камеры.
Журнал версий
| Версия Windows | Версия пакета SDK | Добавленная стоимость |
|---|---|---|
| 1803 | 17134 | FrameSourceInfos |
| 1803 | 17134 | Свойства |
Свойства
| FrameSourceInfos |
Возвращает доступный только для чтения список объектов MediaFrameSourceInfo , которые предоставляют сведения о возможностях MediaFrameSource. |
| Id |
Возвращает уникальный идентификатор видеопрофиля. |
| Properties |
Возвращает доступную только для чтения карту настраиваемых атрибутов, предоставляемых производителем устройства захвата. |
| SupportedPhotoMediaDescription |
Возвращает список объектов MediaCaptureVideoProfileMediaDescription , представляющих поддерживаемые параметры видеоустройства для фотозахвата. |
| SupportedPreviewMediaDescription |
Возвращает список объектов MediaCaptureVideoProfileMediaDescription , которые представляют поддерживаемые параметры видеоустройства для предварительного просмотра видео. |
| SupportedRecordMediaDescription |
Возвращает список объектов MediaCaptureVideoProfileMediaDescription , представляющих поддерживаемые параметры видеоустройства для записи видео. |
| VideoDeviceId |
Возвращает идентификатор видеоустройства, связанного с видеопрофилем. |
Методы
| GetConcurrency() |
Возвращает список объектов MediaCaptureVideoProfile , которые можно использовать одновременно с этим видеопрофилем. |