Memasangkan perangkat

Topik ini menjelaskan cara memasangkan perangkat menggunakan namespace Windows.Devices.Enumeration.

API penting

• Windows.Devices.Enumeration

Pemasangan otomatis

Terkadang Anda ingin menggunakan perangkat di aplikasi Anda, tetapi tidak peduli apakah perangkat dipasangkan atau tidak. Anda hanya ingin dapat menggunakan fungsionalitas yang terkait dengan perangkat. Misalnya, jika aplikasi Anda ingin hanya mengambil gambar dari webcam, Anda belum tentu tertarik dengan perangkat itu sendiri, hanya pengambilan gambar. Jika ada API perangkat yang tersedia untuk perangkat yang Anda minati, skenario ini akan berada di bawah pemasangan otomatis.

Dalam hal ini, Anda cukup menggunakan API yang terkait dengan perangkat, melakukan panggilan seperlunya dan mempercayai sistem untuk menangani pemasangan apa pun yang mungkin diperlukan. Beberapa perangkat tidak perlu dipasangkan agar Anda dapat menggunakan fungsionalitasnya. Jika perangkat memang perlu dipasangkan, API perangkat akan menangani tindakan pemasangan di belakang layar sehingga Anda tidak perlu mengintegrasikan fungsionalitas tersebut ke dalam aplikasi Anda. Aplikasi Anda tidak akan memiliki pengetahuan tentang apakah perangkat tertentu dipasangkan atau perlu, tetapi Anda masih akan dapat mengakses perangkat dan menggunakan fungsionalitasnya.

Pemasangan dasar

Pemasangan dasar adalah ketika aplikasi Anda menggunakan API Windows.Devices.Enumeration untuk mencoba memasangkan perangkat. Dalam skenario ini, Anda membiarkan Windows mencoba proses pemasangan dan menanganinya. Jika ada interaksi pengguna yang diperlukan, interaksi tersebut akan ditangani oleh Windows. Anda akan menggunakan pemasangan dasar jika Anda perlu memasangkan dengan perangkat dan tidak ada API perangkat yang relevan yang akan mencoba pemasangan otomatis. Anda hanya ingin dapat menggunakan perangkat dan perlu memasangkannya terlebih dahulu.

Untuk mencoba pemasangan dasar, Anda harus terlebih dahulu mendapatkan objek DeviceInformation untuk perangkat yang Anda minati. Setelah menerima objek tersebut, Anda akan berinteraksi dengan properti DeviceInformation.Pairing, yang merupakan objek DeviceInformationPairing. Untuk mencoba memasangkan, cukup panggil DeviceInformationPairing.PairAsync. Anda harus menunggu hasilnya untuk memberi aplikasi Anda waktu untuk mencoba menyelesaikan tindakan pemasangan. Hasil tindakan pemasangan akan dikembalikan, dan selama tidak ada kesalahan yang dikembalikan, perangkat akan dipasangkan.

Jika Anda menggunakan pemasangan dasar, Anda juga memiliki akses ke informasi tambahan tentang status pemasangan perangkat. Misalnya Anda mengetahui status pemasangan (IsPaired) dan apakah perangkat dapat dipasangkan (CanPair). Kedua hal ini adalah properti objek DeviceInformationPairing. Jika Anda menggunakan pemasangan otomatis, Anda mungkin tidak memiliki akses ke informasi ini kecuali Anda mendapatkan objek DeviceInformation yang relevan.

Pemasangan kustom

Pemasangan kustom memungkinkan aplikasi Anda untuk berpartisipasi dalam proses pemasangan. Ini memungkinkan aplikasi Anda menentukan DevicePairingKinds yang didukung untuk proses pemasangan. Anda juga akan bertanggung jawab untuk membuat antarmuka pengguna Anda sendiri untuk berinteraksi dengan pengguna sesuai kebutuhan. Gunakan pemasangan kustom saat Anda ingin aplikasi Anda memiliki sedikit lebih banyak pengaruh atas bagaimana proses pemasangan dilanjutkan atau menampilkan antarmuka pengguna pemasangan Anda sendiri.

