Bagikan melalui

MediaCaptureVideoProfile Kelas

  • Referensi

Definisi

Ruang nama:
Windows.Media.Capture
Edit

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 MediaCaptureVideoProfile
Public NotInheritable Class MediaCaptureVideoProfile
Warisan
Object Platform::Object IInspectable MediaCaptureVideoProfile
Atribut
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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.

Berlaku untuk

Lihat juga