Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

Halaman ini diterjemahkan oleh Cloud Translation API.

Profil Perangkat Pendamping

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.

Izin	Aplikasi pendamping dan persyaratan perangkat
Notifikasi `BIND_NOTIFICATION_LISTENER_SERVICE`	Jadilah perangkat yang terhubung menggunakan Bluetooth dan/atau Wi-Fi Memiliki layar yang mampu menampilkan notifikasi (perangkat yang menggunakan haptics alih-alih layar tidak termasuk) Memberikan pengalaman notifikasi yang menghadap pengguna, misalnya, menampilkan notifikasi telepon di layar perangkat pendamping
Telepon `phone`	Jadilah perangkat yang terhubung menggunakan Bluetooth dan/atau Wi-Fi Memiliki mikrofon dan speaker internal yang memungkinkan percakapan suara Memiliki layar yang menampilkan info penelepon Memberikan pengalaman panggilan telepon yang menghadap pengguna (aplikasi pendamping menjembatani panggilan telepon)
SMS `sms`	Jadilah perangkat yang terhubung menggunakan Bluetooth dan/atau Wi-Fi Memiliki layar yang menampilkan pesan SMS Berikan pengalaman SMS yang menghadap pengguna
Kontak `contacts`	Jadilah perangkat yang terhubung menggunakan Bluetooth dan/atau Wi-Fi Memiliki layar tampilan Menggunakan informasi kontak sebagai bagian dari pengalaman menelepon atau mengirim pesan
Kalender `calendar`	Jadilah perangkat yang terhubung menggunakan Bluetooth dan/atau Wi-Fi Memiliki layar tampilan Berikan pengalaman kalender yang menghadap pengguna di jam tangan
Perangkat terdekat `nearby_devices`	Jadilah perangkat yang terhubung menggunakan Bluetooth dan/atau Wi-Fi Memiliki layar tampilan Berikan pengalaman memasangkan/menghubungkan yang menghadap pengguna di jam tangan
penyediaan eSIM `USE_ICC_AUTH_WITH_DEVICE_IDENTIFIER`	Jadilah perangkat yang terhubung menggunakan Bluetooth dan/atau Wi-Fi Memiliki layar tampilan Berikan pengalaman yang menghadap pengguna yang mengelola layanan pelanggan dari operator di jam tangan
Mengelola panggilan yang sedang berlangsung `MANAGE_ONGOING_CALLS`	Jadilah perangkat yang terhubung menggunakan Bluetooth dan/atau Wi-Fi Memiliki mikrofon dan speaker internal yang memungkinkan percakapan suara Memiliki layar yang menampilkan info penelepon Memberikan pengalaman panggilan telepon yang menghadap pengguna (aplikasi pendamping menjembatani panggilan telepon)

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.

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.

Ambil sertifikat menggunakan perintah berikut:
```
keytool  -printcert -jarfile PATH/TO/APK
```

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>

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:

Panggil metode setDeviceProfile .
Teruskan profil DEVICE_PROFILE_WATCH saat membangun AssociationRequest .

Validasi

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