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

Interfejs Geospatial API korzysta z kombinacji danych VPS i GPS, aby generować pozycje geoprzestrzenne o wysokiej dokładności. Interfejsu API można używać w dowolnym miejscu, w którym urządzenie może określić swoją lokalizację:

  • 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 usługi 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ą.

Przed rozpoczęciem sesji AR możesz określić dostępność VPS w danej pozycji poziomej i wykorzystać ją do tworzenia bardziej szczegółowych funkcji, np. wyświetlania przycisku „Wejdź do AR” tylko wtedy, gdy VPS jest dostępny.

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 korzystanie z AR zależy od zasięgu VPS, możesz użyć AREarthManager.CheckVpsAvailabilityAsync(), aby uzyskać VpsAvailabilityPromise, czyli zadanie asynchroniczne, które sprawdza dostępność VPS w danej pozycji poziomej. Gdy masz już VpsAvailabilityPromise, możesz uzyskać jego wynik, wysyłając zapytanie.

Wyniki ankiety

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

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

Anuluj InterruptiblePromise

Aby anulować InterruptiblePromise, użyj VpsAvailabilityPromise.Cancel(). Ze względu na równoległe wykonywanie wątków może się zdarzyć, że próba anulowania nie powiedzie się.

Korzystanie z interfejsu Geospatial API bez pokrycia VPS

Interfejsu Geospatial API można też używać na obszarach, na których nie ma pokrycia VPS. W otoczeniu zewnętrznym z niewielką liczbą przeszkód nad głową lub bez nich GPS może wystarczyć do wygenerowania pozy z wysoką dokładnością.

Co dalej?