Verificar a disponibilidade do VPS no local atual do dispositivo

A API Geospatial usa uma combinação de dados de VPS e GPS para gerar poses geoespaciais de alta precisão. A API pode ser usada em qualquer lugar onde o dispositivo possa determinar a localização:

  • Em áreas com baixa precisão de GPS, como espaços internos e ambientes urbanos densos, a API vai usar a cobertura de VPS para gerar poses de alta precisão.
  • Em ambientes externos com poucas ou nenhuma obstrução aérea, a API Geospatial pode usar os dados de localização de GPS disponíveis para gerar poses geoespaciais com alta precisão.

Você pode determinar a disponibilidade do VPS em uma determinada posição horizontal antes do início da sessão de RA e usá-la para criar experiências mais específicas, por exemplo, para apresentar um botão "Enter AR" somente quando o VPS estiver disponível.

Ativar a API ARCore

Seu app precisa ativar a API ARCore para verificar a disponibilidade do VPS.

Quando a API ARCore for ativada, você vai poder verificar a disponibilidade do VPS sem:

Verificar a disponibilidade de VPS no seu app

A API Geospatial pode ser usada em qualquer lugar em que o dispositivo possa determinar a própria localização. Se a experiência de RA depender da cobertura do VPS, você poderá usar o Session.checkVpsAvailabilityAsync() para acessar uma VpsAvailabilityFuture, uma tarefa assíncrona que verifica a disponibilidade do VPS em uma determinada posição horizontal. Quando tiver o VpsAvailabilityFuture, você poderá conferir o resultado pesquisando ou com um callback.

Pesquisar o resultado

Use Future.getState() para ver o estado da Future. Há três estados diferentes:

Continue verificando Future.getState() até que a tarefa seja concluída.

Java

// Obtain a VpsAvailabilityFuture and store it somewhere.
VpsAvailabilityFuture future = session.checkVpsAvailabilityAsync(latitude, longitude, null);

// Poll VpsAvailabilityFuture later, for example, in a render loop.
if (future.getState() == FutureState.DONE) {
  switch (future.getResult()) {
    case AVAILABLE:
      // VPS is available at this location.
      break;
    case UNAVAILABLE:
      // VPS is unavailable at this location.
      break;
    case ERROR_NETWORK_CONNECTION:
      // The external service could not be reached due to a network connection error.
      break;

      // Handle other error states, e.g. ERROR_RESOURCE_EXHAUSTED, ERROR_INTERNAL, ...
  }
}

Kotlin

// Obtain a VpsAvailabilityFuture and store it somewhere.
val future = session.checkVpsAvailabilityAsync(latitude, longitude, null)

// Poll VpsAvailabilityFuture later, for example, in a render loop.
if (future.state == FutureState.DONE) {
  when (future.result) {
    VpsAvailability.AVAILABLE -> {
      // VPS is available at this location.
    }
    VpsAvailability.UNAVAILABLE -> {
      // VPS is unavailable at this location.
    }
    VpsAvailability.ERROR_NETWORK_CONNECTION -> {
      // The external service could not be reached due to a network connection error.
    }
    else -> {
      TODO("Handle other error states, e.g. ERROR_RESOURCE_EXHAUSTED, ERROR_INTERNAL, ...")
    }
  }
}

Receber o resultado usando um callback

Também é possível receber o resultado de um Future usando um callback. Use Session.checkVpsAvailabilityAsync() e forneça um callback. Esse callback será chamado na linha de execução principal logo depois que Future ficar com o estado DONE.

Java

session.checkVpsAvailabilityAsync(
    latitude,
    longitude,
    result -> {
      // Callback is called on the Main thread.
      switch (result) {
          // Handle the VpsAvailability result as shown above.
          // For example, show UI that enables your AR view.
      }
    });

Kotlin

session.checkVpsAvailabilityAsync(latitude, longitude) { result ->
  // Callback is called on the Main thread.

  // Handle the VpsAvailability result as shown above.
  // For example, show UI that enables your AR view.
  TODO("Handle VpsAvailability " + result)
}

Cancelar o Future

Use Future.cancel() para tentar cancelar o Future. Devido ao paralelismo de linhas de execução, pode ser que sua tentativa de cancelamento não tenha êxito. Future.cancel() vai retornar true se essa tentativa for bem-sucedida. Caso contrário, retornará false.

Usar a API Geospatial sem cobertura de VPS

A API Geospatial também pode ser usada em áreas que não têm cobertura de VPS. Em ambientes ao ar livre com pouca ou nenhuma obstrução aérea, o GPS pode ser suficiente para gerar uma pose com alta precisão.

A seguir