Guide
Wie man Bluetooth Low Energy in Capacitor verwendet
Mit @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 Plugin-code in Ihre native Projekte. Führen Sie es erneut aus, nachdem jede Plugin-Upgrade durchgeführt wurde
Importieren
import { BluetoothLowEnergy } from '@capgo/capacitor-bluetooth-low-energy';
API im Überblick
| Methode | Beschreibung |
|---|---|
initialize |
Initialisiert den BLE-Plugin. Muss vor jeder anderen Methode aufgerufen werden |
shimWebBluetooth |
Installiert den Capacitor Web Bluetooth Shim auf navigator.bluetooth . Ruf diese manuell auf, bevor du den Web Bluetooth API aus einer Capacitor native App verwendest |
isAvailable |
Überprüfen Sie, ob Bluetooth auf dem Gerät verfügbar ist. |
isEnabled |
Überprüfen Sie, ob Bluetooth auf dem Gerät aktiviert ist. |
isLocationEnabled |
Überprüfen Sie, ob die Standortdienste aktiviert sind (nur Android). |
openAppSettings |
Öffnen Sie die Einstellungen der App. |
openBluetoothSettings |
Öffnen Sie die Bluetooth-Einstellungen (nur Android). |
openLocationSettings |
Öffnen Sie die Standorteinstellungen (nur Android). |
checkPermissions |
Überprüfen Sie den aktuellen Berechtigungsstatus. |
requestPermissions |
Berechtigungen für Bluetooth anfordern. |
startScan |
Beginnen Sie mit der Suche nach BLE-Geräten. |
stopScan |
Beenden Sie die Suche nach BLE-Geräten. |
connect |
Verbinden Sie sich mit einem BLE-Gerät. |
disconnect |
Trennen Sie sich von einem BLE-Gerät. |
createBond |
Ein Bond mit einem BLE-Gerät (nur Android) erstellen. |
isBonded |
Überprüfen, ob ein Gerät gebunden ist (nur Android). |
discoverServices |
Entdecken Sie Dienste auf einem verbundenen Gerät. |
getServices |
Ermittle Dienste für ein Gerät. |
getConnectedDevices |
Erhalten Sie eine Liste der verbundenen Geräte. |
readCharacteristic |
Eine Kennzeichnenschaftarakteristikwert lesen. |
writeCharacteristic |
Ein Wert auf eine Eigenschaft schreiben. |
startCharacteristicNotifications |
Benachrichtigungen für eine Eigenschaft starten. |
stopCharacteristicNotifications |
Benachrichtigungen für eine Eigenschaft stoppen. |
readDescriptor |
Eine Kennzeichnenschaftarakteristikwert lesen. |
writeDescriptor |
Eine Werteintrag in eine Kennzeichnenschaftarakteristik schreiben. |
readRssi |
Das RSSI (Signalstärke) eines verbundenen Geräts lesen. |
requestMtu |
Anfrage zur Änderung der MTU-Größe (nur Android). |
requestConnectionPriority |
Anfrage zur Verbindungspriorität (nur Android). |
startAdvertising |
Als BLE-Server als Peripherie beginnen zu senden. |
stopAdvertising |
Senden Sie aufhören. |
addGattService |
Einen GATT-Dienst mit Merkmalen zur lokalen GATT-Serversoftware hinzufügen. Muss in Peripheriemodus vor dem Starten des Sendens aufgerufen werden. |
removeGattService |
Einen GATT-Dienst von der lokalen GATT-Serversoftware entfernen. |
setGattCharacteristicValue |
Einstellen Sie den Wert einer lokalen GATT-Eigenschaft. |
notifyGattCharacteristicChanged |
Benachrichtigen Sie verbundene Zentralen, dass sich der Wert einer lokalen GATT-Eigenschaft geändert hat. |
startForegroundService |
Einen Hintergrunddienst starten, um BLE-Verbindungen im Hintergrund aufrechtzuerhalten (nur Android). |
stopForegroundService |
Den Hintergrunddienst beenden (nur Android). |
Beispiele
initialize()
Initialisieren Sie das BLE-Plugin. Muss vor jeder anderen Methode aufgerufen werden.
import { BluetoothLowEnergy } from '@capgo/capacitor-bluetooth-low-energy';
await BluetoothLowEnergy.initialize({ mode: 'central' });
shimWebBluetooth()
Install das Capacitor Web Bluetooth Shim auf navigator.bluetoothRufen Sie dies manuell vor der Verwendung des Web Bluetooth API aus einer Capacitor nativen App auf.
import { BluetoothLowEnergy } from '@capgo/capacitor-bluetooth-low-energy';
BluetoothLowEnergy.shimWebBluetooth();
isAvailable()
Überprüfen Sie, ob Bluetooth auf dem Gerät verfügbar ist.
import { BluetoothLowEnergy } from '@capgo/capacitor-bluetooth-low-energy';
const { available } = await BluetoothLowEnergy.isAvailable();
isEnabled()
Überprüfen Sie, ob Bluetooth auf dem Gerät aktiviert ist.
import { BluetoothLowEnergy } from '@capgo/capacitor-bluetooth-low-energy';
const { enabled } = await BluetoothLowEnergy.isEnabled();
isLocationEnabled()
Überprüfen Sie, ob die Standortdienste aktiviert sind (nur Android).
import { BluetoothLowEnergy } from '@capgo/capacitor-bluetooth-low-energy';
const { enabled } = await BluetoothLowEnergy.isLocationEnabled();
openAppSettings()
Öffnen Sie die Einstellungen der App.
import { BluetoothLowEnergy } from '@capgo/capacitor-bluetooth-low-energy';
await BluetoothLowEnergy.openAppSettings();
Die Tabelle oben listet die 36 Kernmethoden. Helfer für Listener und Versionen sowie die vollständige Vertragsstruktur jeder Methode sind in der GitHub-Repository.
Hören Sie auf Ereignisse
addListener erstellt einen Handle. Rufen Sie handle.remove() an, wenn die Bildschirmabrechnung erfolgt ist, oder BluetoothLowEnergy.removeAllListeners() um jeden Listener zu löschen.
Vollständige Referenz
Fortfahren von Using @capgo/capacitor-bluetooth-low-energy
Wenn Sie Using verwenden Verwendung von @capgo/capacitor-bluetooth-low-energy um native Plugin-Arbeit zu planen, verbinden Sie es mit @capgo/capacitor-bluetooth-low-Energie zur Implementierungsdetail in @capgo/capacitor-bluetooth-low-energy Getting Started zur Implementierungsdetail in Anleitung Capgo Plugin-Verzeichnis zur Produktionsablauf in Capgo Plugin-Verzeichnis Capacitor Plugins von Capgo zur Implementierungsdetail in Capacitor Plugins von Capgo, und Plugins hinzufügen oder aktualisieren zur Implementierungsdetail in Plugins hinzufügen oder aktualisieren.