Uygulamanız, yakındaki cihazlar tarafından yayınlanan mesajlara abone olmak için kullanılan mekanizmanın aynısını kullanarak Bluetooth Düşük Enerji (BLE) işaretçi mesajlarına abone olabilir.
Varsayılan olarak, işaretçi abonelikleri yalnızca uygulamanız ön plandayken çalışır. Uygulamanız arka plana geçtiğinde abonelikler otomatik olarak işaretçi taramayı durdurur. Arka planda taramayı etkinleştirme hakkında ayrıntılı bilgi için Arka Planda Tarama bölümüne bakın.
İşaretçilere abone olmak için abonelik parametrelerinde deviceTypesToDiscover parametresini kGNSDeviceBLEBeacon olarak ayarlayın. Aşağıdaki snippet'te bunun nasıl yapılacağı gösterilmektedir:
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
})
Yukarıdaki abonelik yalnızca projenize ait işaretçileri bulur ve bu işaretçilerden gelen tüm mesajları alır. Farklı bir ad alanına kayıtlı işaretçilerden mesaj almak istiyorsanız abonelik parametrelerinde bir ad alanı iletebilirsiniz. Benzer şekilde, belirli bir mesaj türü istiyorsanız filtreleme için bir mesaj türü de iletebilirsiniz. Aşağıdaki snippet'te bunun nasıl yapılacağı gösterilmektedir:
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"
})
Varsayılan olarak, bir işaretçi aboneliği hem Eddystone hem de iBeacon işaretçi türlerini tarar. iBeacon taraması etkinleştirildiğinde kullanıcılardan, uygulamanın konum verilerini kullanmasına izin vermeleri istenir. Uygulamanızın Info.plist dosyasında, konumun neden kullanıldığına dair kısa bir açıklama içeren NSLocationWhenInUseUsageDescription anahtarı bulunmalıdır. Ayrıntılar için Apple'ın belgelerine bakın.
Yalnızca Eddystone işaretçilerini taramak istiyorsanız GNSBeaconStrategy içinde iBeacon taramasını devre dışı bırakabilirsiniz. Bu durumda iOS, kullanıcıdan konum kullanma izni istemez. Aşağıdaki snippet, yukarıdaki orijinal abonelik için iBeacon taramasının nasıl devre dışı bırakılacağını gösterir:
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
})
})
Varsayılan olarak, düşük güçte tarama etkindir. Bu durum bazen Eddystone işaretçileri bulunurken büyük gecikmelere neden olabilir. Düşük güç modu devre dışı bırakıldığında, Eddystone işaretçilerini bulmaya yardımcı olmak için iBeacon taraması kullanılır. Bu da gecikmeleri azaltabilir. Ancak bu durumda daha fazla pil kullanılır ve iOS, kullanıcıdan konum kullanma izni ister.
Aşağıdaki snippet, Eddystone işaretçileri taranırken düşük güç modunun nasıl devre dışı bırakılacağını gösterir.
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
})
})
iBeacon'lar taranırken iOS konum izni iletişim kutusundan önce Yakındakiler izni iletişim kutusu gösterilir. Bu iletişim kutusunu geçersiz kılmak istiyorsanız (örneğin, konum izninin neden gerekli olduğunu açıklayan bir "ön kontrol" iletişim kutusu sağlamak için) abonelik parametrelerinde permissionRequestHandler değerini özel bir blok olarak ayarlayın. Aşağıdaki snippet'te bunun nasıl yapılacağı gösterilmektedir:
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);
}
})
Arka Planda Tarama
BLE kullandığı için işaretçi tarama arka planda çalışabilir. Arka plan modunu kullanmaya karar verirken dikkat etmeniz gereken bazı noktalar şunlardır:
- Arka planda BLE kullanımı ek pil tüketimine neden olur. Maliyeti düşüktür ancak arka plan modunu kullanmaya karar vermeden önce ölçüm yapmanız gerekir.
- iBeacon taraması etkinleştirilmişse veya düşük güç modu devre dışı bırakılmışsa iOS, kullanıcıdan arka planda konum kullanma izni ister.
Arka planda işaretçi taramasını etkinleştirmek için aşağıdaki ek adımları uygulayın:
Doğru şekilde yapılandırılmış bir
GNSBeaconStrategynesnesi ileterek aboneliğiniz için arka plan modunu etkinleştirin. Aşağıdaki snippet'te bunun nasıl yapılacağı gösterilmektedir: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 }) })Uygulamanızın
Info.plistdosyasına gerekli girişleri ekleyin:UIBackgroundModesgiriş:- Arka planda BLE taraması için
bluetooth-central. - Yüksek güç modu kullanılarak arka planda iBeacon taraması için
location. Yalnızca Eddystone işaretçileri için düşük güçte tarama yapıyorsanız bunu atlayabilirsiniz.
- Arka planda BLE taraması için
Kullanıcının konumunu arka planda neden izleyeceğinizi açıklayan
NSLocationAlwaysUsageDescriptiondizesi. Örneğin, "Arka planda işaretçi taraması yapmak için konumunuza erişilmesi gerekiyor." Ayrıntılar için Apple'ın belgelerine bakın. Yalnızca Eddystone işaretçileri için düşük güçte tarama yapıyorsanız bunu atlayabilirsiniz.
Kullanıcı, uygulamanızda arka planda taramayı etkinleştirebilir veya devre dışı bırakabilir mi? Bu durumda, iOS arka plandayken uygulamanızı istediği zaman sonlandırabileceği için arka plan modu değerini
NSUserDefaultsolarak kaydetmeniz gerekir. Uygulamanız şunları yapmalıdır:- Kullanıcı her değiştirdiğinde arka plan modu değerini
NSUserDefaultsolarak kaydedin. - Başlangıçta
NSUserDefaultskaynağından okuyun ve arka plan modu etkinse işaretçi aboneliğini geri yükleyin.
- Kullanıcı her değiştirdiğinde arka plan modu değerini
Arka Plan Bildirimleri
Uygulamanızın, arka plandayken işaretçiler keşfedildiğinde kullanıcıyı bilgilendirmesini istiyorsanız yerel bildirimleri kullanabilirsiniz. Ayrıntılar için arka plan bildirimleri bölümünü inceleyin.