Profil Perangkat Pendamping

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Profil perangkat pendamping, yang diperkenalkan di Android 12, adalah fitur yang memungkinkan aplikasi pendamping meminta serangkaian izin khusus untuk jenis perangkat pendamping, misalnya, jam tangan pintar. Menggunakan profil perangkat pendamping menyederhanakan proses pendaftaran dengan mengizinkan aplikasi untuk menampilkan satu permintaan kepada pengguna di perangkat seluler mereka untuk meminta serangkaian izin yang ditentukan, bukan beberapa permintaan yang meminta izin satu per satu. Ini dapat memungkinkan pengalaman penyiapan yang lebih efisien dan tingkat keikutsertaan yang lebih baik untuk aplikasi pendamping.

Penggunaan profil perangkat pendamping hanya tersedia untuk produsen perangkat yang memiliki perangkat pendamping. Agar perangkat pendamping mendapatkan akses ke fitur tersebut, perangkat tersebut harus memenuhi persyaratan dan disetujui.

Jenis profil perangkat pendamping berikut tersedia di Android 12: COMPANION_DEVICE_WATCH .

Untuk informasi selengkapnya tentang perangkat pendamping, lihat Penyandingan perangkat pendamping .

Perilaku perangkat

Bagian ini menjelaskan perilaku perangkat saat profil perangkat pendamping digunakan.

Saat pengguna menerima permintaan aplikasi untuk membuat asosiasi dengan perangkat pendamping, layanan CompanionDeviceManager (CDM) menunggu perangkat pendamping terhubung, dan saat terhubung, CDM menetapkan peran profil perangkat (misalnya, jam tangan) ke aplikasi pendamping, memberikan semua izin yang ditentukan untuk peran profil yang ditentukan itu. Gambar 1 menunjukkan contoh aplikasi yang meminta izin untuk profil perangkat COMPANION_DEVICE_WATCH .

Gambar 1. Dialog yang meminta izin untuk profil perangkat jam tangan.

Saat asosiasi antara aplikasi dan perangkat pendamping dihapus, misalnya saat data untuk paket dihapus atau saat perangkat dilupakan, CDM mencabut peran profil perangkat untuk aplikasi, yang menghapus semua izin yang ditentukan untuk peran profil dari aplikasi.

Setelah pengguna menerima permintaan aplikasi untuk memberikan izin untuk profil perangkat tertentu, pengguna dapat mencabut izin individual yang diberikan. Saat izin dicabut oleh pengguna, aplikasi tetap terkait dengan perangkat pendamping tetapi fitur tertentu mungkin tidak tersedia. Jika izin diperlukan agar aplikasi berfungsi, aplikasi harus meminta izin melalui permintaan izin biasa .

Persyaratan

Agar aplikasi pendamping mendapatkan akses ke API profil perangkat pendamping, aplikasi harus memenuhi persyaratan berikut:

• Memiliki perangkat pendamping (misalnya, jam tangan pintar).
• Memiliki alasan yang sah untuk meminta izin yang ditentukan untuk profil perangkat pendamping.

Tonton persyaratan profil perangkat pendamping

Tabel berikut menjelaskan izin yang ditentukan untuk peran profil perangkat COMPANION_DEVICE_WATCH dan persyaratan untuk menggunakannya.

Mendapatkan akses

Agar aplikasi mendapatkan akses ke profil perangkat pendamping, aplikasi tersebut harus disetujui dan ditambahkan ke daftar yang diizinkan. Saat permintaan untuk ditambahkan ke daftar yang diizinkan diterima, tim Android meninjau aplikasi untuk memastikan aplikasi memenuhi persyaratan untuk profil perangkat pendamping yang sesuai.

Mitra RUPS:

Mitra dapat mengajukan permintaan agar aplikasi pendamping ditambahkan ke daftar yang diizinkan dengan menghubungi pengelola akun Google mereka.

Penerapan

Untuk produsen perangkat yang mengimplementasikan aplikasi pendamping dengan perangkat tertentu, gunakan konfigurasi sistem Android yang diperlukan berikut ini untuk mengesahkan aplikasi pendamping, yang memungkinkan aplikasi melewati tampilan perintah CDM untuk pengguna.

1. Ambil sertifikat menggunakan perintah berikut:

   keytool  -printcert -jarfile PATH/TO/APK
   

2. Ganti nama paket dan sertifikat seperti yang ditunjukkan pada contoh input berikut di file konfigurasi:

   <!-- A list of packages managing companion device(s) by the same manufacturers as the main device.
   It will not create the association without prompting if the association has been called multiple
   times in a short period. Note that config_companionDeviceManagerPackage and config_companionDeviceCerts
   are parallel arrays. -->
   
       <string-array name="config_companionDevicePackages" translatable="false">
           <item>YOUR_COMAPNION_APP_PACKAGE_NAME</item>
       </string-array>
   
       <!-- A list of SHA256 Certificates managing companion device(s) by the same manufacturers as the
       main device. It will fall back to showing a prompt if the association has been called multiple
       times in a short period. Note that config_companionDeviceCerts and config_companionDeviceManagerPackage
       are parallel arrays.
       Example: "1A:2B:3C:4D" -->
   
       <string-array name="config_companionDeviceCerts" translatable="false">
           <item>YOUR_COMPANION_APP_CERTIFICATE</item>
       </string-array>
   

3. Gunakan AssociationRequest untuk membuat permintaan pengaitan ke satu perangkat pendamping.

Untuk pengembang pihak ketiga yang menerapkan aplikasi pendamping yang meminta profil DEVICE_PROFILE_WATCH , lakukan hal berikut:

1. Panggil metode setDeviceProfile .
2. Teruskan profil DEVICE_PROFILE_WATCH saat membangun AssociationRequest .

Validasi

Untuk menguji perilaku fitur profil perangkat pendamping, gunakan tes CTS berikut:

• CompanionDeviceManagerTest.kt
• CompanionDeviceTestActivity.java