बीकन मैसेज पाएं

आपका ऐप्लिकेशन, ब्लूटूथ लो एनर्जी (बीएलई) बीकन मैसेज की सदस्यता ले सकता है. इसके लिए, उसी तरीके का इस्तेमाल किया जाता है जिसका इस्तेमाल आस-पास के अन्य डिवाइसों से पब्लिश किए गए मैसेज की सदस्यता लेने के लिए किया जाता है.

डिफ़ॉल्ट रूप से, बीकन की सदस्यताएं सिर्फ़ तब काम करती हैं, जब आपका ऐप्लिकेशन फ़ोरग्राउंड में हो. जब आपका ऐप्लिकेशन बैकग्राउंड में चला जाता है, तो सदस्यताएं अपने-आप बीकन को स्कैन करना बंद कर देती हैं. बैकग्राउंड स्कैनिंग को चालू करने के तरीके के बारे में जानने के लिए, बैकग्राउंड स्कैनिंग देखें.

बीकन की सदस्यता लेने के लिए, सदस्यता के पैरामीटर में 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"
    })

डिफ़ॉल्ट रूप से, बीकन की सदस्यता, Eddystone और iBeacon, दोनों तरह के बीकन को स्कैन करती है. iBeacon स्कैनिंग की सुविधा चालू होने पर, उपयोगकर्ताओं से ऐप्लिकेशन को उनकी जगह की जानकारी का डेटा इस्तेमाल करने की अनुमति देने के लिए कहा जाएगा. आपके ऐप्लिकेशन के Info.plist में NSLocationWhenInUseUsageDescription कुंजी शामिल होनी चाहिए. साथ ही, इसमें कम शब्दों में यह जानकारी होनी चाहिए कि जगह की जानकारी का इस्तेमाल क्यों किया जा रहा है. ज़्यादा जानकारी के लिए, Apple का दस्तावेज़ देखें.

अगर आपको सिर्फ़ Eddystone बीकन स्कैन करने हैं, तो GNSBeaconStrategy में iBeacon स्कैनिंग की सुविधा बंद की जा सकती है. इसके बाद, 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 बीकन ढूंढने में ज़्यादा समय लग सकता है. बैटरी बचाने वाला मोड बंद होने पर, Eddystone बीकन ढूंढने के लिए iBeacon स्कैनिंग का इस्तेमाल किया जाता है. इससे इंतज़ार के समय को कम किया जा सकता है. हालांकि, इससे बैटरी ज़्यादा खर्च होती है. साथ ही, 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);
      }
    })

बैकग्राउंड में स्कैनिंग

बीकन स्कैनिंग के लिए बीएलई का इस्तेमाल किया जाता है. इसलिए, यह बैकग्राउंड में काम कर सकता है. बैकग्राउंड मोड का इस्तेमाल करने से पहले, आपको इन बातों का ध्यान रखना चाहिए:

  • बैकग्राउंड में बीएलई का इस्तेमाल करने पर, बैटरी ज़्यादा खर्च होती है. इसकी लागत कम है, लेकिन बैकग्राउंड मोड का इस्तेमाल करने का फ़ैसला लेने से पहले, आपको इसकी लागत का आकलन करना चाहिए.
  • अगर iBeacon स्कैनिंग चालू है या बैटरी बचाने वाला मोड बंद है, तो iOS उपयोगकर्ता से बैकग्राउंड में जगह की जानकारी इस्तेमाल करने की अनुमति मांगेगा.

बैकग्राउंड में बीकन स्कैनिंग की सुविधा चालू करने के लिए, यह तरीका अपनाएं:

  • अपनी सदस्यता के लिए बैकग्राउंड मोड चालू करें. इसके लिए, सही तरीके से कॉन्फ़िगर किया गया 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, ताकि बैकग्राउंड में बीएलई स्कैनिंग की जा सके.
      • location, हाई-पावर मोड का इस्तेमाल करके बैकग्राउंड में iBeacon स्कैनिंग के लिए. अगर सिर्फ़ Eddystone बीकन के लिए कम पावर वाली स्कैनिंग की जा रही है, तो इसे छोड़ा जा सकता है.
    • NSLocationAlwaysUsageDescription स्ट्रिंग, जिसमें यह बताया गया हो कि बैकग्राउंड में उपयोगकर्ता की जगह की जानकारी को क्यों ट्रैक किया जाएगा. उदाहरण के लिए, "बैकग्राउंड में बीकन स्कैन करने के लिए, आपकी जगह की जानकारी की ज़रूरत है." ज़्यादा जानकारी के लिए, Apple का दस्तावेज़ देखें. अगर आपको सिर्फ़ Eddystone बीकन के लिए कम पावर वाली स्कैनिंग करनी है, तो इसे छोड़ा जा सकता है.

  • क्या उपयोगकर्ता आपके ऐप्लिकेशन में, बैकग्राउंड में स्कैन करने की सुविधा को चालू या बंद कर सकता है? अगर ऐसा है, तो आपको बैकग्राउंड मोड की वैल्यू को NSUserDefaults पर सेव करना चाहिए. ऐसा इसलिए, क्योंकि iOS आपके ऐप्लिकेशन को बैकग्राउंड में चलने के दौरान कभी भी बंद कर सकता है. आपके ऐप्लिकेशन को ये काम करने चाहिए:

    • जब भी उपयोगकर्ता बैकग्राउंड मोड की वैल्यू बदले, तो उसे NSUserDefaults पर सेव करें.
    • स्टार्टअप पर, इसे NSUserDefaults से पढ़ें और अगर बैकग्राउंड मोड चालू है, तो बीकन की सदस्यता को वापस लाएं.

बैकग्राउंड में सूचनाएं पाने की सुविधा

अगर आपको अपने ऐप्लिकेशन से उपयोगकर्ता को सूचना देनी है कि बैकग्राउंड में बीकन खोजे गए हैं, तो स्थानीय सूचनाओं का इस्तेमाल किया जा सकता है. ज़्यादा जानकारी के लिए, बैकग्राउंड में सूचनाएं देखें.