Aplikasi Anda dapat berlangganan pesan beacon Bluetooth Hemat Energi (BLE) menggunakan mekanisme yang sama yang digunakan untuk berlangganan pesan yang dipublikasikan oleh perangkat lain di sekitar.
Secara default, langganan beacon hanya berfungsi saat aplikasi berada di latar depan. Saat aplikasi beralih ke latar belakang, langganan akan otomatis berhenti memindai beacon. Lihat Pemindaian Latar Belakang untuk mengetahui detail cara mengaktifkan pemindaian latar belakang.
Untuk berlangganan beacon, tetapkan parameter deviceTypesToDiscover
ke
kGNSDeviceBLEBeacon
pada parameter langganan. Cuplikan berikut
menunjukkan cara melakukannya:
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
})
Langganan di atas hanya menemukan beacon yang dimiliki project Anda, dan menerima semua pesan dari beacon tersebut. Jika ingin menerima pesan dari beacon yang terdaftar dengan namespace berbeda, Anda dapat meneruskan namespace dalam parameter langganan. Demikian pula, jika menginginkan jenis pesan tertentu, Anda juga dapat meneruskan jenis pesan untuk pemfilteran. Cuplikan berikut menunjukkan cara melakukan hal ini:
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"
})
Secara default, langganan beacon memindai jenis beacon, Eddystone dan
iBeacon. Saat pemindaian iBeacon diaktifkan, pengguna akan diminta untuk memberikan
izin bagi aplikasi untuk menggunakan data lokasi mereka. Info.plist
aplikasi Anda harus
menyertakan kunci NSLocationWhenInUseUsageDescription
dengan penjelasan singkat tentang
alasan lokasi digunakan. Baca dokumentasi Apple untuk mengetahui detailnya.
Jika Anda hanya ingin memindai beacon Eddystone, Anda dapat menonaktifkan pemindaian iBeacon di GNSBeaconStrategy
, dan iOS tidak akan meminta izin pengguna untuk menggunakan lokasi. Cuplikan berikut menunjukkan cara menonaktifkan pemindaian iBeacon
untuk langganan asli di atas:
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
})
})
Secara default, pemindaian daya rendah diaktifkan, yang terkadang dapat menyebabkan latensi yang besar saat menemukan beacon Eddystone. Saat mode daya rendah dinonaktifkan, pemindaian iBeacon akan digunakan untuk membantu menemukan beacon Eddystone, yang dapat mengurangi latensi ini. Namun, hal ini akan menyebabkan penggunaan baterai yang lebih besar, dan iOS akan meminta izin pengguna untuk menggunakan lokasi.
Cuplikan berikut menunjukkan cara menonaktifkan mode daya rendah saat memindai beacon 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
})
})
Saat memindai iBeacons, dialog izin akses lokasi iOS didahului dengan dialog Izin terdekat. Jika Anda ingin mengganti dialog ini (misalnya, untuk memberikan dialog "preflight" yang menjelaskan alasan izin akses lokasi
diperlukan), setel permissionRequestHandler
ke blok kustom dalam
parameter langganan. Cuplikan berikut menunjukkan cara melakukannya:
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);
}
})
Pemindaian Latar Belakang
Karena pemindaian beacon menggunakan BLE, pemindaian dapat berjalan di latar belakang. Berikut adalah beberapa hal yang harus Anda perhatikan saat memutuskan untuk menggunakan mode latar belakang:
- Ada biaya baterai tambahan untuk BLE latar belakang. Biayanya rendah, tetapi Anda harus mengukurnya sebelum memutuskan untuk menggunakan mode latar belakang.
- iOS akan meminta izin pengguna untuk menggunakan lokasi di latar belakang jika pemindaian iBeacon diaktifkan atau mode daya rendah dinonaktifkan.
Untuk mengaktifkan pemindaian beacon di latar belakang, ikuti langkah-langkah tambahan ini:
Aktifkan mode latar belakang untuk langganan Anda dengan meneruskan objek
GNSBeaconStrategy
yang dikonfigurasi dengan benar. Cuplikan berikut menunjukkan cara melakukannya: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 }) })
Tambahkan entri yang diperlukan ke
Info.plist
aplikasi Anda:Entri
UIBackgroundModes
:bluetooth-central
untuk pemindaian BLE di latar belakang.location
untuk pemindaian iBeacon di latar belakang menggunakan mode daya tinggi. Anda dapat menghilangkannya jika melakukan pemindaian daya rendah hanya untuk beacon Eddystone.
String
NSLocationAlwaysUsageDescription
yang menjelaskan alasan Anda akan melacak lokasi pengguna di latar belakang. Misalnya, "Lokasi Anda perlu memindai beacon di latar belakang". Baca dokumentasi Apple untuk mengetahui detailnya. Anda dapat menghilangkannya jika melakukan pemindaian daya rendah hanya untuk beacon Eddystone.
Dapatkah pengguna mengaktifkan atau menonaktifkan pemindaian latar belakang di aplikasi Anda? Jika demikian, Anda harus menyimpan nilai mode latar belakang ke
NSUserDefaults
karena iOS dapat menghentikan aplikasi Anda kapan saja saat berada di latar belakang. Aplikasi Anda harus melakukan hal berikut:- Simpan nilai mode latar belakang ke
NSUserDefaults
setiap kali pengguna mengubahnya. - Saat memulai, baca dari
NSUserDefaults
dan pulihkan langganan beacon jika mode latar belakang diaktifkan.
- Simpan nilai mode latar belakang ke
Notifikasi Latar Belakang
Jika ingin aplikasi memberi tahu pengguna saat beacon ditemukan saat berada di latar belakang, Anda dapat menggunakan notifikasi lokal. Untuk mengetahui detailnya, lihat notifikasi latar belakang.