Seu app pode se inscrever em mensagens de beacon do Bluetooth de baixa energia (BLE) usando o mesmo mecanismo usado para se inscrever em mensagens publicadas por outros dispositivos por perto.
Por padrão, as inscrições de beacons só funcionam quando o app está em primeiro plano. Quando o app passa para o segundo plano, as assinaturas interrompem automaticamente a busca por beacons. Consulte Verificação em segundo plano para saber como ativar esse recurso.
Para se inscrever em beacons, defina o parâmetro deviceTypesToDiscover como kGNSDeviceBLEBeacon nos parâmetros de inscrição. O snippet a seguir
demonstra como fazer isso:
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
})
A assinatura acima descobre apenas beacons que pertencem ao seu projeto e recebe todas as mensagens deles. Se você quiser receber mensagens de beacons registrados com um namespace diferente, transmita um namespace nos parâmetros de inscrição. Da mesma forma, se você quiser um tipo específico de mensagem, também poderá transmitir um tipo de mensagem para filtragem. O snippet a seguir mostra como fazer isso:
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"
})
Por padrão, uma inscrição de beacon procura os dois tipos de beacons, Eddystone e
iBeacon. Quando a verificação do iBeacon está ativada, os usuários precisam dar
permissão para que o app use os dados de local deles. O Info.plist do app precisa
incluir a chave NSLocationWhenInUseUsageDescription com uma breve explicação do
motivo de uso da localização. Consulte a
documentação da Apple
para mais detalhes.
Se você quiser procurar apenas beacons Eddystone, desative a verificação de iBeacon no GNSBeaconStrategy. Assim, o iOS não vai pedir permissão ao usuário para usar a localização. O snippet a seguir mostra como desativar a verificação de iBeacon
para a assinatura original acima:
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
})
})
Por padrão, a verificação de baixa energia é ativada, o que às vezes pode resultar em grandes latências ao encontrar beacons Eddystone. Quando o modo de baixo consumo está desativado, a verificação do iBeacon é usada para ajudar a encontrar beacons Eddystone, o que pode reduzir essas latências. No entanto, isso resulta em um maior uso da bateria, e o iOS vai pedir ao usuário permissão para usar a localização.
O snippet a seguir mostra como desativar o modo de baixo consumo ao procurar beacons 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
})
})
Ao procurar iBeacons, a caixa de diálogo de permissão de localização do iOS é precedida pela
caixa de diálogo de permissão do Nearby. Se você quiser substituir essa caixa de diálogo (por
exemplo, para fornecer uma caixa de diálogo de "pré-verificação" que explique por que a permissão de localização
é necessária), defina permissionRequestHandler como um bloco personalizado nos
parâmetros de assinatura. O snippet a seguir mostra como fazer isso:
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);
}
})
Verificação em segundo plano
Como a verificação de beacons usa BLE, ela pode funcionar em segundo plano. Confira alguns pontos que você precisa considerar ao decidir usar o modo em segundo plano:
- Há um custo adicional de bateria para o BLE em segundo plano. O custo é baixo, mas você precisa medi-lo antes de decidir usar o modo em segundo plano.
- O iOS vai pedir permissão ao usuário para usar a localização em segundo plano se a busca por iBeacon estiver ativada ou se o modo de baixo consumo estiver desativado.
Para ativar a verificação de beacons em segundo plano, siga estas etapas:
Ative o modo em segundo plano para sua assinatura transmitindo um objeto
GNSBeaconStrategyconfigurado corretamente. O snippet a seguir mostra como fazer isso: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 }) })Adicione as entradas necessárias ao
Info.plistdo app:UIBackgroundModesentradas:bluetooth-centralpara verificação de BLE em segundo plano.locationpara verificação de iBeacon em segundo plano usando o modo de alta potência. É possível omitir isso se você estiver fazendo uma verificação de baixa energia apenas para beacons Eddystone.
String
NSLocationAlwaysUsageDescriptionque descreve por que você vai rastrear a localização do usuário em segundo plano. Por exemplo, "Sua localização é necessária para buscar beacons em segundo plano". Consulte a documentação da Apple para mais detalhes. É possível omitir isso se você estiver fazendo uma verificação de baixa energia apenas para beacons Eddystone.
O usuário pode ativar ou desativar a verificação em segundo plano no seu app? Se sim, salve o valor do modo de segundo plano em
NSUserDefaults, porque o iOS pode encerrar o app a qualquer momento enquanto ele estiver em segundo plano. O app precisa fazer o seguinte:- Salve o valor do modo de segundo plano em
NSUserDefaultssempre que o usuário o alterar. - Na inicialização, leia-o em
NSUserDefaultse restaure a inscrição do beacon se o modo de segundo plano estiver ativado.
- Salve o valor do modo de segundo plano em
Notificações em segundo plano
Se você quiser que o app notifique o usuário quando beacons forem descobertos em segundo plano, use notificações locais. Para mais detalhes, consulte notificações em segundo plano.