Lottieアニメーションでユーザーの進捗状況を表示する

このレシピでは、ユーザーの進捗状況をLottieアニメーションとして表示する方法を紹介します。たとえば、デイリーストリークを示すリングが徐々に塗りつぶされるようなアニメーションです。アプリはカスタム要素でアニメーションをネイティブのLottieビューとしてレンダリングします。

始める前に

Lottie アニメーションを .json 形式で用意するか、サンプルの streak_ring.json をダウンロードしてください。アプリはアニメーションを最初から再生し、進捗に応じて停止します(例:50% の場合は中間で停止)。正確な進捗を表示するには、アニメーションに次の条件が必要です。

  • 最初のフレームで進捗がゼロ、最後のフレームで進捗が 100%。
  • 一定の速度(イージングなし)。アニメーションがゆっくり始まって加速する場合、中間時点では 50% 未満しか表示されません。

1. カスタム要素をスクリーンに追加する

フロー&ペイウォールビルダーで、フロー画面にカスタム要素を追加して、アニメーション用に設定します:

  • Type:lottie_animation
  • ID:streak_ring。このレシピでは、IDはアニメーションファイル名と同じです。
  • Height:デフォルトの Fixed の高さをそのまま使用します。アニメーションはカスタム要素に合わせてスケーリングされます。

カスタム要素の内部に、リングの静止画像を持つ Image を追加します。アプリのバージョンがアニメーションを再生できないユーザーには、これがフォールバックとして表示されます。

2. アプリにアニメーションファイルを追加する

アニメーションファイルを src/main/assets(アプリモジュールの assets フォルダ)に配置してください。サブフォルダではなく、このフォルダのルートに置いてください。

.json を除いたファイル名は、カスタム要素のIDと一致させる必要があります。たとえば streak_ring の場合は streak_ring.json となります。

3. アニメーションビューを作成する

ストリークのモデルと、アニメーションを再生するビューを作成します。ストリークが変化すると、アプリはモデルを更新します。ビューはモデルを参照するため、画面を開いたときにリングが現在のストリークを表示します。

4. アニメーションをカスタム要素に対応付ける

アプリ全体のリゾルバーに、ストリークモデル用のプロパティを追加します。次に、Type が lottie_animation、ID が streak_ring のビューに対してアニメーションビューを返します。ハイライトされた行が追加・変更箇所です。アプリにまだアプリ全体のリゾルバーがない場合は、コード全体をコピーしてください。

ストリークモデルを使ってリゾルバーを作成し、アプリ全体のリゾルバーとして設定します。AdaptyUI.setCustomElementsResolver はアプリ起動時など、一度だけ呼び出してください:

5. デバイスでテストする

フロー&ペイウォールビルダーはアプリのコードを実行できないため、キャンバスにはフォールバックのみが表示されます。アニメーションをプレビューするには:

  1. フローを公開します。キャッシュされたバージョンではなく、最新の公開バージョンを確認するには、デバイスをテストデバイスとして登録してください。
  2. リゾルバーを含むアプリのビルドを実行します。ストリークを0日に設定して画面を開き、リングが空のままであることを確認します。4日と7日でも同様に繰り返し、リングがそれぞれの値まで満たされることを確認します。

フォールバックをテストするには、ビルドからアニメーションファイルを削除し、再度画面を開きます。

フォールバックがアニメーションの代わりに表示される原因を調べるには、Androidガイドのデバイスでテストするセクションの手順に従ってください。