Anleitung
iBeacon in Capacitor nutzen
@capgo/capacitor-ibeacon verwenden
Capacitor iBeacon Plugin – Nahbereichserkennung und Beacon-Regionen überwachen
Installieren
bun add @capgo/capacitor-ibeacon
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 { CapacitorIbeacon } from '@capgo/capacitor-ibeacon';
API auf einen Blick
| Methode | Beschreibung |
|---|---|
startMonitoringForRegion |
Überwachung einer Beacon-Region starten. Löst Events beim Betreten/Verlassen der Region aus. |
stopMonitoringForRegion |
Überwachung einer Beacon-Region stoppen. |
startRangingBeaconsInRegion |
Beacon-Ranging in einer Region starten. Liefert kontinuierliche Distanz-Updates. |
stopRangingBeaconsInRegion |
Beacon-Ranging in einer Region stoppen. |
startAdvertising |
Das Gerät als iBeacon Advertising starten (nur iOS). |
stopAdvertising |
Das Gerät als iBeacon Advertising stoppen (nur iOS). |
requestWhenInUseAuthorization |
Standortfreigabe „Beim Verwenden der App“ anfordern (erforderlich für Ranging/Monitoring). |
requestAlwaysAuthorization |
„Immer“-Standortberechtigung anfordern (erforderlich für die Hintergrundüberwachung). |
getAuthorizationStatus |
Aktuellen Status der Standortfreigabe abrufen. |
isBluetoothEnabled |
Prüfen, ob Bluetooth auf dem Gerät aktiviert ist. |
isRangingAvailable |
Prüft, ob Ranging auf dem Gerät verfügbar ist. |
enableARMAFilter |
Aktiviert ARMA-Filterung für Distanzberechnungen (nur Android). |
enableBackgroundMode |
Aktiviert oder deaktiviert den Beacon-Scanning-Modus im Hintergrund (nur Android). Dies aktiviert einen Foreground Service für zuverlässige Beacon-Erkennung im Hintergrund. Muss aufgerufen werden, nachdem die „Immer“-Standortberechtigung angefordert wurde. |
setBackgroundScanPeriod |
Konfiguriert die Scan-Zeiträume im Hintergrund (nur Android). Steuert, wie oft und wie lange das Gerät im Hintergrund nach Beacons scannt. |
Beispiele
startMonitoringForRegion()
Überwachung einer Beacon-Region starten. Löst Events beim Betreten/Verlassen der Region aus.
import { CapacitorIbeacon } from '@capgo/capacitor-ibeacon';
await CapacitorIbeacon.startMonitoringForRegion({
identifier: 'MyBeaconRegion',
uuid: 'B9407F30-F5F8-466E-AFF9-25556B57FE6D'
});
stopMonitoringForRegion()
Überwachung einer Beacon-Region stoppen.
import { CapacitorIbeacon } from '@capgo/capacitor-ibeacon';
await CapacitorIbeacon.stopMonitoringForRegion({
identifier: 'MyBeaconRegion',
uuid: 'B9407F30-F5F8-466E-AFF9-25556B57FE6D'
});
startRangingBeaconsInRegion()
Beacon-Ranging in einer Region starten. Liefert kontinuierliche Distanz-Updates.
import { CapacitorIbeacon } from '@capgo/capacitor-ibeacon';
await CapacitorIbeacon.startRangingBeaconsInRegion({
identifier: 'MyBeaconRegion',
uuid: 'B9407F30-F5F8-466E-AFF9-25556B57FE6D'
});
stopRangingBeaconsInRegion()
Beacon-Ranging in einer Region stoppen.
import { CapacitorIbeacon } from '@capgo/capacitor-ibeacon';
await CapacitorIbeacon.stopRangingBeaconsInRegion({
identifier: 'MyBeaconRegion',
uuid: 'B9407F30-F5F8-466E-AFF9-25556B57FE6D'
});
startAdvertising()
Das Gerät als iBeacon Advertising starten (nur iOS).
import { CapacitorIbeacon } from '@capgo/capacitor-ibeacon';
await CapacitorIbeacon.startAdvertising({
uuid: 'B9407F30-F5F8-466E-AFF9-25556B57FE6D',
major: 1,
minor: 2,
identifier: 'MyBeacon'
});
stopAdvertising()
Das Gerät als iBeacon Advertising stoppen (nur iOS).
import { CapacitorIbeacon } from '@capgo/capacitor-ibeacon';
await CapacitorIbeacon.stopAdvertising();
Die obige Tabelle listet die 14 Kernmethoden auf. Listener- und Versions-Helper sowie der vollständige Contract jeder Methode sind in der GitHub Repository.
Events abonnieren
addListener gibt ein Handle zurück. Rufe handle.remove() auf, wenn der Screen unmountet, oder CapacitorIbeacon.removeAllListeners() auf, um alle Listener zu entfernen.
Vollständige Referenz
Weiter mit @capgo/capacitor-ibeacon
Wenn du es nutzt @capgo/capacitor-ibeacon verwenden Um die Arbeit an nativen Plugins zu planen, verbinde sie mit @capgo/capacitor-ibeacon für das Implementierungsdetail in @capgo/capacitor-ibeacon, 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.