Aplikacja może subskrybować wiadomości z beacona Bluetooth Low Energy (BLE) za pomocą tego samego mechanizmu, który jest używany do subskrybowania wiadomości publikowanych przez inne urządzenia w pobliżu.
Domyślnie subskrypcje sygnałów nawigacyjnych działają tylko wtedy, gdy aplikacja jest na pierwszym planie. Gdy aplikacja przechodzi w tło, subskrypcje automatycznie przestają skanować w poszukiwaniu beaconów. Szczegółowe informacje o włączaniu skanowania w tle znajdziesz w sekcji Skanowanie w tle.
Aby zasubskrybować sygnały, ustaw parametr deviceTypesToDiscover na kGNSDeviceBLEBeacon w parametrach subskrypcji. Ten fragment kodu pokazuje, jak to zrobić:
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
})
Powyższa subskrypcja wykrywa tylko nadajniki należące do Twojego projektu i odbiera wszystkie wiadomości z tych nadajników. Jeśli chcesz otrzymywać wiadomości z beaconów zarejestrowanych w innej przestrzeni nazw, możesz przekazać przestrzeń nazw w parametrach subskrypcji. Jeśli chcesz wyświetlić określony typ wiadomości, możesz też przekazać typ wiadomości do filtrowania. Poniższy fragment kodu pokazuje, jak to zrobić:
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"
})
Domyślnie subskrypcja sygnałów wyszukuje oba typy sygnałów: Eddystone i iBeacon. Gdy skanowanie iBeacon jest włączone, użytkownicy są proszeni o przyznanie aplikacji uprawnień do korzystania z ich danych o lokalizacji. Plik Info.plist aplikacji musi zawierać klucz NSLocationWhenInUseUsageDescription z krótkim wyjaśnieniem, dlaczego lokalizacja jest używana. Szczegółowe informacje znajdziesz w dokumentacji Apple.
Jeśli chcesz skanować tylko pod kątem sygnałów Eddystone, możesz wyłączyć skanowanie iBeacon w GNSBeaconStrategy, a iOS nie będzie prosić użytkownika o pozwolenie na używanie lokalizacji. Poniższy fragment kodu pokazuje, jak wyłączyć skanowanie iBeacon w przypadku pierwotnej subskrypcji:
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
})
})
Domyślnie włączone jest skanowanie o niskim poborze energii, co może czasami powodować duże opóźnienia podczas wyszukiwania beaconów Eddystone. Gdy tryb oszczędzania baterii jest wyłączony, do znajdowania beaconów Eddystone używane jest skanowanie iBeacon, co może zmniejszyć te opóźnienia. Powoduje to jednak większe zużycie baterii, a iOS poprosi użytkownika o zgodę na używanie lokalizacji.
Poniższy fragment kodu pokazuje, jak wyłączyć tryb oszczędzania baterii podczas skanowania w poszukiwaniu sygnałów z beacona 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
})
})
Podczas skanowania w poszukiwaniu urządzeń iBeacon okno z prośbą o zgodę na dostęp do lokalizacji w iOS jest poprzedzone oknem z prośbą o zgodę na dostęp do funkcji „W pobliżu”. Jeśli chcesz zastąpić to okno (na przykład po to, aby wyświetlić okno „wstępne” wyjaśniające, dlaczego potrzebny jest dostęp do lokalizacji), ustaw permissionRequestHandler na blok niestandardowy w parametrach subskrypcji. Poniższy fragment kodu pokazuje, jak to zrobić:
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);
}
})
Skanowanie w tle
Skanowanie sygnałów nawigacyjnych korzysta z technologii BLE, więc może działać w tle. Oto kilka kwestii, o których należy pamiętać, decydując się na korzystanie z trybu tła:
- Korzystanie z BLE w tle wiąże się z dodatkowym zużyciem baterii. Koszt jest niski, ale warto go zmierzyć przed podjęciem decyzji o użyciu trybu działania w tle.
- iOS poprosi użytkownika o zgodę na używanie lokalizacji w tle, jeśli skanowanie iBeacon jest włączone lub tryb oszczędzania baterii jest wyłączony.
Aby włączyć skanowanie sygnałów nawigacyjnych w tle, wykonaj te dodatkowe czynności:
Włącz tryb działania w tle dla subskrypcji, przekazując prawidłowo skonfigurowany obiekt
GNSBeaconStrategy. Poniższy fragment kodu pokazuje, jak to zrobić: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 }) })Dodaj wymagane wpisy do pliku
Info.plistaplikacji:UIBackgroundModeswpis:bluetooth-centraldo skanowania BLE w tle.locationdo skanowania iBeacon w tle w trybie wysokiej mocy. Możesz pominąć ten krok, jeśli skanujesz tylko w poszukiwaniu sygnałów z beaconów Eddystone w trybie niskiego zużycia energii.
NSLocationAlwaysUsageDescription– ciąg znaków opisujący, dlaczego będziesz śledzić lokalizację użytkownika w tle. Na przykład: „Twoja lokalizacja jest potrzebna do skanowania w poszukiwaniu sygnałów nawigacyjnych w tle”. Szczegółowe informacje znajdziesz w dokumentacji Apple. Możesz pominąć ten krok, jeśli skanujesz tylko w poszukiwaniu sygnałów nawigacyjnych Eddystone w trybie niskiego zużycia energii.
Czy użytkownik może włączyć lub wyłączyć skanowanie w tle w Twojej aplikacji? Jeśli tak, zapisz wartość trybu tła w
NSUserDefaults, ponieważ system iOS może w każdej chwili zamknąć aplikację, gdy działa ona w tle. Aplikacja powinna:- Zapisuj wartość trybu tła w
NSUserDefaults, gdy użytkownik ją zmieni. - Przy uruchamianiu odczytaj go z
NSUserDefaultsi przywróć subskrypcję sygnału, jeśli tryb działania w tle jest włączony.
- Zapisuj wartość trybu tła w
Powiadomienia w tle
Jeśli chcesz, aby aplikacja powiadamiała użytkownika o wykryciu beaconów, gdy działa w tle, możesz użyć powiadomień lokalnych. Więcej informacji znajdziesz w artykule o powiadomieniach w tle.