使用投掷动画移动视图

试用 Compose 方式
Jetpack Compose 是推荐用于 Android 的界面工具包。了解如何在 Compose 中使用动画。

投掷动画使用与对象速度成正比的摩擦力。使用它可为对象的属性添加动画效果,并逐步结束动画。它具有一个初始动量,主要从手势速度获得,然后逐渐减慢。当动画速度足够低,在设备屏幕上没有明显变化时,动画便会结束。

图 1. 投掷动画

要了解相关主题,请参阅以下指南:

添加 AndroidX 库

要使用基于物理特性的动画,您必须将 AndroidX 库添加到项目中,如下所示:

  1. 打开应用模块的 build.gradle 文件。
  2. 将 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/秒”为单位指定值,则速度与设备的密度和外形规格无关。如需详细了解如何将起始速度转换为“像素/秒”,请参阅弹簧动画中的将“dp/秒”转换为“像素/秒”部分。

如需设置速度,请调用 setStartVelocity() 方法并传递速度(以“像素/秒”为单位)。该方法会返回设置了速度的快滑对象。

注意:请使用 GestureDetector.OnGestureListenerVelocityTracker 类分别检索和计算触摸手势的速度。

设置动画值的范围

如果要将属性值限制在特定范围内,您可以设置动画的最小值和最大值。当您为具有固有范围的属性(如 alpha [从 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_XTRANSLATION_YTRANSLATION_ZSCROLL_XSCROLL_Y 等视图属性,默认的最小可见变化值为 1 像素。
  • 对于使用旋转的动画(例如 ROTATIONROTATION_XROTATION_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 像素。