Memasangkan perangkat

API Penting

Beberapa perangkat perlu dipasangkan sebelum dapat digunakan. Windows. Devices.Enumeration namespace mendukung tiga cara berbeda untuk memasangkan perangkat.

  • Pemasangan otomatis
  • Pasangan dasar
  • Pemasangan kustom

Ujung Beberapa perangkat tidak perlu dipasangkan untuk digunakan. Ini tercakup dalam bagian pada pemasangan otomatis.

 

Pemasangan otomatis

Terkadang Anda ingin menggunakan perangkat di aplikasi Anda, tetapi tidak peduli apakah perangkat dipasangkan atau tidak. Anda hanya ingin dapat menggunakan fungsi yang terkait dengan perangkat. Misalnya, jika aplikasi Anda hanya ingin menangkap 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, membuat panggilan seperlunya dan mempercayai sistem untuk menangani pasangan apa pun yang mungkin diperlukan. Beberapa perangkat tidak perlu dipasangkan agar Anda dapat menggunakan fungsinya. Jika perangkat memang perlu dipasangkan, maka API perangkat akan menangani tindakan pemasangan di belakang layar sehingga Anda tidak perlu mengintegrasikan fungsi itu ke dalam aplikasi Anda. Aplikasi Anda tidak akan memiliki pengetahuan tentang apakah perangkat tertentu dipasangkan atau perlu, tetapi Anda masih dapat mengakses perangkat dan menggunakan fungsinya.

Pasangan dasar

Pasangan dasar adalah ketika aplikasi Anda menggunakan Windows. Devices.Enumeration API untuk mencoba memasangkan perangkat. Dalam skenario ini, Anda membiarkan Windows mencoba proses pemasangan dan menanganinya. Jika ada interaksi pengguna yang diperlukan, itu 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 Anda menerima objek itu, 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 aplikasi Anda 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 tahu status pemasangan (IsPaired) dan apakah perangkat dapat dipasangkan (CanPair). Keduanya adalah properti dari 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. Hal ini memungkinkan aplikasi Anda untuk 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 khusus 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 khusus, Anda harus mendapatkan objek DeviceInformation untuk perangkat yang Anda minati, seperti halnya 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 menyertakan parameter DevicePairingKinds . Ini menunjukkan tindakan yang perlu dilakukan pengguna untuk mencoba memasangkan perangkat. Lihat halaman referensi DevicePairingKinds untuk informasi lebih lanjut tentang berbagai jenis dan tindakan apa yang perlu diambil pengguna. Sama seperti dengan pasangan dasar, Anda harus menunggu hasilnya untuk memberikan waktu aplikasi Anda 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 penangan untuk acara PairingRequested . Penangan ini perlu memastikan untuk memperhitungkan semua DevicePairingKinds yang berbeda yang mungkin digunakan dalam skenario pemasangan khusus. Tindakan yang tepat untuk diambil akan tergantung pada DevicePairingKinds yang disediakan sebagai bagian dari argumen acara.

Penting untuk diketahui bahwa pemasangan khusus 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 memiliki pengalaman pengguna yang memerlukan persetujuan pengguna. Karena dialog itu dibuat secara otomatis, Anda tidak perlu membuat dialog anda sendiri ketika anda memilih DevicePairingKinds of ConfirmOnly saat beroperasi pada platform ini. Untuk DevicePairingKinds lainnya, Anda harus melakukan beberapa penanganan khusus tergantung pada nilai DevicePairingKinds tertentu. Lihat contoh 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 pairingRequested event handler untuk menerima pasangan. Lewati 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 seringkali tidak sama dengan kredensial untuk pengguna yang masuk secara lokal.

Tidak berpasangan

Tidak membayar perangkat hanya relevan dalam skenario pemasangan dasar atau kustom yang dijelaskan di atas. Jika Anda menggunakan pemasangan otomatis, aplikasi Anda tetap tidak menyadari status pemasangan perangkat dan tidak perlu melepaskannya. Jika Anda memilih untuk melepaskan cat 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 melepaskan pembayaran perangkat adalah mendapatkan objek DeviceInformation untuk perangkat yang ingin Anda unpair. Maka Anda perlu mengambil properti DeviceInformation.Pairing dan memanggil DeviceInformationPairing.UnpairAsync. Sama seperti dengan berpasangan, Anda akan ingin menunggu hasilnya. Hasil dari tindakan yang tidak berpasangan akan dikembalikan, dan selama tidak ada kesalahan yang dikembalikan, perangkat tidak akan diperbaiki.

Sampel

Untuk mengunduh sampel yang menunjukkan cara menggunakan Windows. Devices.Enumeration API, klik di sini.