Korzystając z tych szablonów, możesz dodać obsługę interakcji użytkowników z rysowanymi przez Ciebie mapami, np. umożliwić im wyświetlanie różnych części mapy przez powiększanie i przesuwanie.
| Szablon | Obsługa poziomu interfejsu Car App API |
|---|---|
NavigationTemplate |
2 |
(wycofane) |
4 |
(wycofane) |
4 |
(wycofane) |
5 (wprowadzono szablon) |
MapWithContentTemplate |
7 (wprowadzono szablon) |
Implementowanie wywołań zwrotnych interaktywności
Interfejs SurfaceCallback ma kilka metod wywołania zwrotnego, które możesz zaimplementować, aby dodać interaktywność do map utworzonych za pomocą szablonów z poprzedniej sekcji:
| Interakcja | Metoda | Obsługa poziomu interfejsu Car App API |
|---|---|---|
| Kliknij | onClick |
5 |
| Ściągnij, aby powiększyć | onScale |
2 |
| Przeciąganie jednym dotknięciem | onScroll |
2 |
| Przesunięcie jednym dotknięciem | onFling |
2 |
| Kliknij dwukrotnie |
(gospodarz szablonu określa współczynnik skali) |
2 |
| Przesunięcie obrotowe w trybie przesuwania |
(host szablonu określa współczynnik odległości) |
2 |
Dodawanie paska działań na mapie
Szablony te mogą zawierać pasek działań na mapie, który umożliwia wykonywanie działań związanych z mapą, takich jak powiększanie i pomniejszanie, ponowne wyśrodkowywanie, wyświetlanie kompasu i inne działania, które chcesz wyświetlać. Pasek działań na mapie może zawierać maksymalnie 4 przyciski z samymi ikonami, które można odświeżać bez wpływu na głębokość zadania. Pasek działań jest ukryty w stanie bezczynności i ponownie pojawia się w stanie aktywności.
Aby otrzymywać wywołania zwrotne dotyczące interaktywności mapy, musisz dodać Action.PANprzycisk na pasku działań mapy. Gdy użytkownik naciśnie przycisk Pan, host przejdzie w tryb panoramowania zgodnie z opisem w artykule Informacje o trybie panoramowania.
Jeśli aplikacja pominie przycisk Action.PAN na pasku działań mapy, nie będzie otrzymywać danych wejściowych od użytkownika z metod SurfaceCallback, a aplikacja hosta zamknie każdy wcześniej aktywowany tryb przesuwania.
Na ekranie dotykowym nie jest wyświetlany przycisk Przesuń.
Informacje o trybie przesuwania
W trybie przesuwania host szablonu tłumaczy dane wejściowe użytkownika z urządzeń wejściowych innych niż dotykowe, takich jak pokrętła i touchpady, na odpowiednie metody SurfaceCallback. Odpowiedz na działanie użytkownika polegające na wejściu w tryb przesuwania lub wyjściu z niego za pomocą metody setPanModeListener w NavigationTemplate.Builder.
Gospodarz może ukryć inne komponenty interfejsu w szablonie, gdy użytkownik jest w trybie przesuwania.