Menemukan perangkat Bluetooth

Dengan menggunakan BluetoothAdapter, Anda dapat menemukan perangkat Bluetooth jarak jauh, baik melalui penemuan perangkat atau dengan mengkueri daftar perangkat yang disambungkan.

Pastikan Anda memiliki izin Bluetooth yang sesuai dan menyiapkan aplikasi untuk Bluetooth sebelum mencoba menemukan perangkat Bluetooth.

Penemuan perangkat adalah prosedur pemindaian yang menelusuri area lokal untuk mencari perangkat yang mengaktifkan Bluetooth dan meminta beberapa informasi tentang setiap perangkat. Proses ini terkadang disebut sebagai penemuan, penyelidikan, atau pemindaian. Perangkat Bluetooth di sekitar merespons permintaan penemuan hanya jika perangkat tersebut saat ini menerima permintaan informasi dengan dapat ditemukan. Jika perangkat dapat ditemukan, perangkat akan merespons permintaan penemuan dengan membagikan beberapa informasi, seperti nama perangkat, class, dan alamat MAC uniknya. Dengan menggunakan informasi ini, perangkat yang melakukan proses penemuan dapat memilih untuk memulai koneksi ke perangkat yang ditemukan.

Karena perangkat yang dapat ditemukan mungkin mengungkapkan informasi tentang lokasi pengguna, proses penemuan perangkat memerlukan akses lokasi. Jika aplikasi Anda digunakan pada perangkat yang menjalankan Android 8.0 (level API 26) atau yang lebih tinggi, pertimbangkan untuk menggunakan Pengelola Perangkat Pendamping API. API ini melakukan penemuan perangkat atas nama aplikasi Anda, sehingga aplikasi Anda tidak perlu meminta izin akses lokasi.

Saat Anda terhubung ke perangkat jarak jauh untuk pertama kalinya, permintaan penyambungan akan otomatis muncul. Setelah disambungkan, informasi dasar perangkat—seperti nama, class, dan alamat MAC perangkat—akan disimpan dan dapat dibaca melalui Bluetooth API.

Dengan menggunakan alamat MAC yang diketahui dari perangkat yang disambungkan, Anda dapat memulai koneksi kapan saja tanpa melakukan penemuan, dengan asumsi perangkat masih dalam jangkauan.

Perhatikan bahwa ada perbedaan antara penyambungan dan koneksi:

  • Sambungan berarti dua perangkat mengetahui keberadaan satu sama lain, memiliki kunci link bersama yang dapat digunakan untuk autentikasi, dan mampu membuat koneksi terenkripsi satu sama lain.
  • Terhubung berarti perangkat saat ini berbagi saluran RFCOMM dan dapat mengirimkan data satu sama lain. Bluetooth API saat ini mengharuskan perangkat disambungkan sebelum koneksi RFCOMM dapat dibuat. Penyambungan otomatis dilakukan saat Anda memulai koneksi terenkripsi dengan Bluetooth API.

Bagian berikut menjelaskan cara menemukan perangkat yang telah disambungkan dan cara menemukan perangkat baru menggunakan penemuan perangkat.

Membuat kueri perangkat yang disambungkan

Sebelum melakukan penemuan perangkat, sebaiknya buat kueri kumpulan perangkat yang disambungkan untuk melihat apakah perangkat yang Anda inginkan sudah diketahui. Untuk melakukannya, panggil getBondedDevices() Tindakan ini akan menampilkan sekumpulan objek BluetoothDevice yang mewakili perangkat yang disambungkan. Misalnya, Anda dapat mengkueri semua perangkat yang disambungkan dan mendapatkan nama serta alamat MAC setiap perangkat, seperti yang ditunjukkan cuplikan kode berikut:

Kotlin

val pairedDevices: Set<BluetoothDevice>? = bluetoothAdapter?.bondedDevices
pairedDevices?.forEach { device ->
   val deviceName = device.name
   val deviceHardwareAddress = device.address // MAC address
}

Java

Set<BluetoothDevice> pairedDevices = bluetoothAdapter.getBondedDevices();

if (pairedDevices.size() > 0) {
   // There are paired devices. Get the name and address of each paired device.
   for (BluetoothDevice device : pairedDevices) {
       String deviceName = device.getName();
       String deviceHardwareAddress = device.getAddress(); // MAC address
   }
}

Untuk memulai koneksi dengan perangkat Bluetooth, yang diperlukan dari objek BluetoothDevice terkait hanyalah alamat MAC, yang Anda ambil dengan memanggil getAddress(). Anda dapat mempelajari lebih lanjut cara membuat koneksi di Menghubungkan perangkat Bluetooth.

Menemukan perangkat

Untuk mulai menemukan perangkat, panggil startDiscovery(). Proses ini bersifat asinkron dan menampilkan nilai boolean yang menunjukkan apakah penemuan telah berhasil dimulai. Proses penemuan biasanya melibatkan pemindaian kueri selama sekitar 12 detik, diikuti dengan pemindaian halaman setiap perangkat yang ditemukan untuk mengambil nama Bluetooth-nya.

Untuk menerima informasi tentang setiap perangkat yang ditemukan, aplikasi Anda harus mendaftarkan BroadcastReceiver untuk intent ACTION_FOUND. Sistem menyiarkan intent ini untuk setiap perangkat. Intent berisi kolom tambahan EXTRA_DEVICE dan EXTRA_CLASS, yang masing-masing berisi BluetoothDevice dan BluetoothClass. Cuplikan kode berikut menunjukkan cara mendaftar untuk menangani siaran saat perangkat ditemukan:

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
   ...

   // Register for broadcasts when a device is discovered.
   val filter = IntentFilter(BluetoothDevice.ACTION_FOUND)
   registerReceiver(receiver, filter)
}

