Các skill bao gồm tích hợp SDK, xây dựng flow và paywall, kiểm tra trước khi phát hành, di chuyển placement và nhiều hơn nữa. Mô tả công việc bằng ngôn ngữ thường ngày và agent sẽ chọn skill phù hợp.
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
Cập nhật ứng dụng lên Adapty Android 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.
Thêm Lottie vào ứng dụng thông qua Gradle, từ com.airbnb.android:lottie.
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.
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:
// the streak that your app keeps up to dateclass StreakStore { val currentStreak = MutableStateFlow(0) // days in a row}@Composablefun StreakRing(animationFile: String, streakStore: StreakStore) { val composition by rememberLottieComposition(LottieCompositionSpec.Asset(animationFile)) val streak by streakStore.currentStreak.collectAsState() // 7 days fill the ring: from 0 for an empty ring to 1 for a full one val progress = minOf(streak / 7f, 1f) LottieAnimation( composition = composition, modifier = Modifier.fillMaxSize(), // scale the animation to fit the custom element clipSpec = LottieClipSpec.Progress(0f, progress), )}
clipSpec = LottieClipSpec.Progress(0f, progress) đ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 StateFlow, hãy dùng StateFlow đó thay cho StreakStore.
// the streak that your app keeps up to datepublic class StreakStore { public final MutableLiveData<Integer> currentStreak = new MutableLiveData<>(0); // days in a row}public class StreakRingView extends LottieAnimationView { private final StreakStore streakStore; private final Observer<Integer> streakObserver = streak -> { // 7 days fill the ring: from 0 for an empty ring to 1 for a full one float progress = Math.min(streak / 7f, 1f); setMinAndMaxProgress(0f, progress); playAnimation(); }; public StreakRingView(Context context, String animationFile, StreakStore streakStore) { super(context); this.streakStore = streakStore; setAnimation(animationFile); } @Override protected void onAttachedToWindow() { super.onAttachedToWindow(); streakStore.currentStreak.observeForever(streakObserver); } @Override protected void onDetachedFromWindow() { streakStore.currentStreak.removeObserver(streakObserver); super.onDetachedFromWindow(); }}
setMinAndMaxProgress(0f, progress) và playAnimation() sẽ lấp đầy 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 LiveData, hãy dùng LiveData đó thay cho StreakStore.
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:
class CustomElementsResolver( context: Context, private val streakStore: StreakStore,) : AdaptyCustomElementsResolver { // the animation files in the assets folder, listed once private val animationFiles: Set<String> = try { context.assets.list("").orEmpty().toSet() } catch (e: IOException) { emptySet() // no list of files: every Lottie element shows the fallback } override fun resolve(type: String, id: String): AdaptyCustomElementContent? = when (type) { "lottie_animation" -> { // the ID names the animation file, such as streak_ring.json val file = "$id.json" when { file !in animationFiles -> null // no file for this ID: show the fallback id == "streak_ring" -> AdaptyCustomElementContent.compose { StreakRing(file, streakStore) } // the other animations of your resolver else -> null } } // the other Types of your resolver else -> null }}
Nếu thư mục assets không có file nào khớp với ID, resolver trả về null và người dùng sẽ thấy fallback. Nếu resolver của bạn đã trả về một view cho mọi file animation, hãy trả về view đó thay vì null khi ID không phải là streak_ring. Như vậy, người dùng vẫn thấy các animation của các custom element lottie_animation khác.
public class CustomElementsResolver implements AdaptyCustomElementsResolver { private final StreakStore streakStore; // the animation files in the assets folder, listed once private final Set<String> animationFiles = new HashSet<>(); public CustomElementsResolver(Context context, StreakStore streakStore) { this.streakStore = streakStore; try { String[] files = context.getAssets().list(""); if (files != null) { animationFiles.addAll(Arrays.asList(files)); } } catch (IOException e) { // no list of files: every Lottie element shows the fallback } } @Override public AdaptyCustomElementContent resolve(String type, String id) { if (type.equals("lottie_animation")) { // the ID names the animation file, such as streak_ring.json String file = id + ".json"; if (!animationFiles.contains(file)) { return null; // no file for this ID: show the fallback } if (id.equals("streak_ring")) { return AdaptyCustomElementContent.view( (context, elementContext) -> new StreakRingView(context, file, streakStore) ); } // the other animations of your resolver return null; } // the other Types of your resolver return null; }}
Nếu thư mục assets không có file cho ID đó, resolver trả về null và người dùng sẽ thấy fallback. Nếu resolver của bạn đã trả về view cho mọi file animation, hãy trả về view đó thay vì null khi ID không phải là streak_ring. Như vậy, người dùng vẫn thấy được animation của các custom element lottie_animation khác.
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:
class App : Application() { // the streak model that your app updates val streakStore = StreakStore() // keep this instance: a resolver for one flow can reuse it // lazy: the context isn't attached yet while App is constructed val customElementsResolver by lazy { CustomElementsResolver(this, streakStore) } override fun onCreate() { super.onCreate() AdaptyUI.setCustomElementsResolver(customElementsResolver) }}
public class App extends Application { // the streak model that your app updates private final StreakStore streakStore = new StreakStore(); // keep this instance: a resolver for one flow can reuse it private CustomElementsResolver customElementsResolver; @Override public void onCreate() { super.onCreate(); customElementsResolver = new CustomElementsResolver(this, streakStore); AdaptyUI.setCustomElementsResolver(customElementsResolver); } public StreakStore getStreakStore() { return streakStore; } public CustomElementsResolver getCustomElementsResolver() { return customElementsResolver; }}
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:
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.
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.