BLE cihazıyla etkileşim kurmanın ilk adımı, cihaza bağlanmaktır. Daha spesifik olarak, cihazdaki GATT sunucusuna bağlanma. BLE cihazındaki bir GATT sunucusuna bağlanmak için connectGatt() yöntemini kullanın. Bu yöntem üç parametre alır: Context nesnesi, autoConnect (BLE cihazına kullanılabilir hale gelir gelmez otomatik olarak bağlanılıp bağlanılmayacağını belirten bir boole değeri) ve BluetoothGattCallback referansı:
var bluetoothGatt: BluetoothGatt? = null // ... bluetoothGatt = device.connectGatt(this, false, bluetoothGattCallback)
Bu, BLE cihazı tarafından barındırılan GATT sunucusuna bağlanır ve GATT istemci işlemlerini gerçekleştirmek için kullanabileceğiniz bir BluetoothGatt örneği döndürür. Arayan (Android uygulaması) GATT istemcisidir. BluetoothGattCallback,
bağlantı durumu gibi sonuçları istemciye iletmek ve diğer GATT istemci işlemlerini gerçekleştirmek için kullanılır.
Bağlama hizmeti oluşturma
Aşağıdaki örnekte BLE uygulaması, Bluetooth cihazlara bağlanmak, cihaz verilerini görüntülemek ve cihaz tarafından desteklenen GATT hizmetlerini ve özelliklerini görüntülemek için bir etkinlik (DeviceControlActivity) sağlar. Bu etkinlik, kullanıcı girişine göre BluetoothLeService adlı bir Service ile iletişim kurar. Bu hizmet, BLE API'yi kullanarak BLE cihazıyla etkileşimde bulunur. Bu iletişim, etkinliğin BluetoothLeService hizmetine bağlanmasına ve cihazlara bağlanmak için işlevleri çağırmasına olanak tanıyan bir bağlama hizmeti tarafından gerçekleştirilir. BluetoothLeService, etkinlik için hizmete erişim sağlayan bir Binder uygulaması gerektirir.
class BluetoothLeService : Service() { private val binder = LocalBinder() override fun onBind(intent: Intent): IBinder? { return binder } inner class LocalBinder : Binder() { fun getService(): BluetoothLeService { return this@BluetoothLeService } } }
Etkinlik, hizmeti başlatmak için bindService() kullanarak hizmeti başlatabilir. Bunun için bir Intent, bağlantı ve bağlantı kesme etkinliklerini dinlemek için bir ServiceConnection uygulaması ve ek bağlantı seçeneklerini belirtmek için bir işaret iletir.
class DeviceControlActivity : AppCompatActivity() { private var bluetoothService: BluetoothLeService? = null // Code to manage Service lifecycle. private val serviceConnection: ServiceConnection = object : ServiceConnection { override fun onServiceConnected( componentName: ComponentName, service: IBinder ) { bluetoothService = (service as LocalBinder).getService() bluetoothService?.let { bluetooth -> // call functions on service to check connection and connect to devices } } override fun onServiceDisconnected(componentName: ComponentName) { bluetoothService = null } } override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.gatt_services_characteristics) val gattServiceIntent = Intent(this, BluetoothLeService::class.java) bindService(gattServiceIntent, serviceConnection, Context.BIND_AUTO_CREATE) } }
BluetoothAdapter'ı ayarlama
Etkinlik hizmete bağlandıktan sonra hizmetin BluetoothAdapter'e erişmesi gerekir. Adaptörün cihazda mevcut olup olmadığını kontrol etmelidir. BluetoothAdapter hakkında daha fazla bilgi için Bluetooth'u ayarlama başlıklı makaleyi inceleyin. Aşağıdaki örnekte, bu kurulum kodu, başarıyı gösteren bir Boolean değeri döndüren bir initialize() işlevine sarmalanmıştır.
private const val TAG = "BluetoothLeService" class BluetoothLeService : Service() { private var bluetoothAdapter: BluetoothAdapter? = null fun initialize(): Boolean { bluetoothAdapter = BluetoothAdapter.getDefaultAdapter() if (bluetoothAdapter == null) { Log.e(TAG, "Unable to obtain a BluetoothAdapter.") return false } return true } // ... }
Etkinlik, bu işlevi ServiceConnection uygulamasında çağırır.
initialize() işlevinden gelen yanlış dönüş değerinin işlenmesi uygulamanıza bağlıdır. Kullanıcıya mevcut cihazın Bluetooth işlemini desteklemediğini belirten bir hata mesajı gösterebilir veya çalışması için Bluetooth gereken özellikleri devre dışı bırakabilirsiniz. Aşağıdaki örnekte etkinlik, kullanıcıyı önceki ekrana geri göndermek için finish() yöntemini çağırır.
class DeviceControlActivity : AppCompatActivity() { // Code to manage Service lifecycle. private val serviceConnection: ServiceConnection = object : ServiceConnection { override fun onServiceConnected( componentName: ComponentName, service: IBinder ) { bluetoothService = (service as LocalBinder).getService() bluetoothService?.let { bluetooth -> if (!bluetooth.initialize()) { Log.e(TAG, "Unable to initialize Bluetooth") finish() } // perform device connection } } override fun onServiceDisconnected(componentName: ComponentName) { bluetoothService = null } } // ... }
Bir cihaza bağlan
BluetoothLeService örneği başlatıldıktan sonra BLE cihazına bağlanabilir. Etkinliğin, bağlantıyı başlatabilmesi için cihaz adresini hizmete göndermesi gerekir. Hizmet, cihaza erişmek için önce BluetoothAdapter üzerinde getRemoteDevice() yöntemini çağırır. Adaptör bu adrese sahip bir cihaz bulamazsa getRemoteDevice(), IllegalArgumentException hatası verir.
fun connect(address: String): Boolean { bluetoothAdapter?.let { adapter -> try { val device = adapter.getRemoteDevice(address) } catch (exception: IllegalArgumentException) { Log.w(TAG, "Device not found with provided address.") return false } // connect to the GATT server on the device return true } ?: run { Log.w(TAG, "BluetoothAdapter not initialized") return false } }
DeviceControlActivity, hizmet başlatıldıktan sonra bu connect() işlevini çağırır. Etkinliğin, BLE cihazının adresini iletmesi gerekir. Aşağıdaki örnekte, cihaz adresi etkinliğe intent ekstrası olarak iletilir.
// Code to manage Service lifecycle. private val serviceConnection: ServiceConnection = object : ServiceConnection { override fun onServiceConnected( componentName: ComponentName, service: IBinder ) { bluetoothService = (service as LocalBinder).getService() bluetoothService?.let { bluetooth -> if (!bluetooth.initialize()) { Log.e(TAG, "Unable to initialize Bluetooth") finish() } // perform device connection deviceAddress?.let { bluetooth.connect(it) } } } override fun onServiceDisconnected(componentName: ComponentName) { bluetoothService = null } }
GATT geri çağırmasını bildirme
Etkinlik, hizmete hangi cihaza bağlanacağını söyledikten ve hizmet cihaza bağlandıktan sonra hizmetin BLE cihazındaki GATT sunucusuna bağlanması gerekir. Bu bağlantı; bağlantı durumu, hizmet keşfi, özellik okumaları ve özellik bildirimleri hakkında bildirim almak için bir BluetoothGattCallback gerektirir.
Bu dokümanda, bağlantı durumu bildirimleri ele alınmaktadır. Hizmetleri keşfetme, özellikleri okuma ve özellik bildirimleri isteme hakkında bilgi edinmek için BLE verilerini aktarma başlıklı makaleyi inceleyin.
onConnectionStateChange() işlevi, cihazın GATT sunucusuyla bağlantı değiştiğinde tetiklenir. Aşağıdaki örnekte geri çağırma, Service sınıfında tanımlanmıştır. Bu sayede, hizmet bağlandıktan sonra BluetoothDevice ile kullanılabilir.
private val bluetoothGattCallback = object : BluetoothGattCallback() { override fun onConnectionStateChange(gatt: BluetoothGatt?, status: Int, newState: Int) { if (newState == BluetoothProfile.STATE_CONNECTED) { // successfully connected to the GATT Server } else if (newState == BluetoothProfile.STATE_DISCONNECTED) { // disconnected from the GATT Server } } }
GATT hizmetine bağlanma
BluetoothGattCallback tanımlandıktan sonra hizmet, cihazdaki GATT hizmetine bağlanmak için connect() işlevindeki BluetoothDevice nesnesini kullanabilir.
Hizmet, connectGatt() işlevini çağırır. Bunun için bir Context nesnesi, bir autoConnect boole işareti ve BluetoothGattCallback gerekir. Bu örnekte uygulama doğrudan BLE cihazına bağlandığı için autoConnect parametresine false değeri iletilir.
Hizmet, artık ihtiyaç duyulmadığında bağlantıyı kapatabilmek için bir BluetoothGatt özelliği de ekler.
class BluetoothLeService : Service() { // ... private var bluetoothGatt: BluetoothGatt? = null // ... fun connect(address: String): Boolean { bluetoothAdapter?.let { adapter -> try { val device = adapter.getRemoteDevice(address) // connect to the GATT server on the device bluetoothGatt = device.connectGatt(this, false, bluetoothGattCallback) return true } catch (exception: IllegalArgumentException) { Log.w(TAG, "Device not found with provided address. Unable to connect.") return false } } ?: run { Log.w(TAG, "BluetoothAdapter not initialized") return false } } }
Yayın güncellemeleri
Hizmet, GATT sunucusuna bağlandığında veya sunucuyla bağlantısını kestiğinde etkinliği yeni durum hakkında bilgilendirmesi gerekir. Bunu yapmanın birkaç yolu vardır. Aşağıdaki örnekte, hizmetten etkinliğe bilgi göndermek için yayınlar kullanılmaktadır.
Hizmet, yeni durumu yayınlamak için bir işlev bildirir. Bu işlev, sisteme yayınlanmadan önce bir Intent nesnesine iletilen işlem dizesini alır.
private fun broadcastUpdate(action: String) { val intent = Intent(action) sendBroadcast(intent) }
Yayın işlevi uygulandıktan sonra hizmet, GATT sunucusuyla bağlantı durumu hakkında bilgi göndermek için bu işlevi BluetoothGattCallback içinde kullanır. Hizmet, Intent işlemlerini ve hizmetin mevcut bağlantı durumunu temsil eden sabitleri bildirir.
class BluetoothLeService : Service() { private var connectionState = STATE_DISCONNECTED private val bluetoothGattCallback = object : BluetoothGattCallback() { override fun onConnectionStateChange(gatt: BluetoothGatt?, status: Int, newState: Int) { if (newState == BluetoothProfile.STATE_CONNECTED) { // successfully connected to the GATT Server connectionState = STATE_CONNECTED broadcastUpdate(ACTION_GATT_CONNECTED) } else if (newState == BluetoothProfile.STATE_DISCONNECTED) { // disconnected from the GATT Server connectionState = STATE_DISCONNECTED broadcastUpdate(ACTION_GATT_DISCONNECTED) } } } // ... companion object { const val ACTION_GATT_CONNECTED = "com.example.bluetooth.le.ACTION_GATT_CONNECTED" const val ACTION_GATT_DISCONNECTED = "com.example.bluetooth.le.ACTION_GATT_DISCONNECTED" private const val STATE_DISCONNECTED = 0 private const val STATE_CONNECTED = 2 } }
Etkinlik güncellemelerini dinleme
Hizmet, bağlantı güncellemelerini yayınladıktan sonra etkinliğin bir BroadcastReceiver uygulaması gerekir. Etkinliği ayarlarken bu alıcıyı kaydedin ve etkinlik ekrandan ayrılırken kaydını iptal edin. Etkinlik, hizmetten gelen etkinlikleri dinleyerek kullanıcı arayüzünü BLE cihazıyla mevcut bağlantı durumuna göre güncelleyebilir.
class DeviceControlActivity : AppCompatActivity() { private val gattUpdateReceiver: BroadcastReceiver = object : BroadcastReceiver() { override fun onReceive(context: Context, intent: Intent) { when (intent.action) { BluetoothLeService.ACTION_GATT_CONNECTED -> { connected = true updateConnectionState(R.string.connected) } BluetoothLeService.ACTION_GATT_DISCONNECTED -> { connected = false updateConnectionState(R.string.disconnected) } } } } override fun onResume() { super.onResume() registerReceiver(gattUpdateReceiver, makeGattUpdateIntentFilter()) bluetoothService?.let { service -> deviceAddress?.let { address -> val result = service.connect(address) Log.d(TAG, "Connect request result=$result") } } } override fun onPause() { super.onPause() unregisterReceiver(gattUpdateReceiver) } private fun makeGattUpdateIntentFilter(): IntentFilter { return IntentFilter().apply { addAction(BluetoothLeService.ACTION_GATT_CONNECTED) addAction(BluetoothLeService.ACTION_GATT_DISCONNECTED) } } }
BLE verilerini aktarma bölümünde BroadcastReceiver, cihazdan karakteristik verilerin yanı sıra hizmet keşfini iletmek için de kullanılır.
GATT bağlantısını kapatma
Bluetooth bağlantılarıyla çalışırken önemli bir adım, işiniz bittiğinde bağlantıyı kapatmaktır. Bunun için BluetoothGatt nesnesinde close() işlevini çağırın. Aşağıdaki örnekte hizmet, BluetoothGatt referansını barındırıyor. Etkinlik, hizmetle olan bağını kopardığında cihazın pilinin bitmesini önlemek için bağlantı kapatılır.
class BluetoothLeService : Service() { // ... override fun onUnbind(intent: Intent?): Boolean { close() return super.onUnbind(intent) } private fun close() { bluetoothGatt?.let { gatt -> gatt.close() bluetoothGatt = null } } }