CameraCaptureUI Kelas

  • Referensi

Definisi

Ruang nama:
Windows.Media.Capture
Edit

Menyediakan antarmuka pengguna jendela penuh untuk menangkap audio, video, dan foto dari kamera. Serta kontrol untuk pemangkasan video, pengambilan waktu tertunda, dan pengaturan kamera.

public ref class CameraCaptureUI sealed
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.None)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.STA)]
class CameraCaptureUI final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.None)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.STA)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class CameraCaptureUI final
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.None)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.STA)]
public sealed class CameraCaptureUI
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.None)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.STA)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class CameraCaptureUI
function CameraCaptureUI()
Public NotInheritable Class CameraCaptureUI
Warisan
Object Platform::Object IInspectable CameraCaptureUI
Atribut
ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Persyaratan Windows

Rangkaian perangkat
Windows 10 (diperkenalkan dalam 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)
Kemampuan aplikasi
microphone webcam

Contoh

Kode ini menunjukkan cara menggunakan kelas CameraCaptureUI untuk mengambil gambar. Kode ini berasal dari file CapturePhoto.xaml.cs dari sampel Camera capture UI C#. Sampel C++ UI pengambilan Kamera yang setara juga tersedia. Dialog dengan pengguna terjadi saat Anda memanggil metode asinkron CaptureFileAsync.

// Using Windows.Media.Capture.CameraCaptureUI API to capture a photo
CameraCaptureUI dialog = new CameraCaptureUI();
Size aspectRatio = new Size(16, 9);
dialog.PhotoSettings.CroppedAspectRatio = aspectRatio;

StorageFile file = await dialog.CaptureFileAsync(CameraCaptureUIMode.Photo);

Keterangan

CameraCaptureUI menyediakan pengalaman antarmuka pengguna jendela penuh untuk menangkap audio, video, dan gambar. Ini menyediakan kontrol untuk mengatur penundaan waktu pada pengambilan foto, pemangkasan video, dan untuk menyesuaikan pengaturan kamera seperti resolusi video, perangkat audio, kecerahan, dan kontras.

Panggil CaptureFileAsync untuk meluncurkan UI. Pengguna memiliki kontrol atas kapan harus memulai pengambilan. Ketika operasi CaptureFileAsync asinkron selesai, objek StorageFile dikembalikan. Untuk panduan cara menggunakan CameraCaptureUI, lihat Mengambil foto dan video dengan UI kamera bawaan Windows

Catatan

Anda tidak boleh menentukan kemampuan webcam atau mikrofon dalam file manifes aplikasi Jika Anda menggunakan CameraCaptureUI. Jika Anda melakukannya, aplikasi Anda akan ditampilkan di pengaturan privasi kamera perangkat, tetapi bahkan jika pengguna menolak akses kamera ke aplikasi Anda, itu tidak akan mencegah CameraCaptureUI menangkap media. Ini karena aplikasi kamera bawaan Windows adalah aplikasi pihak pertama tepercaya yang mengharuskan pengguna untuk memulai pengambilan foto, audio, dan video dengan menekan tombol. Aplikasi Anda mungkin gagal sertifikasi Windows Application Certification Kit saat dikirimkan ke Store jika Anda menentukan kemampuan webcam atau mikrofon saat menggunakan CameraCaptureUI.

Anda harus menentukan kemampuan webcam atau mikrofon dalam file manifes aplikasi jika Anda menggunakan MediaCapture untuk mengambil audio, foto, atau video secara terprogram.

Catatan

Kelas ini tidak tangkas, yang berarti Anda perlu mempertimbangkan model utas dan perilaku marshalingnya. Untuk informasi selengkapnya, lihat Threading dan Marshaling (C++/CX) dan Menggunakan objek Windows Runtime di lingkungan multithreaded (.NET).

Konstruktor

CameraCaptureUI()

Buat objek CameraCaptureUI baru.

Properti

PhotoSettings

Menyediakan pengaturan untuk mengambil foto. Pengaturan termasuk rasio aspek, ukuran gambar, format, resolusi, dan apakah pemotongan diizinkan oleh antarmuka pengguna (UI) atau tidak.
VideoSettings

Menyediakan pengaturan untuk merekam video. Pengaturan mencakup format, resolusi maksimum, durasi maksimum, dan apakah akan mengizinkan pemangkasan atau tidak.

Metode

CaptureFileAsync(CameraCaptureUIMode)

Meluncurkan antarmuka pengguna CameraCaptureUI .

Berlaku untuk

Lihat juga