האפליקציה יכולה להירשם להודעות ביקון של Bluetooth עם צריכת אנרגיה נמוכה (BLE) באמצעות אותו מנגנון שמשמש להרשמה להודעות שפורסמו על ידי מכשירים אחרים בקרבת מקום.
כברירת מחדל, מינויים ל-Beacon פועלים רק כשהאפליקציה בחזית. כשהאפליקציה עוברת לרקע, המינויים מפסיקים באופן אוטומטי לסרוק ביקונים. בקטע סריקה ברקע מוסבר איך להפעיל סריקה ברקע.
כדי להירשם למשואות, מגדירים את הפרמטר deviceTypesToDiscover לערך kGNSDeviceBLEBeacon בפרמטרים של המינוי. בקטע הקוד הבא אפשר לראות איך עושים את זה:
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
})
המינוי שלמעלה מגלה רק ביקונים שבבעלות הפרויקט שלכם, ומקבל את כל ההודעות מהביקונים האלה. אם אתם רוצים לקבל הודעות מבייקונים שרשומים במרחב שמות אחר, אתם יכולים להעביר מרחב שמות בפרמטרים של המינוי. באופן דומה, אם אתם רוצים סוג ספציפי של הודעה, אתם יכולים גם להעביר סוג הודעה לסינון. בקטע הקוד הבא אפשר לראות איך עושים את זה:
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"
})
כברירת מחדל, מינוי למשואת רשת (beacon) סורק את שני הסוגים של משואות הרשת (beacon), Eddystone ו-iBeacon. כשהסריקה של iBeacon מופעלת, המשתמשים מתבקשים לתת לאפליקציה הרשאה להשתמש בנתוני המיקום שלהם. הקובץ Info.plist של האפליקציה צריך לכלול את המפתח NSLocationWhenInUseUsageDescription עם הסבר קצר על הסיבה לשימוש במיקום. פרטים נוספים זמינים במאמרי העזרה של Apple.
אם רוצים לסרוק רק משואות Eddystone, אפשר להשבית את הסריקה של iBeacon ב-GNSBeaconStrategy, ומערכת iOS לא תבקש מהמשתמש הרשאה להשתמש במיקום. בקטע הקוד הבא אפשר לראות איך להשבית את הסריקה של iBeacon במינוי המקורי שלמעלה:
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
})
})
כברירת מחדל, מופעלת סריקה בצריכת חשמל נמוכה, שלפעמים יכולה לגרום לזמני אחזור ארוכים כשמחפשים ביקונים של Eddystone. כשהמצב חיסכון בסוללה מושבת, המכשיר משתמש בסריקת iBeacon כדי למצוא משואות Eddystone, מה שיכול להפחית את זמני האחזור האלה. עם זאת, זה מגדיל את השימוש בסוללה, ו-iOS תבקש מהמשתמש הרשאה להשתמש במיקום.
בקטע הקוד הבא אפשר לראות איך להשבית את מצב החיסכון בסוללה כשסורקים משואות 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
})
})
כשסורקים iBeacons, תיבת הדו-שיח של הרשאת המיקום ב-iOS מופיעה אחרי תיבת הדו-שיח של הרשאת "בסביבה". אם רוצים לשנות את תיבת הדו-שיח הזו (למשל, כדי לספק תיבת דו-שיח "לפני טיסה" שמסבירה למה צריך הרשאת מיקום), מגדירים את permissionRequestHandler לבלוק מותאם אישית בפרמטרים של המינוי. בקטע הקוד הבא אפשר לראות איך עושים את זה:
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);
}
})
סריקה ברקע
מכיוון שסריקת משואות משתמשת ב-BLE, היא יכולה לפעול ברקע. הנה כמה דברים שחשוב לדעת כשמחליטים להשתמש במצב רקע:
- השימוש ב-BLE ברקע צורך יותר סוללה. העלות נמוכה, אבל כדאי למדוד אותה לפני שמחליטים להשתמש במצב רקע.
- מערכת iOS תבקש מהמשתמש הרשאה להשתמש במיקום ברקע אם סריקת iBeacon מופעלת או אם מצב החיסכון בסוללה מושבת.
כדי להפעיל סריקת ביקונים ברקע, צריך לבצע את השלבים הנוספים הבאים:
כדי להפעיל את מצב הרקע במינוי, צריך להעביר אובייקט
GNSBeaconStrategyשהוגדר כראוי. בקטע הקוד הבא אפשר לראות איך עושים את זה: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 }) })מוסיפים את הרשומות הנדרשות לקובץ
Info.plistשל האפליקציה:
UIBackgroundModesערכים:-
bluetooth-centralלסריקת BLE ברקע. locationלסריקת iBeacon ברקע במצב צריכת חשמל גבוהה. אפשר להשמיט את זה אם מבצעים סריקה בצריכת חשמל נמוכה למשואות Eddystone בלבד.
-
מחרוזת
NSLocationAlwaysUsageDescriptionשמתארת למה אתם עוקבים אחרי מיקום המשתמש ברקע. לדוגמה, "המיקום שלך נדרש כדי לסרוק משואות ברקע". פרטים נוספים זמינים במאמרי העזרה של Apple. אפשר להשמיט את זה אם מבצעים סריקה בהספק נמוך למשואות Eddystone בלבד.
האם המשתמש יכול להפעיל או להשבית את הסריקה ברקע באפליקציה? אם כן, צריך לשמור את הערך של מצב הרקע ב-
NSUserDefaultsכי iOS יכולה לסגור את האפליקציה בכל שלב כשהיא פועלת ברקע. האפליקציה צריכה לבצע את הפעולות הבאות:- שומרים את הערך של מצב הרקע ב-
NSUserDefaultsבכל פעם שהמשתמש משנה אותו. - בזמן ההפעלה, קוראים אותו מ-
NSUserDefaultsומשחזרים את המינוי ל-Beacon אם מצב הרקע מופעל.
- שומרים את הערך של מצב הרקע ב-
התראות ברקע
אם אתם רוצים שהאפליקציה תודיע למשתמשים כשהיא מגלה ביקונים בזמן שהיא פועלת ברקע, אתם יכולים להשתמש בהתראות מקומיות. לפרטים נוספים, אפשר לעיין בקטע התראות ברקע.