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

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 animation Lottie — ví dụ: một vòng tròn tô dần để hiển thị chuỗi ngày liên tiếp. Ứng dụng của bạn sẽ render animation dưới dạng native Lottie view trong một custom element.

Trước khi bắt đầu

Chuẩn bị một animation Lottie ở định dạng .json, hoặc tải xuống file mẫu streak_ring.json. Ứng dụng phát animation từ đầu và dừng lại theo tỷ lệ tiến độ, chẳng hạn dừng ở giữa nếu tiến độ là 50%. Để hiển thị đúng tiến độ, animation cần đáp ứng:

  • Không có tiến độ ở frame đầu tiên, và tiến độ đầy đủ ở frame cuối cùng.
  • Tốc độ đều, không có easing. Nếu animation 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 độ khi đã đi được nửa chừng.

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à thiết lập 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 phần tử tùy chỉnh.

Bên trong phần tử tùy chỉnh, thêm một Image với ảnh tĩnh của vòng trò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 phát được animation.

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

Đặt file animation vào src/main/assets, thư mục assets của module ứng dụng. Giữ file ở thư mục gốc, không đặt trong thư mục con.

Tên file không có .json phải khớp với ID của custom element, ví dụ streak_ring.json cho streak_ring.

3. Tạo animation view

Tạo một model cho streak và một view phát animation. Ứng dụng của bạn cập nhật model khi streak thay đổi. View đọc model, vì vậy vòng tròn hiển thị streak hiện tại khi màn hình mở ra:

4. Khớp animation với custom element

Trong resolver toàn ứng dụng của bạn, thêm một thuộc tính cho streak model. Sau đó trả về animation view 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 hoặc thay đổi. 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ạ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 duy nhất, 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ị thử nghiệm.
  2. Chạy bản build của ứng dụng có chứa resolver. Đặt streak về 0 ngày, mở màn hình và xác nhận rằng vòng tròn vẫn trống. Lặp lại với 4 và 7 ngày, và xác nhận rằng vòng tròn được tô đầy đến từng giá trị tương ứng.

Để kiểm tra fallback, hãy xóa file animation khỏi bản build và 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ì hoạt ảnh, 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 Android.