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 MediaCaptureVideoProfile
Public NotInheritable Class MediaCaptureVideoProfile
Наследование
Object Platform::Object IInspectable 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 , которые можно использовать одновременно с этим видеопрофилем.

Применяется к

См. также раздел