دریافت پیام‌های نشان‌فرست

برنامه شما می‌تواند بااستفاده از همان سازوکاری که برای مشترک شدن در پیام‌های منتشرشده توسط دیگر دستگاه‌های اطراف استفاده می‌شود، در پیام‌های فانوس «بلوتوث کم‌مصرف» (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 بخوانید و اگر حالت پس‌زمینه فعال است، اشتراک فانوس را بازیابی کنید.

اعلان‌های پس‌زمینه

اگر می‌خواهید برنامه‌تان وقتی فرستنده‌های بلوتوثی در پس‌زمینه پیدا می‌شوند به کاربر اطلاع دهد، می‌توانید از اعلان‌های محلی استفاده کنید. برای جزئیات، اعلان‌های پس‌زمینه را ببینید.