برنامه شما میتواند بااستفاده از همان سازوکاری که برای مشترک شدن در پیامهای منتشرشده توسط دیگر دستگاههای اطراف استفاده میشود، در پیامهای فانوس «بلوتوث کممصرف» (BLE) مشترک شود.
بهطور پیشفرض، اشتراکهای فانوس فقط زمانی کار میکنند که برنامهتان در پیشنما باشد. وقتی برنامهتان به پسزمینه میرود، اشتراکها بهطور خودکار اسکن کردن برای فانوسها را متوقف میکنند. برای جزئیات مربوط به نحوه فعال کردن اسکن پسزمینه، اسکن پسزمینه را ببینید.
برای مشترک شدن در فانوسها، پارامتر deviceTypesToDiscover را روی
kGNSDeviceBLEBeacon در پارامترهای اشتراک تنظیم کنید. قطعه کد زیر
نحوه انجام این کار را نشان میدهد:
آبجکتیو-سی
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
})
اشتراک بالا فقط فانوسهای متعلق به پروژه شما را پیدا میکند و همه پیامهای آن فانوسها را دریافت میکند. اگر میخواهید از فانوسهای ثبتشده با فضای نام متفاوت پیام دریافت کنید، میتوانید فضای نام را در پارامترهای اشتراک ارسال کنید. بهطور مشابه، اگر نوع خاصی از پیام را میخواهید، میتوانید نوع پیام را نیز برای فیلتر کردن ارسال کنید. قطعه کد زیر نحوه انجام این کار را نشان میدهد:
آبجکتیو-سی
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"
})
بهطور پیشفرض، اشتراک فانوس برای هر دو نوع فانوس Eddystone و iBeacon اسکن میکند. وقتی اسکن iBeacon فعال باشد، از کاربران خواسته میشود به برنامه اجازه دهند از دادههای مکان آنها استفاده کند. Info.plist برنامهتان باید
حاوی کلید NSLocationWhenInUseUsageDescription با توضیح کوتاهی درباره
دلیل استفاده از مکان باشد. برای جزئیات بیشتر،
مستندات Apple
را ببینید.
اگر میخواهید فقط برای Eddystone beacons اسکن کنید، میتوانید اسکن iBeacon را در GNSBeaconStrategy غیرفعال کنید و iOS از کاربر برای استفاده از مکان اجازه نخواهد خواست. قطعه کد زیر نشان میدهد که چگونه میتوان اسکن iBeacon را برای اشتراک اصلی بالا غیرفعال کرد:
آبجکتیو-سی
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
})
})
بهطور پیشفرض، اسکن کممصرف فعال است که گاهی اوقات میتواند منجر به تأخیرهای زیاد در یافتن Eddystone beacons شود. وقتی حالت کممصرف غیرفعال باشد، از اسکن iBeacon برای کمک به یافتن فانوسهای Eddystone استفاده میشود که میتواند این تأخیرها را کاهش دهد. بااینحال، این کار منجر به مصرف بیشتر باتری میشود و iOS از کاربر برای استفاده از مکان اجازه میخواهد.
قطعه کد زیر نشان میدهد که چگونه میتوان حالت کممصرف را هنگام اسکن برای فانوسهای Eddystone غیرفعال کرد.
آبجکتیو-سی
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
})
})
هنگام اسکن کردن iBeacons، کادر گفتگوی اجازه مکان iOS قبلاز کادر گفتگوی اجازه «اطراف» نشان داده میشود. اگر میخواهید این کادر گفتگو را لغو کنید (برای مثال، برای ارائه کادر گفتگوی «پیشپرواز» که توضیح میدهد چرا اجازه مکان لازم است)، permissionRequestHandler را روی یک بلوک سفارشی در پارامترهای اشتراک تنظیم کنید. تکهکد زیر نحوه انجام این کار را نشان میدهد:
آبجکتیو-سی
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);
}
})
اسکن پسزمینه
ازآنجاییکه اسکن فانوسک از BLE استفاده میکند، میتواند در پسزمینه کار کند. در اینجا چند نکته وجود دارد که باید هنگام تصمیمگیری برای استفاده از حالت پسزمینه از آنها آگاه باشید:
- برای BLE پسزمینه، هزینه باتری اضافه میشود. هزینه کم است، اما باید آن را قبلاز تصمیمگیری برای استفاده از حالت پسزمینه اندازهگیری کنید.
- اگر اسکن iBeacon فعال باشد یا حالت کممصرف غیرفعال باشد، iOS از کاربر برای استفاده از مکان در پسزمینه اجازه میخواهد.
برای فعال کردن اسکن فانوسک در پسزمینه، این مراحل اضافی را دنبال کنید:
با ارسال شیء
GNSBeaconStrategyکه بهدرستی پیکربندی شده است، حالت پسزمینه را برای اشتراکتان فعال کنید. قطعه کد زیر نحوه انجام این کار را نشان میدهد:آبجکتیو-سی
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 }) })ورودیهای لازم را به
Info.plistبرنامهتان اضافه کنید:
UIBackgroundModesورودی:bluetooth-centralبرای اسکن BLE در پسزمینه.locationبرای اسکن iBeacon در پسزمینه بااستفاده از حالت پرمصرف. اگر فقط برای Eddystone beacons اسکن کممصرف انجام میدهید، میتوانید این مورد را حذف کنید.
NSLocationAlwaysUsageDescriptionرشتهای که توضیح میدهد چرا مکان کاربر را در پسزمینه ردیابی میکنید. برای مثال، «برای اسکن کردن فرستندههای رادیویی در پسزمینه، به مکان شما نیاز است.» برای جزئیات بیشتر، مستندات Apple را ببینید. اگر اسکن کممصرف را فقط برای فانوسهای Eddystone انجام میدهید، میتوانید این مورد را حذف کنید.
آیا کاربر میتواند اسکن پسزمینه را در برنامهتان فعال یا غیرفعال کند؟ اگر اینطور است، باید مقدار حالت پسزمینه را در
NSUserDefaultsذخیره کنید زیرا iOS میتواند برنامهتان را در هر زمانی که در پسزمینه است متوقف کند. برنامه شما باید موارد زیر را انجام دهد:- هرگاه کاربر مقدار حالت پسزمینه را تغییر داد، آن را در
NSUserDefaultsذخیره کنید. - هنگام راهاندازی، آن را از
NSUserDefaultsبخوانید و اگر حالت پسزمینه فعال است، اشتراک فانوس را بازیابی کنید.
- هرگاه کاربر مقدار حالت پسزمینه را تغییر داد، آن را در
اعلانهای پسزمینه
اگر میخواهید برنامهتان وقتی فرستندههای بلوتوثی در پسزمینه پیدا میشوند به کاربر اطلاع دهد، میتوانید از اعلانهای محلی استفاده کنید. برای جزئیات، اعلانهای پسزمینه را ببینید.