MediaCaptureInitializationSettings.VideoProfile Propiedad

Definición

Espacio de nombres:

Windows.Media.Capture

Obtiene o establece el perfil de vídeo que proporciona sugerencias al controlador para permitir que se optimice para diferentes escenarios de captura.

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

Valor de propiedad

MediaCaptureVideoProfile

El perfil de vídeo.

Requisitos de Windows

Características de aplicaciones

backgroundMediaRecording

Comentarios

Los perfiles de vídeo proporcionan una manera sencilla de configurar el dispositivo de captura de vídeo con un grupo de opciones de configuración que se garantizan para trabajar con un dispositivo de captura determinado y están optimizados para su escenario de captura deseado. Hay un conjunto de perfiles de vídeo conocidos que el sistema proporciona para escenarios comunes, como capturar fotos de alta calidad durante la captura de vídeo o las conferencias de vídeo. Para obtener una lista de los perfiles de vídeo conocidos de un dispositivo de vídeo determinado, use MediaCapture.FindKnownVideoProfiles. Algunos proveedores de hardware pueden exponer otros perfiles de vídeo que puede obtener llamando a MediaCapture.FindAllVideoProfiles. Para obtener más información sobre los perfiles de vídeo, vea MediaCaptureVideoProfile.

El valor que se usa para esta propiedad determina cómo el sistema controla los valores de otras propiedades de MediaCaptureInitializationSettings.

• Si establece VideoProfile en un objeto MediaCaptureVideoProfile válido, el sistema usará las sugerencias de controlador asociadas al perfil y usará los valores de descripción multimedia que especifique para las propiedades PhotoMediaDescription, PreviewMediaDescription y RecordMediaDescription .
• Si establece VideoProfile en un objeto MediaCaptureVideoProfile válido y no establece las propiedades PhotoMediaDescription, PreviewMediaDescription o RecordMediaDescription , el sistema usará las sugerencias de controlador asociadas al perfil y usará la primera entrada (0 index) en supportedPhotoMediaDescription del perfil, SupportedPreviewMediaDescription y SupportedRecordMediaDescription . se muestra como la descripción del medio para las propiedades respectivas.
• Si el valor de VideoProfile no se establece en absoluto, el sistema omite el valor de PhotoMediaDescription, PreviewMediaDescription y RecordMediaDescription y vuelve al comportamiento heredado antes de que se introdujeran las API de perfil de vídeo.

Antes de usar perfiles de vídeo, debe comprobar el valor devuelto por MediaCapture.IsVideoProfileSupported para asegurarse de que los perfiles de vídeo son compatibles con el dispositivo de captura.

Para obtener instrucciones paso a paso sobre el uso de perfiles de vídeo, consulte Detección y selección de funcionalidades de cámara con perfiles de cámara.