MediaCaptureVideoProfile Classe

Definição

Namespace:

Windows.Media.Capture

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 MediaCaptureVideoProfile

Public NotInheritable Class MediaCaptureVideoProfile

Herança

Object Platform::Object IInspectable MediaCaptureVideoProfile

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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.

Confira também

• FindKnownVideoProfiles(String, KnownVideoProfile)
• FindAllVideoProfiles(String)
• FindConcurrentProfiles(String)
• MediaCaptureVideoProfileMediaDescription
• Descobrir e selecionar as funcionalidades da câmera com perfis de câmera