Guida
Come utilizzare iBeacon in Capacitor
Utilizzare @capgo/capacitor-ibeacon
Capacitor Plugin ibeacon - Rilevamento di prossimità e monitoraggio delle regioni beacon.
Installa
bun add @capgo/capacitor-ibeacon
bunx cap sync
bunx cap sync copia il plugin nativo code nei tuoi progetti nativi. Esegui nuovamente dopo ogni aggiornamento del plugin.
Importa
import { CapacitorIbeacon } from '@capgo/capacitor-ibeacon';
Vedi API in un colpo d'occhio
| Metodo | Descrizione |
|---|---|
startMonitoringForRegion |
Inizia a monitorare una regione del segnale. Attiva gli eventi quando si entra/esci dalla regione. |
stopMonitoringForRegion |
Smetti di monitorare una regione del beacon. |
startRangingBeaconsInRegion |
Inizia a rilevare i segnali in una regione. Fornisce aggiornamenti di distanza continui. |
stopRangingBeaconsInRegion |
Esegui la scansione dei beacon in una regione. |
startAdvertising |
Inizia a pubblicizzare il dispositivo come un beacon iBeacon (solo per iOS). |
stopAdvertising |
Smetti di pubblicizzare il dispositivo come un beacon iBeacon (solo per iOS). |
requestWhenInUseAuthorization |
Richiedi l'autorizzazione di localizzazione "Quando in uso" (richiesta per la scansione/rilevamento). |
requestAlwaysAuthorization |
Richiedi l'autorizzazione di localizzazione "Sempre" (richiesta per il monitoraggio di background). |
getAuthorizationStatus |
Otteni lo stato attuale dell'autorizzazione di localizzazione. |
isBluetoothEnabled |
Controlla se Bluetooth è abilitato sul dispositivo. |
isRangingAvailable |
Controlla se la scansione è disponibile sul dispositivo. |
enableARMAFilter |
Abilita il filtro ARMA per le calcolazioni di distanza (solo per Android). |
enableBackgroundMode |
Abilita o disabilita il modello di scansione dei beacon in background (solo per Android). Questo abilita un servizio in primo piano per la detezione dei beacon in background affidabile. Deve essere chiamato dopo aver richiesto l'autorizzazione di localizzazione "Sempre". |
setBackgroundScanPeriod |
Configura i periodi di scansione in background (solo per Android). Controlla con quale frequenza e per quanto tempo il dispositivo scansiona i beacon quando è in background. |
Esempi
startMonitoringForRegion()
Inizia a monitorare una regione beacon. Attiva eventi quando si entra/esci dalla regione.
import { CapacitorIbeacon } from '@capgo/capacitor-ibeacon';
await CapacitorIbeacon.startMonitoringForRegion({
identifier: 'MyBeaconRegion',
uuid: 'B9407F30-F5F8-466E-AFF9-25556B57FE6D'
});
stopMonitoringForRegion()
Interrompi la monitoraggio per una regione beacon.
import { CapacitorIbeacon } from '@capgo/capacitor-ibeacon';
await CapacitorIbeacon.stopMonitoringForRegion({
identifier: 'MyBeaconRegion',
uuid: 'B9407F30-F5F8-466E-AFF9-25556B57FE6D'
});
startRangingBeaconsInRegion()
Avvia la ricerca dei beacon in una regione. Fornisce aggiornamenti di distanza continuo.
import { CapacitorIbeacon } from '@capgo/capacitor-ibeacon';
await CapacitorIbeacon.startRangingBeaconsInRegion({
identifier: 'MyBeaconRegion',
uuid: 'B9407F30-F5F8-466E-AFF9-25556B57FE6D'
});
stopRangingBeaconsInRegion()
Interrompi la ricerca 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'annuncio del dispositivo come un 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()
Interrompi l'annuncio del dispositivo come un iBeacon (solo iOS).
import { CapacitorIbeacon } from '@capgo/capacitor-ibeacon';
await CapacitorIbeacon.stopAdvertising();
La tabella sopra elenca le 14 metodi di base. Gli ascoltatori e gli aiuti di versione, e il contratto completo di ogni metodo, sono documentati nel repository GitHub.
Ascolta gli eventi
addListener ritorna un handle. Chiama handle.remove() quando lo schermo viene smontato, o CapacitorIbeacon.removeAllListeners() per cancellare ogni ascoltatore.
Riferimento completo
Continua da Utilizzo di @capgo/capacitor-ibeacon
Se stai utilizzando Utilizzo di @capgo/capacitor-ibeacon per pianificare il lavoro del plugin nativo, connettilo con @capgo/capacitor-ibeacon per i dettagli di implementazione in @capgo/capacitor-ibeacon Getting Started per i dettagli di implementazione in Avvio, Capgo Directory dei Plugin per il workflow del prodotto in Capgo Directory dei Plugin Capacitor Plugin da Capgo per i dettagli di implementazione in Capacitor Plugin da Capgo, e Aggiungere o Aggiornare i Plugin per i dettagli di implementazione in Aggiungere o Aggiornare i Plugin.