Beacon মেসেজ পাওয়া

আপনার অ্যাপ ব্লুটুথ লো এনার্জি (BLE) বিকন মেসেজ সাবস্ক্রাইব করতে পারে। এর জন্য একই মেকানিজম ব্যবহার করা হয় যা আশেপাশের অন্যান্য ডিভাইসের মাধ্যমে প্রকাশিত মেসেজ সাবস্ক্রাইব করার জন্য ব্যবহার করা হয়।

ডিফল্ট হিসেবে, আপনার অ্যাপ ফোরগ্রাউন্ডে থাকলে তবেই বিকন সাবস্ক্রিপশন কাজ করে। আপনার অ্যাপ ব্যাকগ্রাউন্ডে চলে গেলে, সাবস্ক্রিপশন অটোমেটিক বিকন স্ক্যান করা বন্ধ করে দেয়। ব্যাকগ্রাউন্ড স্ক্যানিং কীভাবে চালু করতে হয় সেই সম্পর্কে বিস্তারিত জানতে, ব্যাকগ্রাউন্ড স্ক্যানিং দেখুন।

বিকন সাবস্ক্রাইব করতে, সাবস্ক্রিপশন প্যারামিটারে 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 বিকন খুঁজতে অনেক বেশি সময় লাগতে পারে। কম পাওয়ার মোড বন্ধ করা থাকলে, 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-এর জন্য অতিরিক্ত ব্যাটারি খরচ হয়। খরচ কম, তবে ব্যাকগ্রাউন্ড মোড ব্যবহার করার সিদ্ধান্ত নেওয়ার আগে আপনাকে এটি পরিমাপ করতে হবে।
  • 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টি এন্ট্রি:

      • ব্যাকগ্রাউন্ডে BLE স্ক্যান করার জন্য bluetooth-central।
      • হাই-পাওয়ার মোড ব্যবহার করে ব্যাকগ্রাউন্ডে iBeacon স্ক্যান করার জন্য location। আপনি যদি শুধুমাত্র Eddystone বিকনের জন্য কম পাওয়ার স্ক্যানিং করেন, তাহলে এটি বাদ দিতে পারেন।
    • NSLocationAlwaysUsageDescription স্ট্রিং, যেখানে আপনি কেন ব্যাকগ্রাউন্ডে ব্যবহারকারীর লোকেশন ট্র্যাক করবেন তার বিবরণ দেওয়া আছে। যেমন, "ব্যাকগ্রাউন্ডে বিকন স্ক্যান করার জন্য আপনার লোকেশন প্রয়োজন।" বিস্তারিত জানতে Apple-এর ডকুমেন্টেশন দেখুন। আপনি যদি শুধুমাত্র Eddystone বিকনের জন্য কম পাওয়ার স্ক্যানিং করেন, তাহলে এটি বাদ দিতে পারেন।

  • ব্যবহারকারী কি আপনার অ্যাপে ব্যাকগ্রাউন্ড স্ক্যানিং চালু বা বন্ধ করতে পারবেন? যদি তাই হয়, তাহলে আপনাকে ব্যাকগ্রাউন্ড মোডের ভ্যালু NSUserDefaults-এ সেভ করতে হবে কারণ ব্যাকগ্রাউন্ডে থাকাকালীন iOS যেকোনও সময় আপনার অ্যাপ বন্ধ করে দিতে পারে। আপনার অ্যাপকে নিম্নলিখিত কাজগুলি করতে হবে:

    • ব্যবহারকারী ব্যাকগ্রাউন্ড মোড পরিবর্তন করলেই, ব্যাকগ্রাউন্ড মোড ভ্যালু NSUserDefaults-এ সেভ করুন।
    • স্টার্ট-আপের সময়, NSUserDefaults থেকে এটি পড়ুন এবং ব্যাকগ্রাউন্ড মোড চালু থাকলে বিকন সাবস্ক্রিপশন রিস্টোর করুন।

ব্যাকগ্রাউন্ড বিজ্ঞপ্তি

ব্যাকগ্রাউন্ডে থাকাকালীন আপনার অ্যাপ যদি ব্যবহারকারীকে বিকন খুঁজে পাওয়ার ব্যাপারে বিজ্ঞপ্তি পাঠাতে চায়, তাহলে আপনি স্থানীয় বিজ্ঞপ্তি ব্যবহার করতে পারেন। বিস্তারিত জানতে, ব্যাকগ্রাউন্ড বিজ্ঞপ্তি দেখুন।