MediaCaptureInitializationSettings.VideoProfile Proprietà

Definizione

Spazio dei nomi:

Windows.Media.Capture

Ottiene o imposta il profilo video che fornisce suggerimenti al driver per consentire l'ottimizzazione per scenari di acquisizione diversi.

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

Valore della proprietà

MediaCaptureVideoProfile

Profilo video.

Requisiti Windows

Funzionalità dell'app

backgroundMediaRecording

Commenti

I profili video offrono un modo semplice per configurare il dispositivo di acquisizione video con un gruppo di impostazioni che garantiscono il funzionamento con un particolare dispositivo di acquisizione e sono ottimizzati per lo scenario di acquisizione desiderato. Esiste un set di profili video noti che il sistema fornisce per scenari comuni, ad esempio l'acquisizione di foto di alta qualità durante l'acquisizione di video o le videoconferenze. Per ottenere un elenco dei profili video noti per un determinato dispositivo video, usare MediaCapture.FindKnownVideoProfiles. Alcuni fornitori di hardware possono esporre altri profili video che è possibile ottenere chiamando MediaCapture.FindAllVideoProfiles. Per altre informazioni sui profili video, vedere MediaCaptureVideoProfile.

Il valore usato per questa proprietà determina il modo in cui il sistema gestisce i valori per altre proprietà di MediaCaptureInitializationSettings.

• Se imposti VideoProfile su un oggetto MediaCaptureVideoProfile valido, il sistema userà gli hint driver associati al profilo e userà i valori di descrizione multimediale specificati per le proprietà PhotoMediaDescription, PreviewMediaDescription e RecordMediaDescription .
• Se imposti VideoProfile su un oggetto MediaCaptureVideoProfile valido e non imposti le proprietà PhotoMediaDescription, PreviewMediaDescription o RecordMediaDescription , il sistema userà gli hint driver associati al profilo e userà la prima voce (0 indice) nella voce SupportedPhotoMediaDescription del profilo, SupportedPreviewMediaDescription e SupportedRecordMediaDescription e SupportedRecordMediaDescription viene elencato come descrizione multimediale per le rispettive proprietà.
• Se il valore di VideoProfile non è impostato affatto, il sistema ignora il valore di PhotoMediaDescription, PreviewMediaDescription e RecordMediaDescription e ripristina il comportamento legacy prima dell'introduzione delle API del profilo video.

Prima di usare i profili video, è necessario controllare il valore restituito da MediaCapture.IsVideoProfileSupported per assicurarsi che i profili video siano supportati dal dispositivo di acquisizione.

Per indicazioni sull'uso dei profili video, vedi Individuare e selezionare le funzionalità della fotocamera con i profili della fotocamera