Anleitung
So nutzt du Bluetooth Low Energy in Capacitor
@capgo/capacitor-bluetooth-low-energy verwenden
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 nativen Capacitor-App verwendest. |
isAvailable |
Prüft, ob Bluetooth auf dem Gerät verfügbar ist. |
isEnabled |
Prüfen, ob Bluetooth auf dem Gerät aktiviert ist. |
isLocationEnabled |
Prüfen, ob der Standortdienst aktiviert ist (nur Android). |
openAppSettings |
Öffne die App-Einstellungen. |
openBluetoothSettings |
Öffne die Bluetooth-Einstellungen (nur Android). |
openLocationSettings |
Öffne die Standort-Einstellungen (nur Android). |
checkPermissions |
Prüfe den aktuellen Berechtigungsstatus. |
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 einem BLE-Gerät trennen. |
createBond |
Einen Bond mit einem BLE-Gerät erstellen (nur Android). |
isBonded |
Prüfen, ob ein Gerät gebondet ist (nur Android). |
discoverServices |
Services auf einem verbundenen Gerät entdecken. |
getServices |
Entdeckte Services eines Geräts abrufen. |
getConnectedDevices |
Liste der verbundenen Geräte abrufen. |
readCharacteristic |
Wert einer Charakteristik lesen. |
writeCharacteristic |
Wert in eine Charakteristik schreiben. |
startCharacteristicNotifications |
Benachrichtigungen für eine Charakteristik starten. |
stopCharacteristicNotifications |
Benachrichtigungen für eine Characteristic stoppen. |
readDescriptor |
Einen Descriptor-Wert lesen. |
writeDescriptor |
Einen Wert in einen Descriptor schreiben. |
readRssi |
Den RSSI (Signalstärke) eines verbundenen Geräts lesen. |
requestMtu |
MTU-Größenänderung anfordern (nur Android). |
requestConnectionPriority |
Verbindungspriorität anfordern (nur Android). |
startAdvertising |
Werbung als Peripheriegerät (BLE-Server) starten. |
stopAdvertising |
Werbung stoppen. |
addGattService |
Fügt dem lokalen GATT-Server einen GATT-Service mit Characteristics hinzu. Muss im Peripheral-Modus vor dem Start des Advertising aufgerufen werden. |
removeGattService |
Entfernt einen GATT-Service vom lokalen GATT-Server. |
setGattCharacteristicValue |
Setzt den Wert einer lokalen GATT-Characteristic. |
notifyGattCharacteristicChanged |
Benachrichtigt verbundene Centrals, dass sich der Wert einer lokalen GATT-Characteristic 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()
Installiere den Capacitor Web Bluetooth Shim auf navigator.bluetooth. Rufe dies manuell auf, bevor du das Web Bluetooth API in einer nativen Capacitor-App verwendest.
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üfen, 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 der Standortdienst aktiviert ist (nur Android).
import { BluetoothLowEnergy } from '@capgo/capacitor-bluetooth-low-energy';
const { enabled } = await BluetoothLowEnergy.isLocationEnabled();
openAppSettings()
Öffne die App-Einstellungen.
import { BluetoothLowEnergy } from '@capgo/capacitor-bluetooth-low-energy';
await BluetoothLowEnergy.openAppSettings();
Die obige Tabelle listet die 36 Kernmethoden auf. Listener- und Versionshelfer sowie der vollständige Vertrag 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
Weiter mit „@capgo/capacitor-bluetooth-low-energy verwenden“
Wenn du es nutzt @capgo/capacitor-bluetooth-low-energy verwenden 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.