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#
| Warunek | Szczegóły |
|---|---|
| Telefon z ARCore | potrzebne Usługi Google Play dla AR; apka sprawdza je na ekranie startowym („Sprawdzam AR…”) |
| Zgody | kamera i precyzyjna lokalizacja |
| Miejsce | otwarta 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ąć#
- 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.
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#
| 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; po limicie apka otwiera widok z kamery 2D |
| 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, 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).