MediaCaptureVideoProfile Clase

Definición

Espacio de nombres:

Windows.Media.Capture

Representa un perfil de vídeo que indica una configuración compatible con el dispositivo de captura de vídeo.

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

Herencia

Object Platform::Object IInspectable MediaCaptureVideoProfile

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)
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 que están garantizados 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 o vídeos de alta calidad, capturar una secuencia de fotos o videoconferencias. 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.

Un perfil de vídeo expone tres listas de objetos MediaCaptureVideoProfileMediaDescription , SupportedPhotoMediaDescription, SupportedPreviewMediaDescription y SupportedRecordMediaDescription. Cada elemento de estas listas es un grupo de configuraciones que se admiten para la operación correspondiente. Por ejemplo, un único perfil de vídeo puede admitir la grabación de vídeo de 720p a 30 fps con compatibilidad con vídeo HDR y también admite la grabación de vídeo de 1080p a 30 fps sin compatibilidad con vídeo HDR. En este caso, cada uno de ellos se representaría mediante un objeto MediaCaptureVideoProfileMediaDescription en la lista SupportedRecordMediaDescription del perfil de vídeo.

El dispositivo de captura se configura para que use un perfil de vídeo determinado mediante el objeto MediaCaptureInitializationSettings . Es importante que el perfil de vídeo que use al configurar el dispositivo sea compatible con la otra configuración de inicialización. Para obtener más información sobre cómo usar correctamente las descripciones de perfil multimedia en MediaCaptureInitializationSettings, vea MediaCaptureInitializationSettings.VideoProfile.

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 para trabajar con perfiles de vídeo, consulte Detección y selección de funcionalidades de cámara con perfiles de cámara.

Historial de versiones

Versión de Windows	Versión del SDK	Valor agregado
1803	17134	FrameSourceInfos
1803	17134	Propiedades

Propiedades

FrameSourceInfos	Obtiene una lista de solo lectura de objetos MediaFrameSourceInfo que proporcionan detalles sobre las funcionalidades de un objeto MediaFrameSource.
Id	Obtiene el identificador único del perfil de vídeo.
Properties	Obtiene un mapa de solo lectura de los atributos personalizados proporcionados por el fabricante del dispositivo de captura.
SupportedPhotoMediaDescription	Obtiene una lista de objetos MediaCaptureVideoProfileMediaDescription que representan la configuración de dispositivo de vídeo compatible para la captura de fotos.
SupportedPreviewMediaDescription	Obtiene una lista de objetos MediaCaptureVideoProfileMediaDescription que representan la configuración de dispositivo de vídeo compatible para la vista previa de vídeo.
SupportedRecordMediaDescription	Obtiene una lista de objetos MediaCaptureVideoProfileMediaDescription que representan la configuración de dispositivo de vídeo compatible para la grabación de vídeo.
VideoDeviceId	Obtiene el identificador de dispositivo del dispositivo de vídeo asociado al perfil de vídeo.

Métodos

GetConcurrency()

Obtiene la lista de objetos MediaCaptureVideoProfile que se pueden usar simultáneamente con este perfil de vídeo.

Consulte también

• FindKnownVideoProfiles(String, KnownVideoProfile)
• FindAllVideoProfiles(String)
• FindConcurrentProfiles(String)
• MediaCaptureVideoProfileMediaDescription
• Descubrir y seleccionar las funcionalidades de cámara con los perfiles de cámara