RangeBeacons

Retorna uma lista de iBeacons e a proximidade deles para um dispositivo iOS ou iPadOS.

Formato 

RangeBeacons ( UUID {; tempo-limite ; principal ; secundária } )

Parâmetros 

UUID - o identificador universalmente exclusivo para iBeacons a serem pesquisados. O UUID identifica um ou mais iBeacons como um tipo específico ou de uma organização específica. Por exemplo, os iBeacons para todas as filiais de uma loja de departamento poderiam compartilhar o mesmo UUID.

tempo-limite - o número de segundos para aguardar antes de retornar um valor. Se tempo-limite não for especificado, a função retornará um valor após cinco segundos.

principal - o valor que identifica um grupo de iBeacons. Por exemplo, todos os iBeacons em uma filial específica de uma loja de departamento poderiam compartilhar o mesmo valor principal.

secundária - o valor que identifica iBeacons específicos dentro de um grupo de iBeacons. Por exemplo, todos os iBeacons na seção de brinquedos de uma filial específica de uma loja de departamento poderiam compartilhar o mesmo valor secundário.

Os parâmetros entre chaves { } são opcionais.

Tipo de dados retornado 

Texto

Originada na versão 

15.0

Descrição 

No FileMaker Go, retorna:

UUID - o identificador universalmente exclusivo para cada iBeacon identificado.

principal - o valor que identifica um grupo de iBeacons.

secundária - o valor que identifica iBeacons específicos dentro de um grupo de iBeacons.

proximidade - um número que indica a proximidade relativa a um iBeacon. Retorna:

  • 0 (Desconhecido) A proximidade do iBeacon não pôde ser determinada.
  • 1 (Imediato) O iBeacon está muito próximo do dispositivo.
  • 2 (Próximo) O iBeacon está relativamente próximo do dispositivo.
  • 3 (Longe) O iBeacon está longe do dispositivo.

precisão - a precisão do valor de proximidade, medido em metros a partir do iBeacon. Esse valor ajuda a diferenciar entre iBeacons com o mesmo valor de proximidade. Um valor negativo significa que a precisão não pôde ser determinada.

rssi - a intensidade do sinal recebida dos iBeacons, medida em decibéis.

Notas 

  • Se nenhum iBeacon corresponder aos critérios, essa função retornará uma cadeia vazia.
  • Se o ajuste de Serviços de Localização estiver desativado, essa função retornará uma cadeia vazia.
  • Se a consulta não for válida, essa função retornará um ponto de interrogação (?).

Exemplo 1 

RangeBeacons("D9B9EC1F-XXXX-YYYY-80A9-1E39D4CEA95C") retorna informações sobre todos os iBeacons próximos com o UUID especificado:

D9B9EC1F-XXXX-YYYY-80A9-1E39D4CEA95C, 10, 1, 0, -1.00, 0
D9B9EC1F-XXXX-YYYY-80A9-1E39D4CEA95C, 5, 1, 3, 14.68, -79
D9B9EC1F-XXXX-YYYY-80A9-1E39D4CEA95C, 5, 2, 3, 18.96, -81

Exemplo 2 

RangeBeacons("D9B9EC1F-XXXX-YYYY-80A9-1E39D4CEA95C"; 30) retorna o resultado após 30 segundos.

Exemplo 3 

RangeBeacons("D9B9EC1F-XXXX-YYYY-80A9-1E39D4CEA95C"; 20; 10; 1) retorna informações sobre iBeacons com o UUID especificado com um valor de principal de 10 e um valor de secundária de 1. Retorna o resultado após 20 segundos.

Tópicos relacionados