Anleitung
iBeacon in Capacitor nutzen
@capgo/capacitor-ibeacon verwenden
Capacitor iBeacon Plugin – Proximity Detection und Beacon-Region Monitoring.
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 |
Berechtigung für „Immer“-Standortzugriff anfordern (erforderlich für Background Monitoring). |
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 |
Background Beacon Scanning aktivieren oder deaktivieren (nur Android). Dies startet einen Foreground Service für eine zuverlässige Beacon-Erkennung im Hintergrund. Muss nach der Anforderung der „Immer“-Standortberechtigung aufgerufen werden. |
setBackgroundScanPeriod |
Background Scan-Intervalle konfigurieren (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
Weiterlesen unter Verwendung von @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 die Implementierungsdetails 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.