Berkomunikasi di latar belakang

Panduan ini memberikan ringkasan 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 tersebut. Masing-masing memiliki kelebihan dan kekurangan yang mungkin membuatnya lebih atau kurang sesuai dengan kebutuhan spesifik Anda.

Diagram berikut menunjukkan tampilan panduan yang disederhanakan di halaman ini:

Catatan: Panduan umum untuk pekerjaan latar belakang di Android juga berlaku untuk pekerjaan terkait Bluetooth.

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)

Catatan: CompanionDeviceManager memiliki batasan tertentu (seperti pemfilteran terbatas dan tidak ada dukungan untuk alamat MAC acak) yang mungkin tidak memenuhi kebutuhan Anda, bergantung pada implementasi perangkat periferal.

Di latar belakang

Tidak ada batasan dalam menggunakan salah satu API ini saat aplikasi tidak terlihat, tetapi keduanya membutuhkan proses aplikasi Anda agar 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 Tetap aktifkan aplikasi pendamping untuk mengaktifkan aplikasi dan membuatnya tetap aktif saat perangkat yang sebelumnya terkait berada dalam jangkauan. (Contoh)

Catatan: Menjadwalkan pemindaian berkala untuk menemukan perangkat tidak disarankan. Pendekatan tersebut kurang efisien karena memulai proses aplikasi secara berkala, terlepas dari apakah perangkat berada dalam jangkauan. Metode yang dijelaskan dalam panduan ini memastikan bahwa perangkat berada dalam jangkauan sebelum mengaktifkan proses aplikasi.

Hubungkan ke perangkat

Untuk terhubung ke perangkat setelah menemukannya, Anda perlu mendapatkan instance BluetoothDevice untuk perangkat tersebut 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 terkait dengan memanggil salah satu metode connectGatt(). Nilai yang Anda teruskan ke boolean autoConnect menentukan manakah dari dua mode koneksi berikut yang digunakan klien GATT:

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

Catatan: Versi Android di bawah 10 hanya mengizinkan satu permintaan koneksi pada satu waktu dan mengantrekan semua permintaan berikutnya. Di Android 10 dan yang lebih tinggi, sistem mengelompokkan permintaan koneksi untuk eksekusi batch.

Di latar belakang

Tidak ada batasan untuk menghubungkan ke perangkat saat aplikasi berada di latar belakang, meskipun koneksi akan ditutup jika proses Anda dihentikan. Selain itu, ada batasan pada aktivitas awal (di Android 10 dan yang lebih tinggi) atau layanan latar depan (di Android 12 dan yang lebih tinggi) dari latar belakang.

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

• Gunakan WorkManager untuk terhubung ke perangkat Anda.
  • Anda dapat menyetel PeriodicWorkRequest atau OneTimeWorkRequest untuk melakukan tindakan yang ditentukan, meskipun pembatasan aplikasi mungkin berlaku.
  • Selain itu, Anda dapat memanfaatkan fitur WorkManager seperti batasan pekerjaan, pekerjaan yang diprioritaskan, kebijakan coba ulang, dan lainnya.
  • Jika koneksi harus tetap aktif selama mungkin untuk melakukan tugas, seperti menyinkronkan data atau polling dari perangkat periferal, Anda harus memulai layanan latar depan dengan mengikuti panduan di Dukungan untuk pekerja jangka 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 menyinkronkan data atau polling dari perangkat periferal, Anda harus memulai layanan latar depan dengan mengikuti panduan di Dukungan untuk pekerja jangka 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 Anda saat perangkat ada. Perangkat periferal harus berupa iklan.
  • Kami menyarankan agar Anda memulai Pekerja dan Pekerjaan. Proses ini mungkin terganggu oleh sistem sehingga hanya dapat mendukung komunikasi berdurasi singkat.
  • Pada 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 ketika aplikasi mungkin perlu menjaga koneksi tetap aktif tanpa batas waktu:

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

Untuk kedua kasus tersebut, opsi berikut tersedia:

• Gunakan CompanionDeviceService dengan izin REQUEST_COMPANION_RUN_IN_BACKGROUND dan metode CompanionDeviceManager.startObservingDevicePresence().
• Memulai 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 menghabiskan waktu dan memerlukan banyak resource. Untuk menghindari kehilangan koneksi dan melakukan proses penuh setiap kali pengguna beralih di antara aplikasi atau melakukan tugas bersamaan, Anda harus menjaga koneksi tetap aktif hingga operasi selesai. Anda dapat menggunakan layanan latar depan dengan jenis connectedDevice atau API kehadiran perangkat pendamping.

Selagi mendengarkan 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 mungkin akan terus memproses untuk jangka waktu yang lama. Namun, Anda juga dapat menggunakan layanan latar depan.

Dalam kasus ini, Anda dapat menghubungkan kembali setelah proses dihentikan dengan mengikuti petunjuk di bagian Menghubungkan ke perangkat.