La tua app può iscriversi ai messaggi beacon Bluetooth Low Energy (BLE) utilizzando lo stesso meccanismo utilizzato per iscriversi ai messaggi pubblicati da altri dispositivi nelle vicinanze.
Per impostazione predefinita, le iscrizioni ai beacon funzionano solo quando l'app è in primo piano. Quando l'app passa in background, le iscrizioni interrompono automaticamente la ricerca di beacon. Per informazioni dettagliate su come attivare la scansione in background, consulta Scansione in background.
Per iscriverti ai beacon, imposta il parametro deviceTypesToDiscover su
kGNSDeviceBLEBeacon nei parametri di iscrizione. Lo snippet seguente mostra come eseguire questa operazione:
Objective-C
id<GNSSubscription> beaconSubscription = [messageManager
subscriptionWithMessageFoundHandler:myMessageFoundHandler
messageLostHandler:myMessageLostHandler
paramsBlock:^(GNSSubscriptionParams *params) {
params.deviceTypesToDiscover = kGNSDeviceBLEBeacon;
}];
Swift
let beaconSubscription = messageManager.subscriptionWithMessageFoundHandler(
myMessageFoundHandler, messageLostHandler: myMessageLostHandler,
paramsBlock: { (params: GNSSubscriptionParams!) in
params.deviceTypesToDiscover = .BLEBeacon
})
La sottoscrizione precedente rileva solo i beacon di proprietà del tuo progetto e riceve tutti i messaggi da questi beacon. Se vuoi ricevere messaggi da beacon registrati con uno spazio dei nomi diverso, puoi passare uno spazio dei nomi nei parametri di iscrizione. Analogamente, se vuoi un tipo specifico di messaggio, puoi anche passare un tipo di messaggio per il filtro. Il seguente snippet mostra come farlo:
Objective-C
id<GNSSubscription> beaconSubscription = [messageManager
subscriptionWithMessageFoundHandler:myMessageFoundHandler
messageLostHandler:myMessageLostHandler
paramsBlock:^(GNSSubscriptionParams *params) {
params.deviceTypesToDiscover = kGNSDeviceBLEBeacon;
params.messageNamespace = @"com.mycompany.mybeaconservice";
params.type = @"mybeacontype";
}];
Swift
let beaconSubscription = messageManager.subscriptionWithMessageFoundHandler(
myMessageFoundHandler, messageLostHandler: myMessageLostHandler,
paramsBlock: { (params: GNSSubscriptionParams!) in
params.deviceTypesToDiscover = .BLEBeacon
params.messageNamespace = "com.mycompany.mybeaconservice"
params.type = "mybeacontype"
})
Per impostazione predefinita, una sottoscrizione di beacon cerca entrambi i tipi di beacon, Eddystone e iBeacon. Quando la scansione iBeacon è attiva, agli utenti verrà chiesto di concedere
all'app l'autorizzazione a utilizzare i dati sulla posizione. Il file Info.plist della tua app deve includere la chiave NSLocationWhenInUseUsageDescription con una breve spiegazione del motivo per cui viene utilizzata la posizione. Per maggiori dettagli, consulta la documentazione di Apple.
Se vuoi cercare solo beacon Eddystone, puoi disattivare la scansione di iBeacon in GNSBeaconStrategy e iOS non chiederà all'utente l'autorizzazione per utilizzare la posizione. Il seguente snippet mostra come disattivare la scansione iBeacon per l'abbonamento originale riportato sopra:
Objective-C
id<GNSSubscription> beaconSubscription = [messageManager
subscriptionWithMessageFoundHandler:myMessageFoundHandler
messageLostHandler:myMessageLostHandler
paramsBlock:^(GNSSubscriptionParams *params) {
params.deviceTypesToDiscover = kGNSDeviceBLEBeacon;
params.beaconStrategy =
[GNSBeaconStrategy strategyWithParamsBlock:^(GNSBeaconStrategyParams *params) {
params.includeIBeacons = NO;
};
}];
Swift
let beaconSubscription = messageManager.subscriptionWithMessageFoundHandler(
myMessageFoundHandler, messageLostHandler: myMessageLostHandler,
paramsBlock: { (params: GNSSubscriptionParams!) in
params.deviceTypesToDiscover = .BLEBeacon
params.beaconStrategy =
GNSBeaconStrategy(paramsBlock: { (params: GNSBeaconStrategyParams!) in
params.includeIBeacons = false
})
})
Per impostazione predefinita, la scansione a basso consumo è abilitata, il che a volte può comportare latenze elevate durante la ricerca di beacon Eddystone. Quando la modalità a basso consumo è disattivata, viene utilizzata la scansione iBeacon per trovare i beacon Eddystone, il che può ridurre queste latenze. Tuttavia, questo comporta un maggiore utilizzo della batteria e iOS chiederà all'utente l'autorizzazione per utilizzare la posizione.
Il seguente snippet mostra come disattivare la modalità a basso consumo durante la scansione dei beacon Eddystone.
Objective-C
id<GNSSubscription> beaconSubscription = [messageManager
subscriptionWithMessageFoundHandler:myMessageFoundHandler
messageLostHandler:myMessageLostHandler
paramsBlock:^(GNSSubscriptionParams *params) {
params.deviceTypesToDiscover = kGNSDeviceBLEBeacon;
params.beaconStrategy =
[GNSBeaconStrategy strategyWithParamsBlock:^(GNSBeaconStrategyParams *params) {
params.includeIBeacons = NO;
params.lowPowerPreferred = NO;
};
}];
Swift
let beaconSubscription = messageManager.subscriptionWithMessageFoundHandler(
myMessageFoundHandler, messageLostHandler: myMessageLostHandler,
paramsBlock: { (params: GNSSubscriptionParams!) in
params.deviceTypesToDiscover = .BLEBeacon
params.beaconStrategy =
GNSBeaconStrategy(paramsBlock: { (params: GNSBeaconStrategyParams!) in
params.includeIBeacons = false
params.lowPowerPreferred = false
})
})
Durante la scansione degli iBeacon, la finestra di dialogo per l'autorizzazione di accesso alla posizione di iOS è preceduta dalla finestra di dialogo per l'autorizzazione per i dispositivi nelle vicinanze. Se vuoi ignorare questa finestra di dialogo (ad esempio, per fornire una finestra di dialogo "preflight" che spiega perché è necessaria l'autorizzazione di accesso alla posizione), imposta permissionRequestHandler su un blocco personalizzato nei parametri di abbonamento. Il seguente snippet mostra come fare:
Objective-C
id<GNSSubscription> beaconSubscription = [messageManager
subscriptionWithMessageFoundHandler:myMessageFoundHandler
messageLostHandler:myMessageLostHandler
paramsBlock:^(GNSSubscriptionParams *params) {
params.deviceTypesToDiscover = kGNSDeviceBLEBeacon;
params.permissionRequestHandler = ^(GNSPermissionHandler permissionHandler) {
// Show your custom dialog here, and don't forget to call permissionHandler after it is dismissed
permissionHandler(userGavePermission);
};
}];
Swift
let beaconSubscription = messageManager.subscriptionWithMessageFoundHandler(
myMessageFoundHandler, messageLostHandler: myMessageLostHandler,
paramsBlock: { (params: GNSSubscriptionParams!) in
params.deviceTypesToDiscover = .BLEBeacon
params.permissionRequestHandler = { (permissionHandler: GNSPermissionHandler!) in
// Show your custom dialog here, and don't forget to call permissionHandler after it is dismissed
permissionHandler(userGavePermission);
}
})
Scansione in background
Poiché la scansione dei beacon utilizza la tecnologia BLE, può funzionare in background. Ecco alcuni aspetti da tenere presente quando decidi di utilizzare la modalità in background:
- Il BLE in background comporta un costo aggiuntivo per la batteria. Il costo è basso, ma devi misurarlo prima di decidere di utilizzare la modalità in background.
- iOS chiederà all'utente l'autorizzazione per utilizzare la posizione in background se la scansione iBeacon è attiva o la modalità a basso consumo è disattivata.
Per attivare la scansione dei beacon in background, segui questi passaggi aggiuntivi:
Attiva la modalità in background per l'abbonamento passando un oggetto
GNSBeaconStrategyconfigurato correttamente. Il seguente snippet mostra come fare:Objective-C
id<GNSSubscription> beaconSubscription = [messageManager subscriptionWithMessageFoundHandler:myMessageFoundHandler messageLostHandler:myMessageLostHandler paramsBlock:^(GNSSubscriptionParams *params) { params.deviceTypesToDiscover = kGNSDeviceBLEBeacon; params.beaconStrategy = [GNSBeaconStrategy strategyWithParamsBlock:^(GNSBeaconStrategyParams *params) { params.allowInBackground = YES; }]; }];Swift
let beaconSubscription = messageManager.subscriptionWithMessageFoundHandler( myMessageFoundHandler, messageLostHandler: myMessageLostHandler, paramsBlock: { (params: GNSSubscriptionParams!) in params.deviceTypesToDiscover = .BLEBeacon params.beaconStrategy = GNSBeaconStrategy(paramsBlock: { (params: GNSBeaconStrategyParams!) in params.allowInBackground = true }) })Aggiungi le voci richieste al file
Info.plistdell'app:UIBackgroundModesvoci:bluetooth-centralper la scansione BLE in background.locationper la scansione iBeacon in background utilizzando la modalità ad alta potenza. Puoi omettere questo elemento se esegui la scansione a basso consumo solo per i beacon Eddystone.
NSLocationAlwaysUsageDescriptionstringa che descrive il motivo per cui monitorerai la posizione dell'utente in background. Ad esempio, "La tua posizione è necessaria per cercare beacon in background". Per maggiori dettagli, consulta la documentazione di Apple. Puoi omettere questo valore se esegui la scansione a basso consumo solo per i beacon Eddystone.
L'utente può attivare o disattivare la scansione in background nella tua app? In questo caso, devi salvare il valore della modalità in background in
NSUserDefaultsperché iOS può terminare l'app in qualsiasi momento mentre è in background. L'app deve:- Salva il valore della modalità in background in
NSUserDefaultsogni volta che l'utente lo modifica. - All'avvio, leggilo da
NSUserDefaultse ripristina l'abbonamento ai beacon se la modalità in background è attiva.
- Salva il valore della modalità in background in
Notifiche in background
Se vuoi che la tua app avvisi l'utente quando vengono rilevati beacon in background, puoi utilizzare le notifiche locali. Per maggiori dettagli, consulta la sezione sulle notifiche in background.