MediaCaptureInitializationSettings.VideoProfile Propriedade

Definição

Namespace:

Windows.Media.Capture

Obtém ou define o perfil de vídeo que fornece dicas para o driver para permitir que ele otimize para diferentes cenários de captura.

public:
 property MediaCaptureVideoProfile ^ VideoProfile { MediaCaptureVideoProfile ^ get(); void set(MediaCaptureVideoProfile ^ value); };

MediaCaptureVideoProfile VideoProfile();

void VideoProfile(MediaCaptureVideoProfile value);

public MediaCaptureVideoProfile VideoProfile { get; set; }

var mediaCaptureVideoProfile = mediaCaptureInitializationSettings.videoProfile;
mediaCaptureInitializationSettings.videoProfile = mediaCaptureVideoProfile;

Public Property VideoProfile As MediaCaptureVideoProfile

Valor da propriedade

MediaCaptureVideoProfile

O perfil de vídeo.

Requisitos do Windows

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 a captura de fotos de alta qualidade durante a captura de vídeo ou a conferência de vídeo. 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. Para obter mais informações sobre perfis de vídeo, consulte MediaCaptureVideoProfile.

O valor usado para essa propriedade determina como o sistema lida com os valores de outras propriedades do MediaCaptureInitializationSettings.

• Se você definir VideoProfile como um objeto MediaCaptureVideoProfile válido, o sistema usará as dicas de driver associadas ao perfil e usará os valores de descrição de mídia especificados para as propriedades PhotoMediaDescription, PreviewMediaDescription e RecordMediaDescription .
• Se você definir VideoProfile como um objeto MediaCaptureVideoProfile válido e não definir as propriedades PhotoMediaDescription, PreviewMediaDescription ou RecordMediaDescription , o sistema usará as dicas de driver associadas ao perfil e usará a primeira entrada (índice 0) nas propriedades SupportedPhotoMediaDescription, SupportedPreviewMediaDescription e SupportedRecordMediaDescription do perfil lista como a descrição da mídia para as respectivas propriedades.
• Se o valor de VideoProfile não estiver definido, o sistema ignorará o valor de PhotoMediaDescription, PreviewMediaDescription e RecordMediaDescription e reverterá para o comportamento herdado antes que as APIs de perfil de vídeo sejam introduzidas.

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 usar perfis de vídeo, consulte Descobrir e selecionar recursos de câmera com perfis de câmera