Partilhar via


MediaCaptureVideoProfile Classe

Definição

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

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.

Aplica-se a

Confira também