フリングベースのアニメーションでは、オブジェクトの速度に比例する摩擦力が使用されます。オブジェクトのプロパティをアニメーション化し、アニメーションを徐々に終了するために使用します。初期の勢いを持ち、そのほとんどは操作の速度で受け止められ、徐々に遅くなります。アニメーションの速度が遅くなり、デバイス画面に変化が見られない場合、アニメーションは終了します。
関連トピックについては、次のガイドをご覧ください。
AndroidX ライブラリを追加する
物理ベースのアニメーションを使用するには、次のように AndroidX ライブラリをプロジェクトに追加する必要があります。
- アプリ モジュールの
build.gradleファイルを開きます。 dependenciesセクションに AndroidX ライブラリを追加します。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/秒で値を定義すると、速度をデバイスの密度やフォーム ファクタから独立させることができます。開始速度をピクセル/秒に変換する方法については、スプリング アニメーションの dp/秒をピクセル/秒に変換するをご覧ください。
速度を設定するには、setStartVelocity() メソッドを呼び出して、速度をピクセル/秒で渡します。このメソッドは、速度が設定されているフリング オブジェクトを返します。
注: タッチ操作の速度を取得および計算するには、GestureDetector.OnGestureListener クラスと VelocityTracker クラスをそれぞれ使用してください。
アニメーションの値の範囲を設定する
プロパティ値を特定の範囲に制限する場合は、アニメーションの最小値と最大値を設定できます。この範囲コントロールは、アルファ（0 ～ 1）などの固有の範囲を持つプロパティをアニメーション化する場合に特に便利です。
注: フリング アニメーションの値が最小値または最大値に達すると、アニメーションは終了します。
最小値と最大値を設定するには、それぞれ setMinValue() メソッドと setMaxValue() メソッドを呼び出します。どちらのメソッドも、値を設定したアニメーション オブジェクトを返します。
摩擦を設定する
setFriction() メソッドを使用すると、アニメーションの摩擦を変更できます。アニメーションで速度が減少する速さを定義します。
注: アニメーションの最初に摩擦を設定しなかった場合、アニメーションはデフォルトの摩擦値である 1 を使用します。
このメソッドは、指定した摩擦値をアニメーションで使用するオブジェクトを返します。
サンプルコード
次の例は、水平方向のフリングを示しています。速度トラッカーからキャプチャされる速度は velocityX で、スクロール境界は 0 と maxScroll に設定されています。この摩擦は 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 ピクセルに等しくなります。