Przejdź do treści
Fyndi docs
English

Widok AR#

Widok AR — w apce nazwany oczy postaci — to obraz z kamery telefonu, na którym modele 3D znajdziek i tras stoją zakotwiczone w prawdziwym miejscu w mieście, a nie na mapie.

Kiedy widok AR jest dostępny#

WarunekSzczegóły
Telefon z ARCorepotrzebne Usługi Google Play dla AR; apka sprawdza je na ekranie startowym („Sprawdzam AR…”)
Zgodykamera i precyzyjna lokalizacja
Miejsceotwarta przestrzeń z widocznymi budynkami — kotwiczenie korzysta z pokrycia geoprzestrzennego

Brak ARCore nie blokuje gry: zamiast widoku AR otwiera się widok z kamery w wersji 2D (Kamera i zdjęcia), więc na każdym telefonie coś się dzieje.

Jak zacząć#

  1. Otwórz widok AR jednym z dwóch przycisków — oba prowadzą do tego samego ekranu: kafelkiem kamery w prawym górnym rogu mapy („Kamera — oczy postaci (widok AR)”) albo Otwórz AR na karcie znajdźki z modelem 3D (Znajdźki).
  2. Rozejrzyj się powoli: „Pokaż otoczenie kamerze — rozejrzyj się w lewo, prawo, górę i dół”.
  3. Poczekaj, aż zniknie „Poprawiam dokładność pozycji…” — modele stają, gdy pozycja jest pewna.
  4. Status mówi, ile metrów masz do najbliższego modelu i w którą stronę.
  5. W zasięgu 12 m pojawia się Zbierz znajdźkę. Dotknięcie zbiera ją i wraca na mapę.
  6. Wyjście: kafelek mapy albo systemowy przycisk wstecz — mapa wraca w to samo miejsce.
Wejście do widoku AR z kafelka kamery na mapie i pierwsze sekundy kalibracji pozycji — kadry z aplikacji dołączymy z najbliższą aktualizacją dokumentacji (opisuje wersję 0.120.1).

Wskaźnik jakości w lewym górnym rogu#

Widok AR pilnuje trzech rzeczy naraz: pozycji, pokrycia geoprzestrzennego (VPS) i kierunku telefonu. Pokazuje tylko to, co ma problem — stan w porządku nie zostawia po sobie ikony, a gdy wszystko działa, wskaźnik nie pojawia się wcale.

IkonaCo pokazujeKiedy świeci
kontrolka „moja lokalizacja”dokładność pozycji z GPSżółta — słaba pozycja; czerwona — brak zgody na lokalizację albo lokalizacja wyłączona w systemie; szara — nie ma jeszcze pozycji
kula ziemskapokrycie geoprzestrzenne (VPS)żółta — brak pokrycia; szara — sprawdzenie jeszcze nie wróciło
igła kompasukierunek, w który patrzy telefonżółta — kurs niepewny; szara — brak kursu

Dotknięcie tych ikon nic nie robi — to wskaźnik, nie przycisk. Czytnik ekranu czyta pełny opis każdego stanu („Kierunek: niepewny”), bo sam kolor nic mu nie mówi.

Jazda do celu: pikanie, wibracja i poświata#

  • Pikanie — im bliżej celu, tym częstsze (od kilkunastu sekund na skraju zasięgu do około dwóch sekund przy celu) i głośniejsze. W słuchawkach słyszysz stronę, z której dochodzi.
  • Wibracja i poświata — drgnięcie towarzyszy każdemu pikowi, a na krawędzi kadru świeci poświata z tej strony, z której jest cel; gdy cel masz za sobą, siada na dolnej krawędzi.

Prowadzenie dotyczy znajdziek i początków tras — punkty trasy w środku trasy nie pikają. Punkt wskazany palcem na mini-mapie prowadzi zawsze, nawet gdy automat by milczał.

Dźwięk i wibrację wyłączysz kafelkami w widoku AR. Ustawienie jest pamiętane: wyłączysz raz i po powrocie na mapę, po ponownym wejściu do AR, a nawet po restarcie apki nadal są wyłączone. Ten sam przełącznik działa w widoku z kamery — jedno ustawienie dla obu widoków.

Mini-mapa w widoku AR#

Na dole ekranu masz mini-mapę na pełną szerokość: Twoją postać, prowadzony cel i pozostałe punkty.

  • Startuje zwinięta — widać samą rączkę Mapa; rozwinięcie jest pamiętane między wejściami.
  • Przesuwanie — przeciągnij palcem; mapa zostaje tam, gdzie ją zostawisz, a dotknięcie swojego ludzika przywraca widok „za graczem”, na Twojej prawdziwej pozycji.
  • Kliknięcie mapy włącza prowadzenie do wybranego punktu — wokół celu pulsuje pierścień, a +/− przybliża i oddala.
  • Smuga prowadzenia ma kolor celu: znajdźka — złota, trasa — turkusowa, zebrane — szare.
  • Mapa obraca się kierunkiem Twojego ruchu: po kilku metrach marszu ustawia się w stronę, w którą idziesz, a stojąc — stoi nieruchomo, więc nie trzęsie się w ręce.

Gdy kotwiczenie nie chce zadziałać#

  • Modele stają dopiero przy dobrej pozycji. Jeśli długo widzisz „Poprawiam dokładność pozycji…”, odejdź kilka metrów i pokaż kamerze inne budynki.
  • W panelu debug (tekstowy przycisk na dole ekranu) jest Postaw klocek kontrolny przed sobą: model staje około dwóch metrów przed Tobą na kotwicy kamery — bez GPS i bez VPS. Widzisz klocek, gdy rysowanie i modele działają; wtedy szukaj przyczyny w kotwiczeniu, a nie w scenie.

Co robić, gdy AR nie wstaje#

ObjawCo zrobić
Karta „Do trybu AR potrzebuję kamery i lokalizacji.”dotknij Daj uprawnienia i zezwól na kamerę i lokalizację (GPS i dokładność pozycji); Zamknij wraca na mapę
Kafelek kamery nic nie otwierasprawdzenie ARCore ma limit czasu — poczekaj chwilę i dotknij ponownie; po limicie apka otwiera widok z kamery 2D
Komunikat o nieudanym starcie ARzamknij inne aplikacje z kamerą i zainstaluj lub zaktualizuj Usługi Google Play dla AR
Modele nie stoją na ziemiwyjdź z pomieszczenia i rozejrzyj się po budynkach; po świeżym wejściu daj apce kilka sekund

Czego nie pokazujemy zrzutem i dlaczego#

Kadry z widoku AR pochodzą wyłącznie z telefonu — i na razie ich nie mamy. Emulator na naszym serwerze nie ma Usług Google Play dla AR, więc ARCore nie wstaje na nim wcale, a zrzut z emulatora pokazałby widok z kamery 2D, nie AR. Dlatego w miejscu kadru stoi ramka „kadr w przygotowaniu”; zdjęcia z telefonu dołączymy z najbliższą aktualizacją dokumentacji.


Opis zgodny z aplikacją 0.120.1 (zaktualizowano 2026-09-26).

Wersja aplikacji: 0.120.1 · Wersja API: 0.35.0 ·

docs.fyndi.app · 2026-09-26