Übersicht
Abschnitt: „Übersicht“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.
Plattformunterstützung
Abschnitt mit dem Titel „Plattformunterstützung“| Plattform | Support | Notizen |
|---|---|---|
| iOS | Ja | Native |
| Android | Ja | Native |
| Web | Nein | Absichern mit Capacitor.getPlatform() |
Kernfunktionen
Abschnitt mit dem Titel „Kernfunktionen“initialize- Initialisiert das BLE-Plugin. Muss vor jedem anderen Aufruf ausgeführt werden.shimWebBluetooth- Installiert das Capacitor Web Bluetooth Shim aufnavigator.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.
Öffentliches API
Abschnitt mit dem Titel „Öffentliche API“| 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 Characteristic lesen. |
writeCharacteristic | Wert in eine Characteristic schreiben. |
startCharacteristicNotifications | Benachrichtigungen für eine Characteristic 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 | Advertising als Peripheral (BLE-Server) starten. |
stopAdvertising | Werbung stoppen. |
startForegroundService | Startet einen Foreground Service, um BLE-Verbindungen im Hintergrund aufrechtzuerhalten (nur Android). |
stopForegroundService | Stoppt den Foreground Service (nur Android). |
getPluginVersion | Die native Capacitor Plugin-Version abrufen. |
addListener | Listener für Geräte-Scan-Ereignisse hinzufügen. |
addListener | Listener für Geräte-Verbindungseignisse hinzufügen. |
addListener | Listener für Geräte-Trennungseignisse hinzufügen. |
addListener | Listener für Charakteristik-Änderungseignisse hinzufügen. |
removeAllListeners | Entfernt alle Listener für dieses Plugin. |
Source of Truth
Abschnitt mit dem Titel „Source of Truth“Diese Referenz wird synchronisiert von src/definitions.ts in einem capacitor-bluetooth-low-energy.
Weiter mit @capgo/capacitor-bluetooth-low-energy
Abschnitt mit dem Titel „Weiter mit @capgo/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.