Berkomunikasi di latar belakang

Panduan ini memberikan ringkasan tentang cara mendukung kasus penggunaan utama untuk berkomunikasi dengan perangkat periferal saat aplikasi Anda berjalan di latar belakang:

• Menemukan perangkat
• Menghubungkan ke perangkat
• Tetap terhubung ke perangkat

Ada beberapa opsi untuk mendukung setiap kasus penggunaan ini. Masing-masing memiliki kelebihan dan kekurangan yang mungkin membuatnya lebih atau kurang cocok untuk kebutuhan spesifik Anda.

Diagram berikut menunjukkan tampilan sederhana panduan di halaman ini:

Temukan perangkat

Pertama, aplikasi Anda perlu menemukan perangkat yang akan dihubungkan. Untuk menemukan perangkat BLE, Anda dapat menggunakan salah satu API berikut:

• BluetoothLeScanner seperti yang dijelaskan dalam Menemukan perangkat BLE. (Contoh)
• CompanionDeviceManager seperti yang dijelaskan dalam Penyambungan perangkat pendamping. (Contoh)

Di latar belakang

Tidak ada batasan dalam menggunakan salah satu API ini saat aplikasi tidak terlihat, tetapi keduanya memerlukan proses aplikasi Anda untuk tetap aktif. Jika proses aplikasi tidak berjalan, Anda dapat menggunakan solusi berikut:

• Untuk BluetoothLeScanner: Panggil startScan() dengan objek PendingIntent, bukan objek ScanCallback untuk mendapatkan notifikasi saat perangkat yang cocok dengan filter Anda dipindai. (Contoh)
• Untuk CompanionDeviceManager: Ikuti panduan di Membuat aplikasi pendamping tetap aktif untuk mengaktifkan aplikasi dan membuatnya tetap aktif saat perangkat yang sebelumnya terkait berada dalam jangkauan. (Contoh)

Hubungkan ke perangkat

Untuk terhubung ke perangkat setelah menemukannya, Anda perlu mendapatkan instance BluetoothDevice untuk perangkat dari salah satu sumber berikut:

• Hasil pemindaian BluetoothLeScanner seperti yang dijelaskan di bagian sebelumnya.
• Daftar perangkat terikat yang diambil dari BluetoothAdapter.getBondedDevices().
• Cache BluetoothAdapter, menggunakan BluetoothAdapter.getRemoteLeDevice().

Setelah memiliki instance BluetoothDevice, Anda dapat memulai permintaan koneksi ke perangkat yang sesuai dengan memanggil salah satu metode connectGatt(). Nilai yang Anda teruskan ke boolean autoConnect menentukan salah satu dari dua mode koneksi berikut yang digunakan klien GATT:

• Direct connect (autoconnect = false): Mencoba terhubung ke perangkat periferal secara langsung, dan gagal jika perangkat tidak tersedia. Jika terjadi pemutusan koneksi, klien GATT tidak akan otomatis mencoba menghubungkan kembali.
• Hubungkan otomatis (autoconnect = true): Mencoba terhubung secara otomatis ke perangkat periferal setiap kali tersedia. Jika terjadi pemutusan koneksi yang dimulai oleh periferal atau karena periferal berada di luar jangkauan, klien GATT akan otomatis mencoba menghubungkan kembali saat periferal tersedia.

Di latar belakang

Tidak ada batasan untuk terhubung ke perangkat saat aplikasi berada di latar belakang, meskipun koneksi ditutup jika proses Anda dihentikan. Selain itu, ada pembatasan dalam memulai aktivitas (di Android 10 dan yang lebih baru) atau layanan latar depan (di Android 12 dan yang lebih baru) dari latar belakang.

Jadi, untuk melakukan koneksi saat berada di latar belakang, aplikasi dapat menggunakan solusi berikut:

