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#
| Warunek | Szczegóły |
|---|---|
| Telefon z ARCore | wymagane — potrzebne Usługi Google Play dla AR; apka sprawdza je przy wejściu w widok AR |
| Zgody | kamera i precyzyjna lokalizacja |
| Miejsce | otwarta 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ąć#
- 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).
- Rozejrzyj się powoli: „Pokaż otoczenie kamerze — rozejrzyj się w lewo, prawo, górę i dół”.
- Poczekaj, aż zniknie „Poprawiam dokładność pozycji…” — modele stają, gdy pozycja jest pewna.
- Status mówi, ile metrów masz do najbliższego modelu i w którą stronę.
- W zasięgu 12 m pojawia się Zbierz znajdźkę. Dotknięcie zbiera ją i wraca na mapę.
- Wyjście: kafelek mapy albo systemowy przycisk wstecz — mapa wraca w to samo miejsce.
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.
| Ikona | Co pokazuje | Kiedy ś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 ziemska | pokrycie geoprzestrzenne (VPS) | żółta — brak pokrycia; szara — sprawdzenie jeszcze nie wróciło |
| igła kompasu | kierunek, 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#
| Objaw | Co 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 otwiera | sprawdzenie ARCore ma limit czasu — poczekaj chwilę i dotknij ponownie |
| Komunikat o nieudanym starcie AR | zamknij inne aplikacje z kamerą i zainstaluj lub zaktualizuj Usługi Google Play dla AR |
| Modele nie stoją na ziemi | wyjdź 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 AR | Monety | EXP |
|---|---|---|
| Zaliczenie punktu trasy | 2 × stawka (10 zamiast 5) | 2 × stawka (50 zamiast 25) |
| Zebranie znajdźki | 2 × stawka (20 zamiast 10), dzienny limit 100 | 2 × stawka (80 zamiast 40), dzienny limit 320 |
| Otwarcie skrzyni | 2 × 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).