Zum Inhalt springen

@capgo/capacitor-bluetooth-low-energy

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

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

Starte mit initialize() und den anderen unten aufgeführten Core-Methoden.

PlattformSupportNotizen
iOSJaNative
AndroidJaNative
WebNeinAbsichern mit Capacitor.getPlatform()
  • initialize - Initialisiert das BLE-Plugin. Muss vor jedem anderen Aufruf ausgeführt werden.
  • shimWebBluetooth - Installiert das 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üfen, ob Bluetooth auf dem Gerät verfügbar ist.
  • isEnabled - Prüfen, ob Bluetooth auf dem Gerät aktiviert ist.
MethodeBeschreibung
initializeInitialisiert das BLE-Plugin. Muss vor allen anderen Methoden aufgerufen werden.
shimWebBluetoothInstalliere den Capacitor Web Bluetooth Shim auf navigator.bluetooth. Rufe dies manuell auf, bevor du das Web Bluetooth API in einer nativen Capacitor-App verwendest.
isAvailablePrüft, ob Bluetooth auf dem Gerät verfügbar ist.
isEnabledPrüfen, ob Bluetooth auf dem Gerät aktiviert ist.
isLocationEnabledPrü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).
checkPermissionsPrüfe den aktuellen Berechtigungsstatus.
requestPermissionsBluetooth-Berechtigungen anfordern.
startScanScan nach BLE-Geräten starten.
stopScanScan nach BLE-Geräten stoppen.
connectMit einem BLE-Gerät verbinden.
disconnectVerbindung zu einem BLE-Gerät trennen.
createBondEinen Bond mit einem BLE-Gerät erstellen (nur Android).
isBondedPrüfen, ob ein Gerät gebondet ist (nur Android).
discoverServicesServices auf einem verbundenen Gerät entdecken.
getServicesEntdeckte Services eines Geräts abrufen.
getConnectedDevicesListe der verbundenen Geräte abrufen.
readCharacteristicWert einer Characteristic lesen.
writeCharacteristicWert in eine Characteristic schreiben.
startCharacteristicNotificationsBenachrichtigungen für eine Characteristic starten.
stopCharacteristicNotificationsBenachrichtigungen für eine Characteristic stoppen.
readDescriptorEinen Descriptor-Wert lesen.
writeDescriptorEinen Wert in einen Descriptor schreiben.
readRssiDen RSSI (Signalstärke) eines verbundenen Geräts lesen.
requestMtuMTU-Größenänderung anfordern (nur Android).
requestConnectionPriorityVerbindungspriorität anfordern (nur Android).
startAdvertisingAdvertising als Peripheral (BLE-Server) starten.
stopAdvertisingWerbung stoppen.
startForegroundServiceStartet einen Foreground Service, um BLE-Verbindungen im Hintergrund aufrechtzuerhalten (nur Android).
stopForegroundServiceStoppt den Foreground Service (nur Android).
getPluginVersionDie native Capacitor Plugin-Version abrufen.
addListenerListener für Geräte-Scan-Ereignisse hinzufügen.
addListenerListener für Geräte-Verbindungseignisse hinzufügen.
addListenerListener für Geräte-Trennungseignisse hinzufügen.
addListenerListener für Charakteristik-Änderungseignisse hinzufügen.
removeAllListenersEntfernt alle Listener für dieses Plugin.

Diese Referenz wird synchronisiert von src/definitions.ts in einem capacitor-bluetooth-low-energy.

Wenn du es nutzt @capgo/capacitor-bluetooth-low-energy um Migration und Enterprise-Betrieb zu planen, verbinde es mit @capgo/capacitor-bluetooth-low-energy verwenden für die native Funktion in „@capgo/capacitor-bluetooth-low-energy verwenden“, Capgo Enterprise für den Produkt-Workflow in Capgo Enterprise, Ionic Enterprise Plugin-Alternativen für den Produkt-Workflow in Ionic Enterprise Plugin-Alternativen, Capgo Alternativen für den Produkt-Workflow in Capgo Alternativen, und Capgo Beratung für den Produkt-Workflow in Capgo Consulting.