Anleitung
Bluetooth Low Energy in Capacitor nutzen
Verwendung von @capgo/capacitor-bluetooth-low-energy
Capacitor Bluetooth Low Energy Plugin für BLE-Kommunikation.
Installieren
bun add @capgo/capacitor-bluetooth-low-energy
bunx cap sync
bunx cap sync kopiert den nativen code des Plugins in deine nativen Projekte. Nach jedem Plugin-Upgrade erneut ausführen.
Importieren
import { BluetoothLowEnergy } from '@capgo/capacitor-bluetooth-low-energy';
API auf einen Blick
| Methode | Beschreibung |
|---|---|
initialize |
Initialisiert das BLE-Plugin. Muss vor allen anderen Methoden aufgerufen werden. |
shimWebBluetooth |
Installiere den Capacitor Web Bluetooth Shim auf navigator.bluetooth. Rufe dies manuell auf, bevor du das Web Bluetooth API in einer Capacitor nativen App nutzt. |
isAvailable |
Prüft, ob Bluetooth auf dem Gerät verfügbar ist. |
isEnabled |
Prüft, ob Bluetooth auf dem Gerät aktiviert ist. |
isLocationEnabled |
Prüft, ob die Standortdienste aktiviert sind (nur Android). |
openAppSettings |
Öffnet die App-Einstellungen. |
openBluetoothSettings |
Bluetooth-Einstellungen öffnen (nur Android). |
openLocationSettings |
Standort-Einstellungen öffnen (nur Android). |
checkPermissions |
Aktuellen Berechtigungsstatus prüfen. |
requestPermissions |
Bluetooth-Berechtigungen anfordern. |
startScan |
Scan nach BLE-Geräten starten. |
stopScan |
Scan nach BLE-Geräten stoppen. |
connect |
Mit einem BLE-Gerät verbinden. |
disconnect |
Verbindung zu BLE-Gerät trennen. |
createBond |
Bonding mit BLE-Gerät erstellen (nur Android). |
isBonded |
Prüfen, ob Gerät gekoppelt ist (nur Android). |
discoverServices |
Services auf verbundenem Gerät suchen. |
getServices |
Gefundene Services eines Geräts abrufen. |
getConnectedDevices |
Liste der verbundenen Geräte abrufen. |
readCharacteristic |
Einen Characteristic-Wert lesen. |
writeCharacteristic |
Einen Wert in eine Characteristic schreiben. |
startCharacteristicNotifications |
Notifications für eine Characteristic starten. |
stopCharacteristicNotifications |
Notifications für eine Characteristic stoppen. |
readDescriptor |
Einen Descriptor-Wert lesen. |
writeDescriptor |
Einen Wert in einen Descriptor schreiben. |
readRssi |
RSSI (Signalstärke) eines verbundenen Geräts lesen. |
requestMtu |
MTU-Größenänderung anfordern (nur Android). |
requestConnectionPriority |
Connection Priority anfordern (nur Android). |
startAdvertising |
Advertising als Peripheral (BLE-Server) starten. |
stopAdvertising |
Advertising stoppen. |
addGattService |
Fügt dem lokalen GATT-Server einen GATT-Service mit Characteristics hinzu. Muss im Peripheral-Modus vor dem Start des Advertisings aufgerufen werden. |
removeGattService |
Entfernt einen GATT-Service vom lokalen GATT-Server. |
setGattCharacteristicValue |
Setzt den Wert einer lokalen GATT-Characteristic. |
notifyGattCharacteristicChanged |
Benachrichtigt verbundene Centrals, wenn sich ein lokaler GATT-Characteristic-Wert geändert hat. |
startForegroundService |
Startet einen Foreground Service, um BLE-Verbindungen im Hintergrund aufrechtzuerhalten (nur Android). |
stopForegroundService |
Stoppt den Foreground Service (nur Android). |
Beispiele
initialize()
Initialisiert das BLE-Plugin. Muss vor allen anderen Methoden aufgerufen werden.
import { BluetoothLowEnergy } from '@capgo/capacitor-bluetooth-low-energy';
await BluetoothLowEnergy.initialize({ mode: 'central' });
shimWebBluetooth()
Installiert den Capacitor Web Bluetooth Shim auf navigator.bluetooth. Rufen Sie dies manuell auf, bevor Sie API Web Bluetooth in einer Capacitor nativen App verwenden.
import { BluetoothLowEnergy } from '@capgo/capacitor-bluetooth-low-energy';
BluetoothLowEnergy.shimWebBluetooth();
isAvailable()
Prüft, ob Bluetooth auf dem Gerät verfügbar ist.
import { BluetoothLowEnergy } from '@capgo/capacitor-bluetooth-low-energy';
const { available } = await BluetoothLowEnergy.isAvailable();
isEnabled()
Prüft, ob Bluetooth auf dem Gerät aktiviert ist.
import { BluetoothLowEnergy } from '@capgo/capacitor-bluetooth-low-energy';
const { enabled } = await BluetoothLowEnergy.isEnabled();
isLocationEnabled()
Prüfen, ob Standortdienste aktiviert sind (nur Android).
import { BluetoothLowEnergy } from '@capgo/capacitor-bluetooth-low-energy';
const { enabled } = await BluetoothLowEnergy.isLocationEnabled();
openAppSettings()
Die App-Einstellungen öffnen.
import { BluetoothLowEnergy } from '@capgo/capacitor-bluetooth-low-energy';
await BluetoothLowEnergy.openAppSettings();
Die obige Tabelle listet die 36 Kernmethoden auf. Listener, Version-Helper und der vollständige Contract jeder Methode sind in der GitHub Repository.
Events abonnieren
addListener gibt ein Handle zurück. Rufe handle.remove() auf, wenn der Screen unmountet, oder BluetoothLowEnergy.removeAllListeners() auf, um alle Listener zu entfernen.
Vollständige Referenz
Weiterlesen unter Verwendung von @capgo/capacitor-bluetooth-low-energy
Wenn du es nutzt Verwendung von @capgo/capacitor-bluetooth-low-energy Um die Arbeit an nativen Plugins zu planen, verbinde sie mit @capgo/capacitor-bluetooth-low-energy für die Implementierungsdetails in @capgo/capacitor-bluetooth-low-energy, Erste Schritte für die Implementierungsdetails in Erste Schritte, Capgo Plugin-Verzeichnis für den Produkt-Workflow im Capgo Plugin-Verzeichnis, Capacitor Plugins von Capgo für die Implementierungsdetails in Capacitor Plugins von Capgo, und Plugins hinzufügen oder aktualisieren für die Implementierungsdetails in Plugins hinzufügen oder aktualisieren.