Hiển thị các địa điểm gần đây trên bản đồ trong một flow
Làm theo hướng dẫn này để tích hợp bản đồ tương tác vào một flow. Ứng dụng của bạn hiển thị bản đồ dưới dạng native MapKit view trong một phần tử tùy chỉnh. Ứng dụng sẽ yêu cầu quyền truy cập vị trí trên màn hình flow.
Hướng dẫn này chỉ áp dụng cho ứng dụng iOS. Các ứng dụng được xây dựng bằng framework khác chỉ hiển thị nội dung dự phòng của các phần tử tùy chỉnh. Hỗ trợ cho Android và các framework đa nền tảng sẽ sớm ra mắt.
Trước khi bắt đầu
- Cập nhật ứng dụng lên Adapty iOS SDK 4.4 trở lên. Các phiên bản SDK cũ hơn sẽ hiển thị nội dung dự phòng cho mọi phần tử tùy chỉnh.
- Thiết lập ứng dụng để tải và hiển thị flow.
- Để yêu cầu người dùng cấp quyền truy cập vị trí, hãy thêm key
NSLocationWhenInUseUsageDescriptionvào fileInfo.plistcủa ứng dụng. Đặt giá trị của key này là nội dung thông báo, ví dụ: “Find fitness centers near you.”
1. Thêm phần tử tùy chỉnh vào màn hình
Trong Flow & Paywall Builder, thêm một phần tử tùy chỉnh vào màn hình flow và cấu hình cho bản đồ:
- Type:
map. - ID:
fitness_centers. - Height: Giữ nguyên chiều cao Fixed mặc định. Bản đồ sẽ lấp đầy phần tử tùy chỉnh.
Đừng đặt phần tử tùy chỉnh vào trong các container phản hồi thao tác chạm, chẳng hạn như carousel. Nếu không, khi kéo trên bản đồ sẽ làm carousel di chuyển theo.
Bên trong custom element, thêm một Image với hình ảnh bản đồ. Người dùng sẽ thấy nó như là nội dung dự phòng khi:
- Phiên bản ứng dụng của họ không hiển thị được bản đồ.
- Họ đã từ chối quyền truy cập vị trí trước khi màn hình mở ra.
- Thiết bị của họ chạy iOS 16.
Nếu người dùng chưa trả lời yêu cầu cấp quyền truy cập vị trí, iOS sẽ hiển thị yêu cầu đó khi bản đồ xuất hiện. Để cho người dùng biết tại sao ứng dụng cần vị trí của họ, hãy thêm một phần tử văn bản phía trên custom element, chẳng hạn như “Tìm trung tâm thể dục gần bạn.”
2. Tạo map view
Tạo một model để quản lý quyền truy cập vị trí, và một SwiftUI view với bản đồ. View này sẽ yêu cầu quyền truy cập vị trí, tìm các trung tâm thể dục trong vòng 2 km quanh người dùng, và hiển thị marker cho từng địa điểm:
Chế độ xem bản đồ yêu cầu iOS 17 trở lên. Trên iOS 16, người dùng sẽ thấy paywall dự phòng. Nếu người dùng từ chối quyền truy cập vị trí trên màn hình, chế độ xem sẽ thay thế bản đồ bằng thông báo hướng dẫn cách cấp quyền trong Cài đặt.
3. Khớp map với custom element
Trong resolver toàn ứng dụng của bạn, thêm một thuộc tính cho model LocationAccess. Sau đó thêm một case trả về map view cho Type map và ID fitness_centers. Các dòng được highlight cho thấy những gì cần thêm. Nếu ứng dụng của bạn chưa có resolver toàn ứng dụng, hãy sao chép toàn bộ đoạn code:
SDK sẽ gọi resolver khi màn hình mở ra, và tiếp tục gọi trong khi màn hình đang hiển thị, chẳng hạn khi các sản phẩm được tải. Quyền truy cập vị trí xác định những gì resolver trả về trong mỗi lần gọi:
- Chưa được trả lời: View bản đồ, để view có thể yêu cầu quyền truy cập.
- Đã cho phép: View bản đồ, hiển thị các trung tâm thể dục gần người dùng.
- Đã từ chối trước khi màn hình mở:
nil, để người dùng thấy paywall dự phòng thay vì thông báo về Cài đặt. - Đã từ chối trên màn hình: View bản đồ, vì view đặt
isMapOnScreenkhi đang hiển thị. Nếu resolver trả vềnilở đây, SDK sẽ thay thế thông báo về Cài đặt bằng paywall dự phòng ở lần gọi tiếp theo.
Nếu ứng dụng của bạn chưa thiết lập resolver toàn cục, hãy gọi AdaptyUI.setCustomElementsResolver(_:) một lần, chẳng hạn khi khởi động ứng dụng:
4. Kiểm tra trên thiết bị
Flow & Paywall Builder không thể chạy code ứng dụng của bạn, nên canvas chỉ hiển thị fallback. Để xem trước bản đồ:
- Xuất bản flow. Để xem phiên bản đã xuất bản mới nhất thay vì phiên bản được cache, hãy đăng ký thiết bị làm thiết bị test.
- Chạy bản build ứng dụng có chứa resolver trên iOS 17 trở lên. Mở màn hình và cho phép truy cập vị trí. Kiểm tra xem bản đồ có hiển thị vị trí của bạn và các điểm đánh dấu cho các trung tâm thể dục gần đó không.
Để kiểm tra paywall dự phòng, hãy từ chối quyền truy cập vị trí: trong ứng dụng Settings, vào Privacy & Security > Location Services > ứng dụng của bạn, rồi chọn Never. Sau đó mở lại màn hình.
Để tìm hiểu lý do tại sao paywall dự phòng hiển thị thay vì bản đồ, hãy làm theo hướng dẫn trong phần Kiểm tra trên thiết bị của hướng dẫn iOS.