MediaCaptureVideoProfile Classe

  • Riferimento

Definizione

Spazio dei nomi:
Windows.Media.Capture
Modifica

Rappresenta un profilo video che indica una configurazione supportata dal dispositivo di acquisizione video.

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
Ereditarietà
Object Platform::Object IInspectable MediaCaptureVideoProfile
Attributi
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)
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 o video di alta qualità, l'acquisizione di una sequenza di foto o di videoconferenza. 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.

Un profilo video espone tre elenchi di oggetti MediaCaptureVideoProfileMediaDescription , SupportedPhotoMediaDescription, SupportedPreviewMediaDescription e SupportedRecordMediaDescription. Ogni elemento in questi elenchi è un gruppo di impostazioni supportate per l'operazione corrispondente. Ad esempio, un singolo profilo video può supportare la registrazione di video 720p a 30 fps con supporto video HDR e supporta anche la registrazione di video 1080p a 30 fps senza supporto video HDR. In questo caso, ognuno di questi elementi sarà rappresentato da un oggetto MediaCaptureVideoProfileMediaDescription nell'elenco SupportedRecordMediaDescription del profilo video.

Configurare il dispositivo di acquisizione per l'uso di un profilo video specifico usando l'oggetto MediaCaptureInitializationSettings . È importante che il profilo video usato durante la configurazione del dispositivo sia compatibile con le altre impostazioni di inizializzazione. Per altre informazioni su come usare correttamente le descrizioni dei profili multimediali in MediaCaptureInitializationSettings, vedere MediaCaptureInitializationSettings.VideoProfile.

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 pratiche sull'uso dei profili video, vedi Individuare e selezionare le funzionalità della fotocamera con i profili della fotocamera.

Cronologia delle versioni

Versione di Windows Versione dell'SDK Valore aggiunto
1803 17134 FrameSourceInfos
1803 17134 Proprietà

Proprietà

FrameSourceInfos

Ottiene un elenco di sola lettura di oggetti MediaFrameSourceInfo che forniscono informazioni dettagliate sulle funzionalità di un Oggetto MediaFrameSource.
Id

Ottiene l'identificatore univoco del profilo video.
Properties

Ottiene una mappa di sola lettura degli attributi personalizzati forniti dal produttore del dispositivo di acquisizione.
SupportedPhotoMediaDescription

Ottiene un elenco di oggetti MediaCaptureVideoProfileMediaDescription che rappresentano le impostazioni del dispositivo video supportate per l'acquisizione di foto.
SupportedPreviewMediaDescription

Ottiene un elenco di oggetti MediaCaptureVideoProfileMediaDescription che rappresentano le impostazioni del dispositivo video supportate per l'anteprima video.
SupportedRecordMediaDescription

Ottiene un elenco di oggetti MediaCaptureVideoProfileMediaDescription che rappresentano le impostazioni del dispositivo video supportate per la registrazione video.
VideoDeviceId

Ottiene l'ID dispositivo del dispositivo video associato al profilo video.

Metodi

GetConcurrency()

Ottiene l'elenco di oggetti MediaCaptureVideoProfile che possono essere utilizzati simultaneamente con questo profilo video.

Si applica a

Vedi anche