Zum Hauptinhalt springen

Bluetooth Low Energy Capacitor Plugin

Vollwertiges BLE-Plugin zum Scannen, Verbinden, Lesen, Schreiben und Empfangen von Benachrichtigungen von Bluetooth-Geräten

Installieren

bun add @capgo/capacitor-bluetooth-low-energy bunx cap sync
npm, pnpm oder yarn
  • npm install @capgo/capacitor-bluetooth-low-energy
  • pnpm add @capgo/capacitor-bluetooth-low-energy
  • yarn add @capgo/capacitor-bluetooth-low-energy

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.

FAQ

FAQ zum Bluetooth Low Energy Plugin

Wie installiere ich das Bluetooth Low Energy Plugin in einer Capacitor-App?

Führe "bun add @capgo/capacitor-bluetooth-low-energy" (oder "npm install @capgo/capacitor-bluetooth-low-energy") aus und starte anschließend "bunx cap sync", damit die iOS- und Android-Projekte die nativen code übernehmen. Importiere es in deinem App-code aus "@capgo/capacitor-bluetooth-low-energy".

Funktioniert @capgo/capacitor-bluetooth-low-energy mit React, Vue und Angular?

Ja. Bluetooth Low Energy ist ein Capacitor-Paket und funktioniert daher mit jedem Web-Framework, das in Capacitor läuft, einschließlich Ionic, React, Vue, Angular, Svelte und reinem JavaScript.

Welche Capacitor-Version unterstützt @capgo/capacitor-bluetooth-low-energy?

Capgo Plugins folgen der Major-Version von Capacitor: Nutze die Plugin-Major-Version, die zu deiner Capacitor Major-Version passt (z. B. Plugin v8 bei Capacitor 8). Die Kompatibilitätstabelle im GitHub README listet die gepflegten Versionen auf.

Ist @capgo/capacitor-bluetooth-low-energy kostenlos und Open Source?

Ja. Der code-Quellcode ist auf GitHub öffentlich unter https://github.com/Cap-go/capacitor-bluetooth-low-energy/ verfügbar und das Paket lässt sich kostenlos von npm installieren. Bug-Reports und Pull Requests sind willkommen.

Kann ich code mit Bluetooth Low Energy aktualisieren, ohne eine App-Store-Prüfung abwarten zu müssen?

Die Installation oder ein Upgrade des Plugins ändert den nativen code, weshalb ein neuer Store-Build nötig ist. Danach können JavaScript-, HTML- und CSS-Änderungen, die das Plugin aufrufen, sofort per Capgo Live Updates ausgeliefert werden.

Bluetooth Low Energy-Änderungen ausliefern, ohne auf das App-Review zu warten

Sobald das Plugin in deinem Store-Build ist, bringt Capgo mit Live-Updates deine JavaScript-, HTML- und CSS-Änderungen in Minuten zu den Nutzern.

Starte mit Capgo