Adres i język
Otwórz adres mapy wydarzenia i przekaż język aplikacji (?lang=). Jeśli w aplikacji można zmienić język, wywołaj most, aby mapa zmieniła go bez przeładowania.
Obsługa wiadomości
Zarejestruj odbiorcę wiadomości z mapy: WKScriptMessageHandler na iOS, interfejs JavaScript na Androidzie, onMessage w react-native-webview. Użyj nazw z konfiguracji mapy.
Poczekaj na „ready”
Nie wywołuj mapy, zanim się załaduje. Poczekaj na zdarzenie ready, sprawdź wersję mostu, a potem wysyłaj polecenia, np. otwarcie miejsca albo wyznaczenie trasy.
Korzystaj ze zdarzeń
Mapa informuje aplikację, gdy ktoś otworzy miejsce, wyznaczy trasę lub coś udostępni. Zdarzenia udostępniania pozwalają otworzyć własne okno udostępniania aplikacji zamiast przeglądarkowego.
Linki głębokie z push i kodów QR
Powiadomienie push albo kod QR może nieść link do mapy — miejsce, trasę, język. Kieruj takie linki do WebView, aby otwierały się we właściwym miejscu.
Offline na iOS i Androidzie
Mapa działa offline dzięki service workerowi. W WKWebView na iOS service workery działają tylko dla App-Bound Domains: wpisz domenę mapy w WKAppBoundDomains w Info.plist i ogranicz nawigację do tych domen.
Na Androidzie włącz w ustawieniach WebView JavaScript i DOM storage, aby mapa mogła przechowywać swoje dane.
Uprawnienia i powiadomienia
Lokalizację i aparat (do kodów QR) przyznaje się aplikacji; przekazuj je do WebView tylko wtedy, gdy mapa ich potrzebuje.
Web push nie działa w WebView. Powiadomienia wysyłaj z aplikacji, a komunikaty mapy podłącz do swojego serwisu push.
Testuj jak uczestnik
Przed publikacją sprawdź na prawdziwych urządzeniach:
- Mapa otwiera się w języku aplikacji
- Miejsce otwarte z natywnego ekranu pokazuje swoją kartę
- Udostępnianie otwiera okno udostępniania aplikacji
- Link z powiadomienia push prowadzi do właściwego miejsca
- Mapa ładuje się w trybie samolotowym po jednej wizycie online
- Bezpieczne obszary ekranu i gest „wstecz” działają jak w reszcie aplikacji
Aplikacja z mapą festiwalu
Noctara Run: demo mapy trasy biegu