ビーコン メッセージを受信する

アプリは、近くにある他のデバイスによって公開されたメッセージをサブスクライブするのと同じメカニズムを使用して、Bluetooth Low Energy(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
          })
    })

iBeacon をスキャンする場合、iOS の位置情報の利用許可ダイアログの前に、Nearby の権限ダイアログが表示されます。このダイアログをオーバーライドする場合(位置情報の利用許可が必要な理由を説明する「プリフライト」ダイアログを表示する場合など)は、サブスクリプション パラメータで 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。
      • location: ハイパワー モードを使用してバックグラウンドで iBeacon をスキャンします。 Eddystone ビーコンのみを対象に低電力スキャンを行う場合は、この権限を省略できます。
    • NSLocationAlwaysUsageDescription 文字列。バックグラウンドでユーザーの位置情報を追跡する理由を説明します。たとえば、「バックグラウンドでビーコンをスキャンするには、位置情報が必要です」などです。詳しくは、Apple のドキュメントをご覧ください。Eddystone ビーコンのみを対象に低電力スキャンを行う場合は、この権限を省略できます。

  • ユーザーはアプリでバックグラウンド スキャンを有効または無効にできますか?その場合は、iOS がバックグラウンドでアプリをいつでも強制終了できるため、バックグラウンド モードの値を NSUserDefaults に保存する必要があります。アプリは次の処理を行う必要があります。

    • ユーザーがバックグラウンド モードの値を変更するたびに、その値を NSUserDefaults に保存します。
    • 起動時に、NSUserDefaults から読み取り、バックグラウンド モードが有効になっている場合はビーコン サブスクリプションを復元します。

バックグラウンド通知

バックグラウンドでビーコンが検出されたときにアプリがユーザーに通知するようにするには、ローカル通知を使用します。詳細については、バックグラウンド通知をご覧ください。