Sprawdź dostępność VPS w bieżącej lokalizacji urządzenia

Geospatial API korzysta z kombinacji danych VPS i danych GPS do generowania wysokiej dokładności pozycji geoprzestrzennych. Interfejsu API można używać w każdym miejscu, w którym urządzenie może określić swoje położenie:

  • W obszarach o niskiej dokładności GPS, takich jak wnętrza budynków i gęste obszary miejskie, interfejs API będzie korzystać z zasięgu VPS, aby generować pozy o wysokiej dokładności.
  • W środowiskach zewnętrznych z niewielką liczbą przeszkód nad głową interfejs Geospatial API może używać dostępnych danych o lokalizacji GPS, aby generować pozycje geoprzestrzenne z dużą dokładnością.

Możesz określić dostępność VPS w danej pozycji poziomej przed rozpoczęciem sesji AR i wykorzystać ją do utworzenia bardziej precyzyjnego środowiska, np. do wyświetlania przycisku „Włącz AR” tylko wtedy, gdy usługa VPS jest dostępna.

Włącz interfejs ARCore API

Aby sprawdzić dostępność VPS, aplikacja musi mieć włączony interfejs ARCore API.

Sprawdzanie dostępności usługi VPS w aplikacji

Interfejsu Geospatial API można używać w dowolnym miejscu, w którym urządzenie może określić swoją lokalizację. Jeśli działanie AR zależy od pokrycia VPS, możesz użyć narzędzia AREarthManager.CheckVpsAvailabilityAsync(), aby uzyskać VpsAvailabilityPromise – asynchroniczne zadanie, które sprawdza dostępność VPS w danej pozycji poziomej. Gdy masz już VpsAvailabilityPromise, możesz uzyskać jego wynik, wysyłając zapytanie.

Przeprowadź ankietę

Aby uzyskać stan InterruptiblePromise, użyj polecenia VpsAvailabilityPromise.State. Istnieją 3 różne stany:

Możesz nadal sprawdzać VpsAvailabilityPromise.State, aż zadanie zostanie ukończone.

Anuluj InterruptiblePromise

Aby anulować InterruptiblePromise, użyj VpsAvailabilityPromise.Cancel(). Z powodu równoległości wątków może się zdarzyć, że próba anulowania się nie powiedzie.

Korzystanie z interfejsu Geospatial API bez pokrycia VPS

Interfejsu Geospatial API można też używać na obszarach, które nie mają zasięgu VPS. W otoczeniu zewnętrznym z niewielkimi lub żadnymi przeszkodami z góry GPS może wystarczyć do wygenerowania pozy z wysoką dokładnością.

Co dalej?