Beacon-Nachrichten abrufen

Ihre App kann Beacon-Nachrichten über Bluetooth Low Energy (BLE) abonnieren. Dazu wird derselbe Mechanismus verwendet wie für das Abonnieren von Nachrichten, die von anderen Geräten in der Nähe veröffentlicht werden.

Standardmäßig funktionieren Beacon-Abos nur, wenn Ihre App im Vordergrund ausgeführt wird. Wenn die App in den Hintergrund wechselt, wird die Suche nach Beacons automatisch beendet. Weitere Informationen zum Aktivieren des Hintergrundscans finden Sie unter Hintergrundscan.

Wenn Sie Beacons abonnieren möchten, setzen Sie den Parameter deviceTypesToDiscover in den Aboparametern auf kGNSDeviceBLEBeacon. Das folgende Snippet zeigt, wie das geht:

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
    })

Mit dem obigen Abo werden nur Beacons erkannt, die zu Ihrem Projekt gehören, und alle Nachrichten von diesen Beacons empfangen. Wenn du Nachrichten von Beacons empfangen möchtest, die mit einem anderen Namespace registriert sind, kannst du einen Namespace in den Aboparametern übergeben. Wenn Sie einen bestimmten Nachrichtentyp wünschen, können Sie auch einen Nachrichtentyp zum Filtern übergeben. Das folgende Snippet zeigt, wie das geht:

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"
    })

Standardmäßig wird bei einem Beacon-Abo nach beiden Beacon-Typen gesucht, Eddystone und iBeacon. Wenn das iBeacon-Scanning aktiviert ist, werden Nutzer aufgefordert, der App die Berechtigung zur Verwendung ihrer Standortdaten zu erteilen. Die Info.plist-Datei Ihrer App muss den Schlüssel NSLocationWhenInUseUsageDescription mit einer kurzen Erklärung enthalten, warum der Standort verwendet wird. Weitere Informationen finden Sie in der Dokumentation von Apple.

Wenn Sie nur nach Eddystone-Beacons suchen möchten, können Sie das iBeacon-Scannen in der GNSBeaconStrategy deaktivieren. iOS fordert den Nutzer dann nicht auf, die Berechtigung zur Verwendung des Standorts zu erteilen. Das folgende Snippet zeigt, wie das iBeacon-Scannen für das ursprüngliche Abo oben deaktiviert wird:

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
          })
    })

Standardmäßig ist das Scannen mit geringem Energieverbrauch aktiviert. Das kann manchmal zu großen Latenzen beim Suchen von Eddystone-Beacons führen. Wenn der Energiesparmodus deaktiviert ist, wird die iBeacon-Suche verwendet, um Eddystone-Beacons zu finden. Dadurch können diese Latenzen reduziert werden. Dies führt jedoch zu einem höheren Akkuverbrauch und iOS bittet den Nutzer um die Erlaubnis, den Standort zu verwenden.

Das folgende Snippet zeigt, wie der Energiesparmodus beim Scannen nach Eddystone-Beacons deaktiviert wird.

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
          })
    })

Beim Scannen nach iBeacons wird vor dem iOS-Dialogfeld für die Berechtigung zur Standortermittlung das Dialogfeld für die Berechtigung zur Standortermittlung für Nearby angezeigt. Wenn Sie dieses Dialogfeld überschreiben möchten (z. B. um ein „Preflight“-Dialogfeld bereitzustellen, in dem erklärt wird, warum die Berechtigung zur Standortermittlung erforderlich ist), legen Sie in den Aboparametern für permissionRequestHandler einen benutzerdefinierten Block fest. Das folgende Snippet zeigt, wie das geht:

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);
      }
    })

Hintergrundscan

Da für das Beacon-Scanning BLE verwendet wird, kann es im Hintergrund ausgeführt werden. Hier sind einige Dinge, die Sie beachten sollten, wenn Sie sich für den Hintergrundmodus entscheiden:

  • Die Nutzung von BLE im Hintergrund verbraucht zusätzliche Akkuleistung. Die Kosten sind gering, aber Sie sollten sie messen, bevor Sie sich für den Hintergrundmodus entscheiden.
  • iOS bittet den Nutzer um die Erlaubnis, den Standort im Hintergrund zu verwenden, wenn das iBeacon-Scannen aktiviert oder der Energiesparmodus deaktiviert ist.

So aktivieren Sie das Scannen nach Beacons im Hintergrund:

  • Aktivieren Sie den Hintergrundmodus für Ihr Abo, indem Sie ein richtig konfiguriertes GNSBeaconStrategy-Objekt übergeben. Das folgende Snippet zeigt, wie das geht:

    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
              })
        })
    

  • Fügen Sie der Datei Info.plist Ihrer App die erforderlichen Einträge hinzu:

    • UIBackgroundModes Eintrag:

      • bluetooth-central für BLE-Scans im Hintergrund.
      • location für das iBeacon-Scannen im Hintergrund im Hochleistungsmodus. Sie können dies weglassen, wenn Sie nur nach Eddystone-Beacons mit geringem Stromverbrauch suchen.
    • NSLocationAlwaysUsageDescription-String, der beschreibt, warum Sie den Standort des Nutzers im Hintergrund erfassen. Beispiel: „Dein Standort wird benötigt, um im Hintergrund nach Beacons zu suchen.“ Weitere Informationen finden Sie in der Dokumentation von Apple. Sie können dies weglassen, wenn Sie nur nach Eddystone-Beacons mit geringem Stromverbrauch suchen.

  • Kann der Nutzer das Scannen im Hintergrund in Ihrer App aktivieren oder deaktivieren? In diesem Fall sollten Sie den Wert für den Hintergrundmodus in NSUserDefaults speichern, da iOS Ihre App jederzeit beenden kann, während sie im Hintergrund ausgeführt wird. Ihre App sollte Folgendes tun:

    • Speichere den Wert für den Hintergrundmodus in NSUserDefaults, wenn der Nutzer ihn ändert.
    • Beim Start wird sie aus NSUserDefaults gelesen und das Beacon-Abo wird wiederhergestellt, wenn der Hintergrundmodus aktiviert ist.

Hintergrundbenachrichtigungen

Wenn Sie möchten, dass Ihre App den Nutzer benachrichtigt, wenn Beacons im Hintergrund erkannt werden, können Sie lokale Benachrichtigungen verwenden. Weitere Informationen finden Sie unter Hintergrundbenachrichtigungen.