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.

Wymagania: potrzebne jest ARCore#

WarunekSzczegóły
Telefon z ARCorewymagane — potrzebne Usługi Google Play dla AR; apka sprawdza je przy wejściu w widok AR
Zgodykamera i precyzyjna lokalizacja
Miejsceotwarta przestrzeń z widocznymi budynkami — kotwiczenie korzysta z pokrycia geoprzestrzennego

Widok AR działa tylko na telefonie z ARCore. Bez niego aplikacja uruchamia się normalnie i grasz dalej mapą, trasami i znajdźkami — dopiero dotknięcie kamery pokazuje ekran z wyjaśnieniem (np. „Ten telefon nie obsługuje AR”) i przyciskami Sprawdź ponownie, Pomoc oraz Wróć do mapy. Wersji zastępczej widoku AR nie ma. Pełną listę wymagań (wersja systemu, ARCore, kamera, lokalizacja, miejsce) i kroki na wypadek tego ekranu zebraliśmy na stronie Wymagania urządzenia.

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.357.3).

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.

Prowadzenie po trasie: kropki na ziemi#

Gdy idziesz do startu trasy (Nawiguj) albo biegniesz trasę, widok AR pokazuje drogę kropkami na ziemi — bez strzałek i bez napisów na środku ekranu.

  • Najwyżej 5 kropek, rozstawionych co ~3 m po ścieżce, którą naprawdę idziesz — na zakręcie idą łukiem chodnika, a nie prostą do celu.
  • Mijana kropka znika, a na końcu dochodzi następna — idziesz „oknem” pięciu kropek i nigdy nie ma ich sześć.
  • Najbliższa kropka jest większa i delikatnie pulsuje (cykl 1,6 s) — to ta, do której idziesz teraz; pozostałe pokazują, co dalej. Kropki leżą płasko na ziemi: pierścień z jaśniejszym środkiem.
  • Kropki pojawiają się same, zaraz po wejściu w AR — gdy tylko telefon złapie podłoże. Nie trzeba nic dotykać w HUD. Gdy router chwilowo nie odda ścieżki, apka prowadzi kropkami po prostej do celu i wraca do ścieżki po chodnikach, gdy tylko ją dostanie.
  • Podgląd trasy (sama karta trasy, bez Nawiguj) nie rysuje kropek — wtedy nikt nie idzie.
  • Po dojściu na miejsce podpowiedź u dołu mówi „jesteś na miejscu”, a po zaliczeniu punktu prowadzenie samo przechodzi na kolejny stop trasy.

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.

Tryb testu skrzyni#

W panelu debug (tekstowy przycisk na dole ekranu) jest teraz jeden przycisk: Postaw skrzynię przed sobą. Dotknięcie od razu włącza tryb testu i stawia skrzynię — cały HUD AR gaśnie, a na dole zostaje ten sam przycisk.

  • Skrzynia staje około 2,2 m przed Tobą, prosto na podłodze (podstawa dotyka podłogi, widać przód z zamkiem — nie sam wierzch) i niczego nie zasłania: nie ma już ciemnej karty ani pełnoekranowej nakładki, tylko mała pigułka u góry (Skrzynia testowa · 2,2 m z X) i jeden przycisk Otwórz skrzynię u dołu. Przez chwilę widać podpowiedź „Obejdź skrzynię dookoła” — zniknie sama po kilku sekundach.
  • Możesz obejść skrzynię dookoła (pełne 360°) i popatrzeć na nią z każdej strony, zanim ją otworzysz. Panel z kluczami pojawia się dopiero na żądanie: dotknij Otwórz skrzynię albo samej skrzyni w kadrze — wtedy wysuwa się dolny panel z kluczami (nie większy niż 40% ekranu), a skrzynia z animacją klucza i wieka zostaje widoczna nad nim. Potem Otwórz skrzynię w panelu → animacja klucza → wieko → karta wyniku → Gotowe. Bez chodzenia do skrzyni i bez internetu.
  • Skrzynia stoi w miejscu, w którym ją postawiono: możesz odejść metr w bok albo pochylić i przechylić telefon — model się nie kładzie i nie jedzie za telefonem.
  • Nagłówek panelu pokazuje dystans podglądu (2,2 m stąd), a nie 0 m — model naprawdę stoi 2,2 m przed kamerą, choć stoisz w miejscu.
  • Gotowe wraca do stanu „postawiona” — skrzynia zostaje w pokoju, otwarta, a Ty znowu masz pełny kadr i przycisk. X usuwa skrzynię i przywraca przycisk Postaw skrzynię przed sobą; kolejne postawienie stawia nową skrzynię.
  • Liczby są stałe: klucze zawsze 10, monety zawsze 100. Konto, Twoje klucze i skrzynie na mapie zostają nietknięte — dlatego karta wyniku mówi wprost „Wynik testowy — liczby nie pochodzą z serwera.”, a Saldo pokazuje 0.
  • Test można powtarzać w kółko. Wstecz bez postawionej skrzyni kończy AR i wraca na mapę, jak zawsze.
  • Wyjście z trybu = wyjście z widoku AR (osobnego przycisku wyjścia nie ma — tak chcemy, bo na ekranie ma zostać tylko jeden przycisk).

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
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 i zrzut z emulatora nie pokazałby widoku AR. Dlatego w miejscu kadru stoi ramka „kadr w przygotowaniu”; zdjęcia z telefonu dołączymy z najbliższą aktualizacją dokumentacji.

Nagroda 2× za akcje w AR#

Akcje wykonane w rozszerzonej rzeczywistości płacą dwa razy więcej niż te same akcje z mapy:

Akcja w ARMonetyEXP
Zaliczenie punktu trasy2 × stawka (10 zamiast 5)2 × stawka (50 zamiast 25)
Zebranie znajdźki2 × stawka (20 zamiast 10), dzienny limit 1002 × stawka (80 zamiast 40), dzienny limit 320
Otwarcie skrzyni2 × monety skrzyni—

Dzienny limit danej akcji rośnie razem ze stawką, więc AR nie wpada w limit szybciej niż zwykłe zbieranie. Nagroda za ukończenie trasy, bonus pierwszej trasy dnia, dystans i prezenty botów nie są mnożone. Serwer przyznaje 2× tylko wtedy, gdy razem z żądaniem dostaje Twoją pozycję i jesteś w zasięgu punktu (1,5 × promień) — bez współrzędnych AR nie zaliczy akcji. Powtórzone żądanie nie płaci drugi raz.


Opis zgodny z aplikacją 0.357.3 (zaktualizowano 2026-11-12).

Wersja aplikacji: 0.357.3 Wersja API: 0.73.0

docs.fyndi.app · 2026-11-12