取得信標訊息

您的應用程式可以訂閱藍牙低功耗 (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 位置存取權對話方塊。如要覆寫這個對話方塊 (例如提供「預檢」對話方塊,說明為何需要位置存取權),請在訂閱參數中將 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 信標進行低功耗掃描,則可省略此步驟。

  • 使用者是否可以在應用程式中啟用或停用背景掃描功能?如果是,請將背景模式值儲存至 NSUserDefaults,因為 iOS 可能隨時會終止在背景執行的應用程式。應用程式應執行下列操作:

    • 每當使用者變更背景模式值時,請將該值儲存至 NSUserDefaults。
    • 啟動時,從 NSUserDefaults 讀取,並在啟用背景模式時還原信標訂閱。

背景通知

如果想讓應用程式在背景偵測到信標時通知使用者,可以使用本機通知。詳情請參閱背景通知。