MediaCaptureInitializationSettings.VideoProfile Properti

Definisi

Ruang nama:

Windows.Media.Capture

Mendapatkan atau mengatur profil video yang memberikan petunjuk kepada driver untuk memungkinkannya mengoptimalkan skenario pengambilan yang berbeda.

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

Nilai Properti

MediaCaptureVideoProfile

Profil video.

Persyaratan Windows

Kemampuan aplikasi

backgroundMediaRecording

Keterangan

Profil video menyediakan cara sederhana untuk mengonfigurasi perangkat pengambilan video dengan sekelompok pengaturan yang dijamin berfungsi dengan perangkat tangkapan tertentu dan dioptimalkan untuk skenario pengambilan yang Anda inginkan. Ada sekumpulan profil video yang diketahui yang disediakan sistem untuk skenario umum, seperti menangkap foto berkualitas tinggi selama pengambilan video atau konferensi video. Untuk mendapatkan daftar profil video yang diketahui untuk perangkat video tertentu, gunakan MediaCapture.FindKnownVideoProfiles. Beberapa vendor perangkat keras mungkin mengekspos profil video lain yang bisa Anda dapatkan dengan memanggil MediaCapture.FindAllVideoProfiles. Untuk informasi selengkapnya tentang profil video, lihat MediaCaptureVideoProfile.

Nilai yang Anda gunakan untuk properti ini menentukan bagaimana sistem menangani nilai untuk properti lain dari MediaCaptureInitializationSettings.

• Jika Anda mengatur VideoProfile ke objek MediaCaptureVideoProfile yang valid, sistem akan menggunakan petunjuk driver yang terkait dengan profil dan akan menggunakan nilai deskripsi media yang Anda tentukan untuk properti PhotoMediaDescription, PreviewMediaDescription, dan RecordMediaDescription .
• Jika Anda mengatur VideoProfile ke objek MediaCaptureVideoProfile yang valid dan Anda tidak mengatur properti PhotoMediaDescription, PreviewMediaDescription, atau RecordMediaDescription yang valid, sistem akan menggunakan petunjuk driver yang terkait dengan profil dan menggunakan entri (indeks 0) pertama dalam supportedPhotoMediaDescription profil, SupportedPreviewMediaDescription, dan SupportedRecordMediaDescription mencantumkan sebagai deskripsi media untuk properti masing-masing.
• Jika nilai VideoProfile tidak diatur sama sekali maka sistem mengabaikan nilai PhotoMediaDescription, PreviewMediaDescription, dan RecordMediaDescription dan kembali ke perilaku warisan sebelum API profil video diperkenalkan.

Sebelum menggunakan profil video, Anda harus memeriksa nilai yang dikembalikan oleh MediaCapture.IsVideoProfileSupported untuk memastikan bahwa profil video didukung oleh perangkat pengambilan.

Untuk panduan cara menggunakan profil video, lihat Menemukan dan memilih kemampuan kamera dengan profil kamera