MediaCaptureVideoProfile Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mewakili profil video yang menunjukkan konfigurasi yang didukung oleh perangkat pengambilan 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 MediaCaptureVideoProfilePublic NotInheritable Class MediaCaptureVideoProfile- Warisan
- Atribut
Persyaratan Windows
| Rangkaian perangkat |
Windows 10 (diperkenalkan dalam 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)
|
| 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 atau video berkualitas tinggi, menangkap urutan foto, 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.
Profil video mengekspos tiga daftar objek MediaCaptureVideoProfileMediaDescription , SupportedPhotoMediaDescription, SupportedPreviewMediaDescription, dan SupportedRecordMediaDescription. Setiap item dalam daftar ini adalah grup pengaturan yang didukung untuk operasi terkait. Misalnya, satu profil video dapat mendukung perekaman video 720p pada 30 fps dengan dukungan video HDR dan juga mendukung perekaman video 1080p pada 30 fps tanpa dukungan video HDR. Dalam hal ini, masing-masing akan diwakili oleh objek MediaCaptureVideoProfileMediaDescription dalam daftar SupportedRecordMediaDescription profil video.
Anda mengonfigurasi perangkat pengambilan untuk menggunakan profil video tertentu dengan menggunakan objek MediaCaptureInitializationSettings . Penting bahwa profil video yang Anda gunakan saat mengonfigurasi perangkat kompatibel dengan pengaturan inisialisasi lainnya. Untuk informasi selengkapnya tentang cara menggunakan deskripsi profil media dengan benar di MediaCaptureInitializationSettings, lihat MediaCaptureInitializationSettings.VideoProfile.
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.
Riwayat versi
| Versi Windows | Versi SDK | Nilai ditambahkan |
|---|---|---|
| 1803 | 17134 | FrameSourceInfos |
| 1803 | 17134 | Properti |
Properti
| FrameSourceInfos |
Mendapatkan daftar objek MediaFrameSourceInfo baca-saja yang memberikan detail tentang kemampuan MediaFrameSource. |
| Id |
Mendapatkan pengidentifikasi unik profil video. |
| Properties |
Mendapatkan peta baca-saja dari atribut kustom yang disediakan oleh produsen perangkat tangkapan. |
| SupportedPhotoMediaDescription |
Mendapatkan daftar objek MediaCaptureVideoProfileMediaDescription yang mewakili pengaturan perangkat video yang didukung untuk pengambilan foto. |
| SupportedPreviewMediaDescription |
Mendapatkan daftar objek MediaCaptureVideoProfileMediaDescription yang mewakili pengaturan perangkat video yang didukung untuk pratinjau video. |
| SupportedRecordMediaDescription |
Mendapatkan daftar objek MediaCaptureVideoProfileMediaDescription yang mewakili pengaturan perangkat video yang didukung untuk perekaman video. |
| VideoDeviceId |
Mendapatkan ID perangkat dari perangkat video yang terkait dengan profil video. |
Metode
| GetConcurrency() |
Mendapatkan daftar objek MediaCaptureVideoProfile yang dapat digunakan secara bersamaan dengan profil video ini. |