// Create a BroadcastReceiver for ACTION_FOUND.
private val receiver = object : BroadcastReceiver() {

   override fun onReceive(context: Context, intent: Intent) {
       val action: String = intent.action
       when(action) {
           BluetoothDevice.ACTION_FOUND -> {
               // Discovery has found a device. Get the BluetoothDevice
               // object and its info from the Intent.
               val device: BluetoothDevice =
                       intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE)
               val deviceName = device.name
               val deviceHardwareAddress = device.address // MAC address
           }
       }
   }
}

override fun onDestroy() {
   super.onDestroy()
   ...

   // Don't forget to unregister the ACTION_FOUND receiver.
   unregisterReceiver(receiver)
}

Java

@Override
protected void onCreate(Bundle savedInstanceState) {
   ...

   // Register for broadcasts when a device is discovered.
   IntentFilter filter = new IntentFilter(BluetoothDevice.ACTION_FOUND);
   registerReceiver(receiver, filter);
}

// Create a BroadcastReceiver for ACTION_FOUND.
private final BroadcastReceiver receiver = new BroadcastReceiver() {
   public void onReceive(Context context, Intent intent) {
       String action = intent.getAction();
       if (BluetoothDevice.ACTION_FOUND.equals(action)) {
           // Discovery has found a device. Get the BluetoothDevice
           // object and its info from the Intent.
           BluetoothDevice device = intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE);
           String deviceName = device.getName();
           String deviceHardwareAddress = device.getAddress(); // MAC address
       }
   }
};

@Override
protected void onDestroy() {
   super.onDestroy();
   ...

   // Don't forget to unregister the ACTION_FOUND receiver.
   unregisterReceiver(receiver);
}

Untuk memulai koneksi dengan perangkat Bluetooth, panggil getAddress() pada BluetoothDevice untuk mengambil alamat MAC terkait.

Mengaktifkan visibilitas

Agar perangkat lokal dapat ditemukan oleh perangkat lain, panggil startActivityForResult(Intent, int) dengan intent ACTION_REQUEST_DISCOVERABLE. Tindakan ini akan mengeluarkan permintaan untuk mengaktifkan mode visibilitas sistem tanpa harus membuka aplikasi Setelan, yang akan menghentikan aplikasi Anda sendiri. Secara default, perangkat akan terlihat selama dua menit. Anda dapat menentukan durasi yang berbeda, hingga lima menit, dengan menambahkan tambahan EXTRA_DISCOVERABLE_DURATION.

Cuplikan kode berikut menyetel perangkat agar dapat ditemukan selama lima menit:

Kotlin

val requestCode = 1;
val discoverableIntent: Intent = Intent(BluetoothAdapter.ACTION_REQUEST_DISCOVERABLE).apply {
   putExtra(BluetoothAdapter.EXTRA_DISCOVERABLE_DURATION, 300)
}
startActivityForResult(discoverableIntent, requestCode)

Java

int requestCode = 1;
Intent discoverableIntent =
       new Intent(BluetoothAdapter.ACTION_REQUEST_DISCOVERABLE);
discoverableIntent.putExtra(BluetoothAdapter.EXTRA_DISCOVERABLE_DURATION, 300);
startActivityForResult(discoverableIntent, requestCode);
Dialog sistem yang meminta izin untuk membuat perangkat dapat ditemukan
Gambar 1. Dialog mengaktifkan visibilitas.

Dialog akan ditampilkan, yang meminta izin pengguna untuk membuat perangkat dapat ditemukan, seperti yang ditunjukkan pada gambar 1. Jika pengguna merespons "Izinkan", perangkat akan dapat ditemukan selama jangka waktu yang ditentukan. Aktivitas Anda kemudian menerima panggilan ke callback onActivityResult(), dengan kode hasil yang sama dengan durasi perangkat dapat ditemukan. Jika pengguna merespons "Tolak", atau jika terjadi error, kode hasilnya adalah RESULT_CANCELED.

Perangkat akan tetap berada dalam mode dapat ditemukan secara otomatis selama waktu yang ditentukan. Agar diberi tahu saat mode visibilitas berubah, daftarkan BroadcastReceiver untuk intent ACTION_SCAN_MODE_CHANGED. Intent ini berisi kolom tambahan EXTRA_SCAN_MODE dan EXTRA_PREVIOUS_SCAN_MODE, yang masing-masing menyediakan mode pemindaian baru dan lama. Kemungkinan nilai untuk setiap tambahan adalah sebagai berikut:

SCAN_MODE_CONNECTABLE_DISCOVERABLE
Perangkat dalam mode dapat ditemukan.
SCAN_MODE_CONNECTABLE
Perangkat tidak dalam mode dapat ditemukan, tetapi masih dapat menerima koneksi.
SCAN_MODE_NONE
Perangkat tidak dalam mode dapat ditemukan dan tidak dapat menerima koneksi.

Jika Anda memulai koneksi ke perangkat jarak jauh, Anda tidak perlu mengaktifkan visibilitas perangkat. Mengaktifkan visibilitas hanya diperlukan jika Anda ingin aplikasi menghosting soket server yang menerima koneksi masuk, karena perangkat jarak jauh harus dapat menemukan perangkat lain sebelum memulai koneksi ke perangkat lain tersebut.