Controlla la disponibilità del servizio VPS nella posizione attuale del dispositivo

L'API Geospatial utilizza una combinazione di dati VPS e GPS per generare pose geospaziali ad alta precisione. L'API può essere utilizzata ovunque il dispositivo sia in grado di determinare la sua posizione:

  • Nelle aree con scarsa precisione GPS, come spazi interni e ambienti urbani ad alta densità, l'API si affiderà alla copertura VPS per generare pose ad alta precisione.
  • In ambienti esterni con poche ostruzioni sopra l'alto o nessuna, l'API Geospatial potrebbe essere in grado di utilizzare i dati di posizione GPS disponibili per generare pose geospaziali con alta precisione.

Puoi determinare la disponibilità di VPS in una determinata posizione orizzontale prima dell'inizio della sessione AR e utilizzarla per creare esperienze più specifiche, ad esempio per presentare un pulsante "Inserisci AR" solo quando VPS è disponibile.

Abilita l'API ARCore

La tua app deve abilitare l'API ARCore per verificare la disponibilità di VPS.

Una volta abilitata l'API ARCore, puoi controllare la disponibilità di VPS senza:

Verificare la disponibilità di VPS nell'app

L'API Geospatial può essere utilizzata ovunque il dispositivo sia in grado di determinare la sua posizione. Se la tua esperienza AR dipende dalla copertura VPS, puoi utilizzare Session.checkVpsAvailabilityAsync() per ottenere un'VpsAvailabilityFuture, un'attività asincrona che verifica la disponibilità dei VPS in una determinata posizione orizzontale. Una volta che hai la VpsAvailabilityFuture, puoi ottenerne i risultati con il polling o tramite un callback.

Sondaggio sul risultato

Utilizza Future.getState() per conoscere lo stato di Future. Esistono tre diversi stati:

Puoi continuare a controllare Future.getState() fino al completamento dell'attività.

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, ...")
    }
  }
}

Ottenere il risultato tramite callback

Puoi anche ottenere il risultato di un Future tramite un callback. Utilizza Session.checkVpsAvailabilityAsync() e fornisci un callback. Questo callback verrà chiamato nel thread principale subito dopo che Future avrà raggiunto lo stato 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)
}

Annulla Future

Utilizza Future.cancel() per tentare di annullare il Future. A causa del parallelismo dei thread, è possibile che il tuo tentativo di annullamento non vada a buon fine. Future.cancel() restituisce true se questo tentativo è riuscito e false in caso contrario.

Usa l'API Geospatial senza copertura VPS

L'API Geospatial può essere utilizzata anche in aree che non dispongono di copertura VPS. In ambienti all'aperto con poche ostruzioni o nessuna ostruzione, il GPS può essere sufficiente per acquisire una posizione con precisione.

Passaggi successivi