Zum Hauptinhalt springen

iBeacon Capacitor Plugin

iBeacon-Plugin für Capacitor – Proximity Detection und Beacon-Region-Monitoring

Installieren

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

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.

FAQ

iBeacon Plugin FAQ

Wie installiere ich das iBeacon-Plugin in einer Capacitor-App?

Führe "bun add @capgo/capacitor-ibeacon" (oder "npm install @capgo/capacitor-ibeacon") aus und danach "bunx cap sync", damit die iOS- und Android-Projekte die nativen code übernehmen. Importiere es in deiner App code aus "@capgo/capacitor-ibeacon".

Funktioniert @capgo/capacitor-ibeacon mit React, Vue und Angular?

Ja. iBeacon ist ein Capacitor-Package 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-ibeacon?

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-ibeacon kostenlos und Open Source?

Ja. Der code ist auf GitHub unter https://github.com/Cap-go/capacitor-ibeacon/ öffentlich einsehbar und das Package lässt sich kostenlos über npm installieren. Bug-Reports und Pull Requests sind willkommen.

Kann ich code, das iBeacon nutzt, ohne App-Store-Review aktualisieren?

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.

iBeacon-Ä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