Lottie animasyonuyla kullanıcı ilerlemesini göster

Kullanıcının ilerlemesini bir Lottie animasyonu olarak göstermek için bu tarifi takip edin — örneğin, günlük serisini göstermek için dolan bir halka. Uygulamanız animasyonu bir özel element içinde yerel bir Lottie görünümü olarak render eder.

Başlamadan önce

.json formatında bir Lottie animasyonu hazırlayın ya da örnek streak_ring.json dosyasını indirin. Uygulama animasyonu baştan oynatır ve ilerlemeyle orantılı olarak durdurur; örneğin %50 için tam ortasında durur. Tam ilerlemeyi göstermek için animasyonun şu özelliklere sahip olması gerekir:

  • İlk karede hiç ilerleme olmamalı, son karede ise tam ilerleme gösterilmeli.
  • Sabit bir hız, yumuşatma (easing) olmadan. Animasyon yavaş başlayıp hızlanırsa, yarı yolda gerçek ilerlemenin yarısından daha azını gösterir.

1. Özel öğeyi ekrana ekleyin

Flow & Paywall Builder’da, bir flow ekranına özel element ekleyin ve animasyon için yapılandırın:

  • Type: lottie_animation.
  • ID: streak_ring. Bu tarifde ID, aynı zamanda animasyon dosyasının adıdır.
  • Height: Varsayılan Fixed yüksekliği koruyun. Animasyon, özel elementin boyutuna göre ölçeklenir.

Özel elementin içine, halkanın hareketsiz bir görüntüsünü içeren bir Image ekleyin. Kullanıcılar, uygulamanızın animasyonu oynatamayan sürümlerinde bunu yedek içerik olarak görür.

2. Animasyon dosyasını uygulamanıza ekleyin

Animasyon dosyasını uygulama modülünüzün assets klasörü olan src/main/assets dizinine koyun. Dosyayı bu klasörün kökünde tutun, bir alt klasöre koymayın.

.json uzantısı olmadan dosya adı, özel öğenin ID’siyle eşleşmelidir; örneğin streak_ring için streak_ring.json.

3. Animasyon görünümünü oluşturun

Streak için bir model ve animasyonu oynatacak bir görünüm oluşturun. Uygulamanız streak değiştiğinde modeli günceller. Görünüm modeli okuduğundan, ekran açıldığında halka mevcut streak’i gösterir:

4. Animasyonu özel elemente bağla

Uygulama genelindeki resolver’ınıza, streak modeli için bir özellik ekleyin. Ardından lottie_animation Type’ı ve streak_ring ID’si için animasyon view’ını döndürün. Vurgulanan satırlar eklenecek veya değiştirilecek kısımları göstermektedir. Uygulamanızda henüz uygulama genelinde bir resolver yoksa tüm kodu kopyalayabilirsiniz:

Streak modeliyle resolver’ı oluşturun ve uygulama genelinde geçerli resolver olarak ayarlayın. AdaptyUI.setCustomElementsResolver fonksiyonunu, örneğin uygulama başlangıcında, bir kez çağırın:

5. Cihazda test etme

Flow & Paywall Builder, uygulama kodunuzu çalıştıramadığından canvas yalnızca yedek içeriği gösterir. Animasyonu önizlemek için:

  1. Flow’u yayınlayın. Önbelleğe alınmış sürüm yerine en son yayınlanan sürümü görmek için cihazı bir test cihazı olarak kaydedin.
  2. Resolver’ı içeren bir uygulama derlemesi çalıştırın. Streak’i 0 güne ayarlayın, ekranı açın ve halkının boş kaldığını doğrulayın. 4 ve 7 gün ile tekrarlayın ve halkının her değere kadar dolduğunu doğrulayın.

Yedek içeriği test etmek için animasyon dosyasını derlemeden kaldırın ve ekranı tekrar açın.

Animasyon yerine neden yedek göründüğünü öğrenmek için Android kılavuzunun Cihazda test etme bölümündeki talimatları izleyin.