MediaCaptureVideoProfile Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Representa um perfil de vídeo que indica uma configuração compatível com o 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- Herança
- Atributos
Requisitos do Windows
| Família de dispositivos |
Windows 10 (introduzida na 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduzida na v1.0)
|
| Funcionalidades do aplicativo |
backgroundMediaRecording
|
Comentários
Os perfis de vídeo fornecem uma maneira simples de configurar o dispositivo de captura de vídeo com um grupo de configurações que têm a garantia de trabalhar com um dispositivo de captura específico e são otimizadas para o cenário de captura desejado. Há um conjunto de perfis de vídeo conhecidos que o sistema fornece para cenários comuns, como capturar fotos ou vídeos de alta qualidade, capturar uma sequência de fotos ou videoconferência. Para obter uma lista dos perfis de vídeo conhecidos de um determinado dispositivo de vídeo, use MediaCapture.FindKnownVideoProfiles. Alguns fornecedores de hardware podem expor outros perfis de vídeo que você pode obter chamando MediaCapture.FindAllVideoProfiles.
Um perfil de vídeo expõe três listas de objetos MediaCaptureVideoProfileMediaDescription , SupportedPhotoMediaDescription, SupportedPreviewMediaDescription e SupportedRecordMediaDescription. Cada item nessas listas é um grupo de configurações com suporte para a operação correspondente. Por exemplo, um único perfil de vídeo pode dar suporte à gravação de vídeo de 720p a 30 fps com suporte a vídeo HDR e também dar suporte à gravação de vídeo de 1080p a 30 fps sem suporte a vídeo HDR. Nesse caso, cada um deles seria representado por um objeto MediaCaptureVideoProfileMediaDescription na lista SupportedRecordMediaDescription do perfil de vídeo.
Configure o dispositivo de captura para usar um perfil de vídeo específico usando o objeto MediaCaptureInitializationSettings . É importante que o perfil de vídeo usado ao configurar o dispositivo seja compatível com as outras configurações de inicialização. Para obter mais informações sobre como usar corretamente descrições de perfil de mídia no MediaCaptureInitializationSettings, consulte MediaCaptureInitializationSettings.VideoProfile.
Antes de usar perfis de vídeo, você deve marcar o valor retornado por MediaCapture.IsVideoProfileSupported para garantir que os perfis de vídeo sejam compatíveis com o dispositivo de captura.
Para obter diretrizes sobre como trabalhar com perfis de vídeo, consulte Descobrir e selecionar recursos de câmera com perfis de câmera.
Histórico de versão
| Versão do Windows | Versão do SDK | Valor adicionado |
|---|---|---|
| 1803 | 17134 | FrameSourceInfos |
| 1803 | 17134 | Propriedades |
Propriedades
| FrameSourceInfos |
Obtém uma lista somente leitura de objetos MediaFrameSourceInfo que fornecem detalhes sobre os recursos de um MediaFrameSource. |
| Id |
Obtém o identificador exclusivo do perfil de vídeo. |
| Properties |
Obtém um mapa somente leitura de atributos personalizados fornecidos pelo fabricante do dispositivo de captura. |
| SupportedPhotoMediaDescription |
Obtém uma lista de objetos MediaCaptureVideoProfileMediaDescription que representam as configurações de dispositivo de vídeo com suporte para captura de fotos. |
| SupportedPreviewMediaDescription |
Obtém uma lista de objetos MediaCaptureVideoProfileMediaDescription que representam as configurações de dispositivo de vídeo com suporte para visualização de vídeo. |
| SupportedRecordMediaDescription |
Obtém uma lista de objetos MediaCaptureVideoProfileMediaDescription que representam as configurações de dispositivo de vídeo com suporte para gravação de vídeo. |
| VideoDeviceId |
Obtém a ID do dispositivo de vídeo associado ao perfil de vídeo. |
Métodos
| GetConcurrency() |
Obtém a lista de objetos MediaCaptureVideoProfile que podem ser usados simultaneamente com este perfil de vídeo. |