フリングベースのアニメーションでは、物体の速度に比例する摩擦力を使用します。オブジェクトのプロパティをアニメーション化し、アニメーションを段階的に終了するために使用します。初期のモメンタムは主に操作の速度から受け取り、徐々に遅くなります。アニメーションの速度が十分に小さく、デバイス画面に目に見える変化がなくなると、アニメーションは終了します。
![](https://developer.android.com/static/images/guide/topics/graphics/fling-animation.gif?authuser=8&hl=ja)
関連トピックについては、次のガイドをご覧ください。
AndroidX ライブラリを追加する
物理ベースのアニメーションを使用するには、次のように AndroidX ライブラリをプロジェクトに追加する必要があります。
- アプリ モジュールの
build.gradle
ファイルを開きます。 - AndroidX ライブラリを
dependencies
セクションに追加します。Groovy
dependencies { implementation 'androidx.dynamicanimation:dynamicanimation:1.0.0' }
Kotlin
dependencies { implementation("androidx.dynamicanimation:dynamicanimation:1.0.0") }
フリング アニメーションを作成する
FlingAnimation
クラスを使用すると、オブジェクトのフリング アニメーションを作成できます。フリング アニメーションを作成するには、FlingAnimation
クラスのインスタンスを作成し、アニメーション化するオブジェクトとオブジェクトのプロパティを指定します。
Kotlin
val fling = FlingAnimation(view, DynamicAnimation.SCROLL_X)
Java
FlingAnimation fling = new FlingAnimation(view, DynamicAnimation.SCROLL_X);
速度を設定する
開始速度は、アニメーションの開始時にアニメーション プロパティが変化する速度を定義します。デフォルトの開始速度は 0 ピクセル/秒に設定されています。したがって、アニメーションがすぐに終了しないように、開始速度を定義する必要があります。
開始速度として固定値を使用することも、タップ操作の速度に基づいて設定することもできます。固定値を指定する場合は、dp/秒で値を定義してから、ピクセル/秒に変換する必要があります。dp/秒で値を定義すると、速度をデバイスの密度やフォーム ファクタに依存させることができます。開始速度を 1 秒あたりのピクセル数に変換する方法については、スプリング アニメーションの dp/秒をピクセル/秒に変換するを参照してください。
速度を設定するには、setStartVelocity()
メソッドを呼び出し、ピクセル/秒単位で速度を渡します。このメソッドは、速度が設定されているフリング オブジェクトを返します。
注: タッチ操作の速度の取得と計算には、それぞれ GestureDetector.OnGestureListener
クラスと VelocityTracker
クラスを使用します。
アニメーションの値の範囲を設定する
プロパティ値を特定の範囲に制限する場合は、アニメーションの最小値と最大値を設定できます。この範囲コントロールは、アルファ(0 ~ 1)などの固有の範囲を持つプロパティをアニメーション化する場合に特に便利です。
注: フリング アニメーションの値が最小値または最大値に達すると、アニメーションは終了します。
最小値と最大値を設定するには、それぞれ setMinValue()
メソッドと setMaxValue()
メソッドを呼び出します。どちらのメソッドも、値を設定したアニメーション オブジェクトを返します。
摩擦を設定する
setFriction()
メソッドを使用すると、アニメーションの摩擦を変更できます。アニメーションで速度が減少する速さを定義します。
注: アニメーションの開始時に摩擦を設定しない場合、アニメーションではデフォルトの摩擦値 1 が使用されます。
このメソッドは、指定した摩擦値を使用するアニメーションのオブジェクトを返します。
サンプルコード
次の例は、水平方向のフリングを示しています。速度トラッカーから取得される速度は velocityX
で、スクロール境界は 0 と max スクロールに設定されています。摩擦は 1.1 に設定されています。
Kotlin
FlingAnimation(view, DynamicAnimation.SCROLL_X).apply { setStartVelocity(-velocityX) setMinValue(0f) setMaxValue(maxScroll) friction = 1.1f start() }
Java
FlingAnimation fling = new FlingAnimation(view, DynamicAnimation.SCROLL_X); fling.setStartVelocity(-velocityX) .setMinValue(0) .setMaxValue(maxScroll) .setFriction(1.1f) .start();
最小表示変更を設定する
ピクセル単位で定義されていないカスタム プロパティをアニメーション化する場合は、ユーザーに表示されるアニメーション値の最小変更を設定する必要があります。アニメーションを終了するための適切なしきい値を決定します。
可視変化の最小値はプロパティから取得されるため、DynamicAnimation.ViewProperty
をアニメーション化するときにこのメソッドを呼び出す必要はありません。たとえば、次のようになります。
TRANSLATION_X
、TRANSLATION_Y
、TRANSLATION_Z
、SCROLL_X
、SCROLL_Y
などのビュー プロパティの場合、デフォルトの最小表示変更値は 1 ピクセルです。- 回転を使用するアニメーション(
ROTATION
、ROTATION_X
、ROTATION_Y
など)の場合、最小表示変化はMIN_VISIBLE_CHANGE_ROTATION_DEGREES
(1/10 ピクセル)です。 - 不透明度を使用するアニメーションの場合、最小表示変化は
MIN_VISIBLE_CHANGE_ALPHA
(1/256)です。
アニメーションの最小表示変更を設定するには、setMinimumVisibleChange()
メソッドを呼び出し、最小表示定数か、カスタム プロパティの計算に必要な値のいずれかを渡します。この値の計算について詳しくは、最小表示変化値の計算セクションをご覧ください。
Kotlin
anim.minimumVisibleChange = DynamicAnimation.MIN_VISIBLE_CHANGE_SCALE
Java
anim.setMinimumVisibleChange(DynamicAnimation.MIN_VISIBLE_CHANGE_SCALE);
注: 値は、ピクセル単位で定義されていないカスタム プロパティをアニメーション化する場合にのみ渡す必要があります。
最小表示変更値の計算
カスタム プロパティの可視変化の最小値を計算するには、次の数式を使用します。
最小表示変化 = カスタム プロパティ値の範囲 / アニメーションの範囲(ピクセル単位)
たとえば、アニメーション化するプロパティが 0 から 100 に変化した場合、これが 200 ピクセルの変化に対応します。この数式により、可視変化の最小値は 100 / 200 で 0.5 ピクセルに等しくなります。