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 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.