Guida
Come usare iBeacon in Capacitor
Utilizzo di @capgo/capacitor-ibeacon
Plugin Capacitor iBeacon - Rilevamento della prossimità e monitoraggio delle regioni beacon.
Installa
bun add @capgo/capacitor-ibeacon
bunx cap sync
bunx cap sync copia i code nativi del plugin nei tuoi progetti nativi. Eseguilo di nuovo dopo ogni aggiornamento del plugin.
Importa
import { CapacitorIbeacon } from '@capgo/capacitor-ibeacon';
API in breve
| Metodo | Descrizione |
|---|---|
startMonitoringForRegion |
Inizia il monitoraggio di una regione beacon. Attiva eventi quando entri o esci dalla regione. |
stopMonitoringForRegion |
Interrompe il monitoraggio di una regione beacon. |
startRangingBeaconsInRegion |
Avvia il ranging dei beacon in una regione. Fornisce aggiornamenti continui sulla distanza. |
stopRangingBeaconsInRegion |
Interrompe il ranging dei beacon in una regione. |
startAdvertising |
Avvia l'advertising del dispositivo come iBeacon (solo iOS). |
stopAdvertising |
Interrompe l'advertising del dispositivo come iBeacon (solo iOS). |
requestWhenInUseAuthorization |
Richiede l'autorizzazione alla posizione "Durante l'uso dell'app" (necessaria per ranging/monitoring). |
requestAlwaysAuthorization |
Richiedi l'autorizzazione alla posizione "Always" (necessaria per il monitoraggio in background). |
getAuthorizationStatus |
Ottieni lo stato attuale dell'autorizzazione alla posizione. |
isBluetoothEnabled |
Verifica se il Bluetooth è abilitato sul dispositivo. |
isRangingAvailable |
Verifica se il ranging è disponibile sul dispositivo. |
enableARMAFilter |
Abilita il filtraggio ARMA per il calcolo della distanza (solo Android). |
enableBackgroundMode |
Abilita o disabilita la scansione dei beacon in background (solo Android). Attiva un foreground service per un rilevamento affidabile. Va chiamato dopo aver richiesto l'autorizzazione "Always". |
setBackgroundScanPeriod |
Configura i periodi di scansione in background (solo Android). Controlla frequenza e durata della scansione dei beacon in background. |
Esempi
startMonitoringForRegion()
Inizia il monitoraggio di una regione beacon. Attiva eventi quando entri o esci dalla regione.
import { CapacitorIbeacon } from '@capgo/capacitor-ibeacon';
await CapacitorIbeacon.startMonitoringForRegion({
identifier: 'MyBeaconRegion',
uuid: 'B9407F30-F5F8-466E-AFF9-25556B57FE6D'
});
stopMonitoringForRegion()
Interrompe il monitoraggio di una regione beacon.
import { CapacitorIbeacon } from '@capgo/capacitor-ibeacon';
await CapacitorIbeacon.stopMonitoringForRegion({
identifier: 'MyBeaconRegion',
uuid: 'B9407F30-F5F8-466E-AFF9-25556B57FE6D'
});
startRangingBeaconsInRegion()
Avvia il ranging dei beacon in una regione. Fornisce aggiornamenti continui sulla distanza.
import { CapacitorIbeacon } from '@capgo/capacitor-ibeacon';
await CapacitorIbeacon.startRangingBeaconsInRegion({
identifier: 'MyBeaconRegion',
uuid: 'B9407F30-F5F8-466E-AFF9-25556B57FE6D'
});
stopRangingBeaconsInRegion()
Interrompe il ranging dei beacon in una regione.
import { CapacitorIbeacon } from '@capgo/capacitor-ibeacon';
await CapacitorIbeacon.stopRangingBeaconsInRegion({
identifier: 'MyBeaconRegion',
uuid: 'B9407F30-F5F8-466E-AFF9-25556B57FE6D'
});
startAdvertising()
Avvia l'advertising del dispositivo come iBeacon (solo iOS).
import { CapacitorIbeacon } from '@capgo/capacitor-ibeacon';
await CapacitorIbeacon.startAdvertising({
uuid: 'B9407F30-F5F8-466E-AFF9-25556B57FE6D',
major: 1,
minor: 2,
identifier: 'MyBeacon'
});
stopAdvertising()
Interrompe l'advertising del dispositivo come iBeacon (solo iOS).
import { CapacitorIbeacon } from '@capgo/capacitor-ibeacon';
await CapacitorIbeacon.stopAdvertising();
La tabella sopra elenca i 14 metodi principali. I listener e gli helper di versione, insieme al contratto completo di ogni metodo, sono documentati nella repository GitHub.
Ascolta gli eventi
addListener restituisce un handle. Chiama handle.remove() quando la schermata viene smontata, o CapacitorIbeacon.removeAllListeners() per rimuovere tutti i listener.
Riferimento completo
Continua da Utilizzo di @capgo/capacitor-ibeacon
Se stai usando Utilizzo di @capgo/capacitor-ibeacon per pianificare il lavoro sui plugin nativi, collegalo a @capgo/capacitor-ibeacon per i dettagli di implementazione in @capgo/capacitor-ibeacon, Per iniziare per i dettagli di implementazione nella guida introduttiva, Directory dei plugin di Capgo per il workflow del prodotto nella Capgo Plugin Directory, Plugin Capacitor di Capgo per i dettagli di implementazione in Plugin Capacitor di Capgo, e Aggiunta o aggiornamento dei plugin per i dettagli di implementazione in Aggiunta o aggiornamento dei plugin.