קבלת הודעות ב-Beacon

האפליקציה יכולה להירשם להודעות ביקון של 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 אם מצב הרקע מופעל.

התראות ברקע

אם אתם רוצים שהאפליקציה תודיע למשתמשים כשהיא מגלה ביקונים בזמן שהיא פועלת ברקע, אתם יכולים להשתמש בהתראות מקומיות. לפרטים נוספים, אפשר לעיין בקטע התראות ברקע.