Khi sử dụng các mẫu sau, bạn có thể thêm tính năng hỗ trợ để người dùng tương tác với bản đồ mà bạn vẽ, chẳng hạn như cho phép người dùng xem các phần khác nhau của bản đồ bằng cách thu phóng và kéo bản đồ.
| Mẫu | Hỗ trợ cấp độ Car App API |
|---|---|
NavigationTemplate |
2 |
(không dùng nữa) |
4 |
(không dùng nữa) |
4 |
(không dùng nữa) |
5 (mẫu được giới thiệu) |
MapWithContentTemplate |
7 (giới thiệu mẫu) |
Triển khai lệnh gọi lại tương tác
Giao diện SurfaceCallback có một số phương thức gọi lại mà bạn có thể triển khai để thêm tính tương tác vào bản đồ được tạo bằng các mẫu trong phần trước:
| Tương tác | Phương thức | Hỗ trợ cấp độ Car App API |
|---|---|---|
| Nhấn | onClick |
5 |
| Chụm để thu phóng | onScale |
2 |
| Kéo bằng một lần nhấn | onScroll |
2 |
| Hất bằng một lần nhấn | onFling |
2 |
| Nhấn đúp |
(máy chủ lưu trữ mẫu xác định hệ số tỷ lệ) |
2 |
| Lời nhắc xoay ở chế độ kéo |
(máy chủ lưu trữ mẫu xác định hệ số khoảng cách) |
2 |
Thêm chuỗi hành động trên bản đồ
Các mẫu này có thể có một chuỗi hành động trên bản đồ cho các thao tác liên quan đến bản đồ, chẳng hạn như phóng to và thu nhỏ, căn giữa lại, hiển thị la bàn và các thao tác khác mà bạn chọn hiển thị. Chuỗi hành động trên bản đồ có thể chứa tối đa 4 nút chỉ hiển thị bằng biểu tượng có thể được làm mới mà không ảnh hưởng đến chiều sâu của nhiệm vụ. Chuỗi hành động sẽ bị che khuất khi ở trạng thái rảnh và xuất hiện lại ở trạng thái hoạt động.
Để nhận được lệnh gọi lại về tính tương tác trên bản đồ, bạn phải thêm một nút Action.PAN trong chuỗi hành động trên bản đồ. Khi người dùng nhấn nút Kéo, máy chủ lưu trữ sẽ chuyển sang chế độ kéo, như mô tả trong phần Tìm hiểu chế độ kéo.
Nếu bỏ qua nút Action.PAN trong chuỗi hành động trên bản đồ, ứng dụng của bạn sẽ không nhận được hoạt động đầu vào của người dùng từ các phương thức SurfaceCallback và máy chủ lưu trữ sẽ đóng mọi chế độ kéo đã kích hoạt trước đó.
Trên màn hình cảm ứng, nút Kéo sẽ không xuất hiện.
Tìm hiểu về chế độ quay quét
Ở chế độ kéo, máy chủ lưu trữ mẫu sẽ chuyển hoạt động đầu vào của người dùng từ các thiết bị đầu vào không cảm ứng (chẳng hạn như bộ điều khiển xoay và bàn di chuột) sang các phương thức SurfaceCallback thích hợp. Phản hồi hành động của người dùng để chuyển sang hoặc thoát chế độ kéo bằng phương thức setPanModeListener trong NavigationTemplate.Builder.
Máy chủ lưu trữ có thể ẩn các thành phần khác trên giao diện người dùng trong mẫu khi người dùng đang ở chế độ kéo.