Hiển thị tiến trình người dùng bằng hoạt ảnh Lottie

Hãy làm theo hướng dẫn này để hiển thị tiến trình của người dùng dưới dạng hoạt ảnh Lottie — ví dụ: một vòng tròn tô dần để biểu thị streak hàng ngày của họ. Ứng dụng của bạn sẽ render hoạt ảnh này dưới dạng Lottie view gốc trong một custom element.

Tip

Recipe 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.
  • Thêm Lottie vào ứng dụng bằng Swift Package Manager, từ https://github.com/airbnb/lottie-spm.git.
  • Chuẩn bị một hoạt ảnh Lottie định dạng .json, hoặc tải file mẫu streak_ring.json. Ứng dụng sẽ phát hoạt ảnh từ đầu và dừng lại theo tỷ lệ tiến trình, ví dụ dừng giữa chừng nếu tiến trình đạt 50%. Để hiển thị đúng tiến trình, hoạt ảnh cần đáp ứng:
    • Không có tiến trình ở khung hình đầu tiên, và tiến trình đầy đủ ở khung hình cuối cùng.
    • Tốc độ đều, không có easing. Nếu hoạt ảnh bắt đầu chậm rồi tăng tốc, nó sẽ hiển thị ít hơn một nửa tiến trình ở điểm giữa.

1. Thêm custom element vào màn hình

Trong Flow & Paywall Builder, thêm một custom element vào màn hình flow và cấu hình cho animation:

  • Type: lottie_animation.
  • ID: streak_ring. Trong hướng dẫn này, ID cũng là tên của file animation.
  • Height: Giữ nguyên chiều cao Fixed mặc định. Animation sẽ tự co giãn để vừa với custom element.

Bên trong custom element, thêm một Image với ảnh tĩnh của chiếc nhẫn. Người dùng sẽ thấy ảnh này như là nội dung dự phòng khi phiên bản ứng dụng của họ không phát được animation.

2. Thêm file animation vào ứng dụng

Trong Xcode, thêm file animation vào target ứng dụng của bạn. Tên file (không có phần mở rộng .json) phải khớp với ID của phần tử tùy chỉnh, ví dụ streak_ring.json tương ứng với streak_ring.

3. Tạo animation view

Tạo một model cho streak, và một SwiftUI view phát animation. App của bạn cập nhật model khi streak thay đổi. View đọc model, nên ring hiển thị streak hiện tại khi màn hình mở:

.playing(.fromProgress(0, toProgress: progress, loopMode: .playOnce)) điền vào vòng tròn một lần, từ trống đến progress. Nếu ứng dụng của bạn đã lưu streak trong một ObservableObject, hãy dùng object đó thay cho StreakStore.

4. Liên kết animation với phần tử tùy chỉnh

Trong resolver toàn ứng dụng của bạn, thêm một thuộc tính cho streak model. Sau đó thêm một case trả về StreakRingView cho Type lottie_animation và ID streak_ring. Các dòng được tô sáng 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:

Đặt case streak_ring trước bất kỳ case lottie_animation nào khác, vì Swift chỉ chạy case đầu tiên khớp. Nếu bundle ứng dụng không có file nào cho ID đó, resolver trả về nil và người dùng sẽ thấy phần dự phòng.

Tạo resolver với streak model và đặt nó làm resolver toàn ứng dụng. Gọi AdaptyUI.setCustomElementsResolver(_:) một lần, chẳng hạn khi khởi động ứng dụng:

5. Kiểm tra trên thiết bị

Flow & Paywall Builder không thể chạy code của ứng dụng, vì vậy canvas chỉ hiển thị fallback. Để xem trước animation:

  1. 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 lưu trong bộ nhớ đệm, hãy đăng ký thiết bị làm thiết bị test.
  2. Chạy một bản build của ứng dụng có bao gồm resolver. Đặt streak thành một vài giá trị, chẳng hạn như 0, 4 và 7 ngày. Mở màn hình cho từng giá trị và xác minh rằng vòng tròn được tô đầy đến mức đó.

Để test fallback, hãy xóa file animation khỏi bản build và mở lại màn hình.

Để tìm hiểu nguyên nhân tại sao paywall dự phòng hiển thị thay vì hiệu ứng animation, 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.