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 ArSession_checkVpsAvailabilityAsync() para acessar uma ArVpsAvailabilityFuture, uma tarefa assíncrona que verifica a disponibilidade do VPS em uma determinada posição horizontal. Quando tiver o ArVpsAvailabilityFuture, você poderá conferir o resultado pesquisando ou com um callback.

Pesquisar o resultado

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

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

// Obtain a ArVpsAvailabilityFuture and store it somewhere.
ArVpsAvailabilityFuture* future = NULL;
CHECK(ArSession_checkVpsAvailabilityAsync(ar_session, latitude, longitude,
                                          NULL, NULL, &future) == AR_SUCCESS);

// Poll ArVpsAvailabilityFuture later, for example, in a render loop.
ArFutureState future_state = AR_FUTURE_STATE_PENDING;
ArFuture_getState(ar_session, (ArFuture*)future, &future_state);
if (future_state == AR_FUTURE_STATE_DONE) {
  ArVpsAvailability vps_availability = AR_VPS_AVAILABILITY_UNKNOWN;
  ArVpsAvailabilityFuture_getResult(ar_session, future, &vps_availability);
  switch (vps_availability) {
    case AR_VPS_AVAILABILITY_AVAILABLE:
      // VPS is available at this location.
      break;
    case AR_VPS_AVAILABILITY_UNAVAILABLE:
      // VPS is unavailable at this location.
      break;
    case AR_VPS_AVAILABILITY_ERROR_NETWORK_CONNECTION:
      // The external service could not be reached due to a network connection
      // error.
      break;

      // Handle other error states, e.g.
      // AR_VPS_AVAILABILITY_ERROR_RESOURCE_EXHAUSTED,
      // AR_VPS_AVAILABILITY_ERROR_INTERNAL, ...
  }
  ArFuture_release((ArFuture*)future);
}

Receber o resultado usando um callback

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

void vps_availability_callback(void* context, ArVpsAvailability availability) {
  // Callback is called on the Main thread.

  // Handle the ArVpsAvailability result as shown above.
  // For example, show UI that enables your AR view.

  // It is a best practice to free `context` memory at the end of the callback.
  free(context);
}

void check_availability_with_callback(ArSession* ar_session, double latitude,
                                      double longitude) {
  ArVpsAvailabilityFuture* future = NULL;
  void* context = NULL;
  CHECK(ArSession_checkVpsAvailabilityAsync(
      ar_session, latitude, longitude, context, vps_availability_callback,
      &future) == AR_SUCCESS);
}

Cancelar o ArFuture

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

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