MediaCaptureVideoProfile Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 MediaCaptureVideoProfilePublic NotInheritable Class MediaCaptureVideoProfile- Herencia
- Atributos
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. |