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.plistIhrer App die erforderlichen Einträge hinzu:UIBackgroundModesEintrag:bluetooth-centralfür BLE-Scans im Hintergrund.locationfü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
NSUserDefaultsspeichern, 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
NSUserDefaultsgelesen und das Beacon-Abo wird wiederhergestellt, wenn der Hintergrundmodus aktiviert ist.
- Speichere den Wert für den Hintergrundmodus in
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.