Untuk menerapkan pemasangan kustom, Anda harus mendapatkan objek DeviceInformation untuk perangkat yang Anda minati, sama seperti dengan pemasangan dasar. Namun, properti tertentu yang Anda minati adalah DeviceInformation.Pairing.Custom. Ini akan memberi Anda objek DeviceInformationCustomPairing. Semua metode DeviceInformationCustomPairing.PairAsync mengharuskan Anda untuk menyertakan parameter DevicePairingKinds. Ini menunjukkan tindakan yang perlu diambil pengguna untuk mencoba memasangkan perangkat. Lihat halaman referensi DevicePairingKinds untuk informasi selengkapnya tentang berbagai jenis dan tindakan apa yang perlu diambil pengguna. Sama seperti dengan pemasangan dasar, Anda harus menunggu hasilnya untuk memberi aplikasi Anda waktu untuk mencoba menyelesaikan tindakan pemasangan. Hasil tindakan pemasangan akan dikembalikan, dan selama tidak ada kesalahan yang dikembalikan, perangkat akan dipasangkan.

Untuk mendukung pemasangan kustom, Anda harus membuat handler untuk peristiwa PairingRequested. Handler ini perlu memastikan untuk memperhitungkan semua DevicePairingKinds berbeda yang mungkin digunakan dalam skenario pemasangan kustom. Tindakan yang sesuai untuk diambil akan bergantung pada DevicePairingKinds yang disediakan sebagai bagian dari argumen peristiwa.

Penting untuk diketahui bahwa pemasangan kustom selalu merupakan operasi tingkat sistem. Karena itu, ketika Anda beroperasi di Desktop atau Windows Phone, dialog sistem akan selalu ditampilkan kepada pengguna saat pemasangan akan terjadi. Ini karena kedua platform tersebut menimbulkan pengalaman pengguna yang memerlukan persetujuan pengguna. Karena dialog tersebut dibuat secara otomatis, Anda tidak perlu membuat dialog Anda sendiri ketika Anda memilih DevicePairingKinds dari ConfirmOnly saat beroperasi pada platform ini. Untuk DevicePairingKinds lainnya, Anda harus melakukan beberapa penanganan khusus tergantung pada nilai DevicePairingKinds tertentu. Lihat sampel untuk contoh cara menangani pemasangan kustom untuk nilai DevicePairingKinds yang berbeda.

Dimulai dengan Windows 10, versi 1903, DevicePairingKinds baru didukung, ProvidePasswordCredential. Nilai ini berarti bahwa aplikasi harus meminta nama pengguna dan kata sandi dari pengguna untuk mengautentikasi dengan perangkat yang dipasangkan. Untuk menangani kasus ini, panggil metode AcceptWithPasswordCredential dari args peristiwa penanganan aktivitas PairingRequested untuk menerima pemasangan. Berikan objek PasswordCredential yang merangkum nama pengguna dan kata sandi sebagai parameter. Perhatikan bahwa nama pengguna dan kata sandi untuk perangkat jarak jauh berbeda dari dan sering kali tidak sama dengan kredensial untuk pengguna yang masuk secara lokal.

Batal berpasangan

Membatalkan pemasangan perangkat hanya relevan dalam skenario pemasangan dasar atau kustom yang dijelaskan di atas. Jika Anda menggunakan pemasangan otomatis, aplikasi Anda tetap tidak sadar dengan status pemasangan perangkat dan tidak perlu melepasnya. Jika Anda memilih untuk melepas pemasangan perangkat, prosesnya identik apakah Anda menerapkan pemasangan dasar atau kustom. Ini karena tidak perlu memberikan informasi tambahan atau berinteraksi dalam proses unpairing.

Langkah pertama untuk melepas pemasangan perangkat adalah mendapatkan objek DeviceInformation untuk perangkat yang ingin Anda lepaskan pemasangannya. Kemudian Anda perlu mengambil properti DeviceInformation.Pairing dan memanggil DeviceInformationPairing.UnpairAsync. Sama seperti dengan pemasangan, Anda akan ingin menunggu hasilnya. Hasil dari tindakan unpairing akan dikembalikan, dan selama tidak ada kesalahan yang dikembalikan, perangkat akan dilepas pemasangannya.

Sampel

Untuk sampel yang berfungsi, lihat Sampel enumerasi dan pemasangan perangkat di GitHub.