Otrzymywanie obrazów typu beacon

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.plist aplikacji:

    • UIBackgroundModes wpis:

      • bluetooth-central do skanowania BLE w tle.
      • location do 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 NSUserDefaults i przywróć subskrypcję sygnału, jeśli tryb działania w tle jest włączony.

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.