Memasangkan perangkat

  • Artikel

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

API penting

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 hanya ingin 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 termasuk dalam 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 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 tidak, tetapi Anda masih 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 memberikan waktu kepada aplikasi Anda untuk mencoba menyelesaikan tindakan pemasangan. Hasil dari 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 memasangkan (CanPair). Keduanya 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 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 berlangsung atau untuk 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 spesifik 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 dilakukan pengguna untuk mencoba memasangkan perangkat. Lihat halaman referensi DevicePairingKinds untuk informasi selengkapnya tentang berbagai jenis dan tindakan apa yang perlu diambil pengguna. Sama seperti pemasangan dasar, Anda harus menunggu hasilnya untuk memberikan waktu kepada aplikasi Anda untuk mencoba menyelesaikan tindakan pemasangan. Hasil dari 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 mempertanggungjawabkan 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 dari 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 membatalkan pemasangan perangkat, prosesnya identik baik 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.