• Gunakan WorkManager untuk terhubung ke perangkat Anda.
  • Anda dapat menetapkan PeriodicWorkRequest atau OneTimeWorkRequest untuk melakukan tindakan yang ditentukan, meskipun pembatasan aplikasi mungkin berlaku.
  • Selain itu, Anda dapat memanfaatkan fitur WorkManager seperti batasan pekerjaan, tugas yang diprioritaskan, kebijakan percobaan ulang, dan lainnya.
  • Jika koneksi harus tetap aktif selama mungkin untuk melakukan tugas, seperti sinkronisasi data atau polling dari perangkat periferal, Anda harus memulai layanan latar depan dengan mengikuti panduan dalam Dukungan untuk worker yang berjalan lama. Namun, pembatasan peluncuran layanan latar depan berlaku mulai Android 12.
• Mulai layanan latar depan dengan jenis connectedDevice.
  • Jika koneksi harus tetap aktif selama mungkin untuk melakukan tugas, seperti sinkronisasi data atau polling dari perangkat periferal, Anda harus memulai layanan latar depan dengan mengikuti panduan dalam Dukungan untuk worker yang berjalan lama. Namun, pembatasan peluncuran layanan latar depan berlaku mulai Android 12.
• Panggil startScan() dengan objek PendingIntent seperti yang dijelaskan dalam Menemukan perangkat untuk mengaktifkan proses saat perangkat ada. Perangkat periferal harus melakukan pemberitahuan.
  • Sebaiknya Anda memulai Worker dan Tugas. Hal ini mungkin terganggu oleh sistem sehingga hanya dapat mendukung komunikasi berdurasi singkat.
  • Di versi yang lebih rendah dari Android 12, Anda dapat memulai layanan latar depan langsung dari objek PendingIntent.
• Gunakan CompanionDeviceService dan salah satu izin REQUEST_COMPANION_RUN_IN_BACKGROUND atau REQUEST_COMPANION_START_FOREGROUND_SERVICES_FROM_BACKGROUND untuk memulai layanan dari latar belakang.

Tetap terhubung ke perangkat

Idealnya, aplikasi harus mempertahankan koneksi ke perangkat periferal hanya selama diperlukan, dan memutuskan koneksi setelah tugas selesai. Namun, ada dua kasus saat aplikasi mungkin perlu menjaga koneksi tetap aktif tanpa batas waktu:

• Saat beralih antar-aplikasi.
• Saat mendengarkan notifikasi periferal.

Dalam kedua kasus tersebut, opsi berikut tersedia:

• Gunakan CompanionDeviceService dengan izin REQUEST_COMPANION_RUN_IN_BACKGROUND dan metode CompanionDeviceManager.startObservingDevicePresence().
• Mulai layanan latar depan saat aplikasi berada di latar depan (atau dalam salah satu pengecualian) dengan jenis latar depan connectedDevice.

Saat beralih antar-aplikasi

Menemukan perangkat, menghubungkannya, dan mentransfer data memerlukan waktu dan resource yang intensif. Agar tidak kehilangan koneksi dan harus melakukan proses penuh setiap kali pengguna beralih antar-aplikasi atau melakukan tugas secara bersamaan, Anda harus menjaga koneksi tetap aktif hingga operasi selesai. Anda dapat menggunakan layanan latar depan dengan jenis connectedDevice atau API kehadiran perangkat pendamping.

Saat memproses notifikasi periferal

Untuk memproses notifikasi periferal, aplikasi harus memanggil setCharacteristicNotification(), memproses callback menggunakan onCharacteristicChanged(), dan menjaga koneksi tetap aktif. Untuk sebagian besar aplikasi, sebaiknya dukung kasus penggunaan ini dengan CompanionDeviceService karena aplikasi kemungkinan perlu terus memproses dalam jangka waktu yang lama. Namun, Anda juga dapat menggunakan layanan latar depan.

Dalam kedua kasus tersebut, Anda dapat terhubung kembali setelah proses dihentikan dengan mengikuti petunjuk di bagian Menghubungkan ke perangkat.