Bevor deine App über Bluetooth oder Bluetooth Low Energy kommunizieren kann, musst du prüfen, ob Bluetooth auf dem Gerät unterstützt wird. Wenn ja, muss es aktiviert sein. Diese Prüfung ist nur erforderlich, wenn das Attribut android:required im Eintrag der Manifestdatei <uses-feature.../> auf false festgelegt ist.
Wenn Bluetooth nicht unterstützt wird, sollten Sie alle Bluetooth-Funktionen deaktivieren. Wenn Bluetooth unterstützt, aber deaktiviert ist, kannst du den Nutzer bitten, Bluetooth zu aktivieren, ohne deine App zu verlassen.
Im ersten Schritt musst du die Bluetooth-Berechtigungen zu deiner Manifestdatei hinzufügen, um die folgenden APIs verwenden zu können.
Sobald die Berechtigungen erteilt sind, wird die Bluetooth-Einrichtung in zwei Schritten mit dem BluetoothAdapter durchgeführt:
Rufen Sie die
BluetoothAdapterab.Die Berechtigung
BluetoothAdapterist für alle Bluetooth-Aktivitäten erforderlich.BluetoothAdaptersteht für den Bluetooth-Adapter des Geräts (das Bluetooth-Funkmodul). Damit Sie einBluetoothAdaptererhalten, benötigen Sie zuerst einContext. Verwenden Sie diesen Kontext, um eine Instanz des SystemdienstesBluetoothManagerabzurufen. Wenn SieBluetoothManager#getAdapteraufrufen, erhalten Sie einBluetoothAdapter-Objekt. WenngetAdapter()„null“ zurückgibt, unterstützt das Gerät kein Bluetooth.Beispiel:
Kotlin
val bluetoothManager: BluetoothManager = getSystemService(BluetoothManager::class.java) val bluetoothAdapter: BluetoothAdapter? = bluetoothManager.getAdapter() if (bluetoothAdapter == null) { // Device doesn't support Bluetooth }Java
BluetoothManager bluetoothManager = getSystemService(BluetoothManager.class); BluetoothAdapter bluetoothAdapter = bluetoothManager.getAdapter(); if (bluetoothAdapter == null) { // Device doesn't support Bluetooth }Aktiviere Bluetooth.
Als Nächstes musst du prüfen, ob Bluetooth aktiviert ist. Rufe
isEnabled()auf, um zu prüfen, ob Bluetooth derzeit aktiviert ist. Wenn diese Methode „false“ zurückgibt, ist Bluetooth deaktiviert. Wenn du die Aktivierung von Bluetooth anfordern möchtest, rufestartActivityForResult()auf und übergib eineACTION_REQUEST_ENABLE-Intent-Aktion. Dieser Aufruf sendet eine Anfrage, um Bluetooth über die Systemeinstellungen zu aktivieren (ohne die App zu beenden).Beispiel:
Kotlin
if (bluetoothAdapter?.isEnabled == false) { val enableBtIntent = Intent(BluetoothAdapter.ACTION_REQUEST_ENABLE) startActivityForResult(enableBtIntent, REQUEST_ENABLE_BT) }Java
if (!bluetoothAdapter.isEnabled()) { Intent enableBtIntent = new Intent(BluetoothAdapter.ACTION_REQUEST_ENABLE); startActivityForResult(enableBtIntent, REQUEST_ENABLE_BT); }
Es wird ein Dialogfeld angezeigt, in dem die Nutzerberechtigung zum Aktivieren von Bluetooth angefordert wird (siehe Abbildung 1). Wenn der Nutzer die Berechtigung erteilt, beginnt das System mit der Aktivierung von Bluetooth. Der Fokus kehrt zu Ihrer App zurück, sobald der Vorgang abgeschlossen ist oder fehlschlägt.
Die an startActivityForResult() übergebene Konstante REQUEST_ENABLE_BT ist eine lokal definierte Ganzzahl, die größer oder gleich 0 sein muss. Das System gibt diese Konstante in Ihrer onActivityResult()-Implementierung als Parameter requestCode an Sie zurück.
Wenn Bluetooth erfolgreich aktiviert wurde, erhält Ihre Aktivität den Ergebniscode RESULT_OK im Callback onActivityResult(). Wenn Bluetooth aufgrund eines Fehlers nicht aktiviert wurde oder der Nutzer „Ablehnen“ ausgewählt hat, lautet der Ergebniscode RESULT_CANCELED.
Optional kann Ihre App auch auf den Broadcast-Intent ACTION_STATE_CHANGED warten, den das System sendet, wenn sich der Bluetooth-Status ändert. Dieser Broadcast enthält die zusätzlichen Felder EXTRA_STATE und EXTRA_PREVIOUS_STATE, die den neuen bzw. alten Bluetooth-Status enthalten. Mögliche Werte für diese zusätzlichen Felder sind STATE_TURNING_ON, STATE_ON, STATE_TURNING_OFF und STATE_OFF. Das Abhören dieser Übertragung kann nützlich sein, wenn Ihre App Laufzeitänderungen am Bluetooth-Status erkennen muss.
Sobald Bluetooth auf dem Gerät aktiviert ist, kannst du sowohl Bluetooth Classic als auch Bluetooth Low Energy verwenden.
Für Bluetooth Classic können Sie Bluetooth-Geräte finden und eine Verbindung zu Bluetooth-Geräten herstellen.
Für Bluetooth Low Energy kannst du BLE-Geräte finden, eine Verbindung zu einem GATT-Server herstellen und BLE-Daten übertragen.