动画资源

一个动画资源可以定义以下两种动画类型之一：

属性动画

通过使用 Animator 在设定的时段内修改对象的属性值来创建动画。

视图动画

使用视图动画框架可以创建两种类型的动画：

• 补间动画：通过使用 Animation 对单张图片执行一系列转换来创建动画。
• 帧动画：通过使用 AnimationDrawable 按顺序显示一系列图片来创建动画。

属性动画

在 XML 中定义的动画，用于在设定的一段时间内修改目标对象的属性，例如背景颜色或 alpha 值。

文件位置：

res/animator/filename.xml
文件名用作资源 ID。

编译后的资源数据类型：

指向 ValueAnimator、ObjectAnimator 或 AnimatorSet 的资源指针

资源引用：

在 Java 或 Kotlin 代码中：R.animator.filename
在 XML 中：@[package:]animator/filename

语法：

<set
  android:ordering=["together" | "sequentially"]>

    <objectAnimator
        android:propertyName="string"
        android:duration="int"
        android:valueFrom="float | int | color"
        android:valueTo="float | int | color"
        android:startOffset="int"
        android:repeatCount="int"
        android:repeatMode=["restart" | "reverse"]
        android:valueType=["intType" | "floatType"]/>

    <animator
        android:duration="int"
        android:valueFrom="float | int | color"
        android:valueTo="float | int | color"
        android:startOffset="int"
        android:repeatCount="int"
        android:repeatMode=["restart" | "reverse"]
        android:valueType=["intType" | "floatType"]/>

    <set>
        ...
    </set>
</set>

该文件必须具有一个根元素，可以是 <set>、<objectAnimator> 或 <valueAnimator>。您可以将动画元素（包括其他 <set> 元素）组合到 <set> 元素中。

元素：

<set>

容纳其他动画元素（<objectAnimator>、<valueAnimator> 或其他 <set> 元素）的容器。代表 AnimatorSet。

您可以指定嵌套的 <set> 标记，进一步对动画进行分组。每个 <set> 都可以定义自己的 ordering 属性。

属性：

android:ordering

关键字。指定此集合中动画的播放顺序。

值	说明
sequentially	依序播放此集合中的动画。
together（默认）	同时播放此集合中的动画。

<objectAnimator>

在特定的一段时间内为对象的特定属性创建动画。代表 ObjectAnimator。

属性：

android:propertyName

字符串。必需。要添加动画效果的对象的属性，通过其名称引用。例如，您可以为 View 对象指定 "alpha" 或 "backgroundColor"。但是，objectAnimator 元素不包含 target 属性，因此您无法在 XML 声明中设置要添加动画效果的对象。您必须通过调用 loadAnimator() 来膨胀您的动画 XML 资源，然后调用 setTarget() 来设置包含此属性的目标对象。

android:valueTo

浮点数、整数或颜色。必需。动画属性的结束值。颜色以六位十六进制数字表示，例如 #333333。

android:valueFrom

浮点数、整数或颜色。动画属性的起始值。如果未指定，则动画将从属性的 get 方法获得的值开始。颜色以六位十六进制数字表示，例如 #333333。

android:duration

整数。动画的时间，以毫秒为单位。默认为 300 毫秒。

android:startOffset

整数。调用 start() 后动画延迟的毫秒数。

android:repeatCount

整数。动画的重复次数。设为 "-1" 表示无限次重复，也可设为正整数。例如，值 "1" 表示动画在初次播放后重复播放一次，因此动画总共播放两次。默认值为 "0"，表示不重复。

android:repeatMode

整数。动画播放到结尾处的行为。android:repeatCount 必须设置为正整数或 "-1"，该属性才有效。设置为 "reverse" 可让动画在每次迭代时反向播放，设置为 "restart" 则可让动画每次从头开始循环播放。

android:valueType

关键字。如果值为颜色，则不要指定此属性。动画框架会自动处理颜色值。

值	说明
intType	指定动画值为整数。
floatType（默认）	指定动画值为浮点数。

<animator>

在指定的时间段内执行动画。 代表 ValueAnimator。

属性：

android:valueTo

浮点数、整数或颜色。必需。动画的结束值。颜色以六位十六进制数字表示，例如 #333333。

android:valueFrom

浮点数、整数或颜色。必需。动画的起始值。颜色以六位十六进制数字表示，例如 #333333。

android:duration

整数。动画的时间，以毫秒为单位。默认为 300 毫秒。

android:startOffset

整数。调用 start() 后动画延迟的毫秒数。

android:repeatCount

整数。动画的重复次数。设为 "-1" 表示无限次重复，也可设为正整数。例如，值 "1" 表示动画在初次播放后重复播放一次，因此动画总共播放两次。默认值为 "0"，表示不重复。

android:repeatMode

整数。动画播放到结尾处的行为。android:repeatCount 必须设置为正整数或 "-1"，该属性才有效。设置为 "reverse" 可让动画在每次迭代时反向播放，设置为 "restart" 则可让动画每次从头开始循环播放。

android:valueType

关键字。如果值为颜色，则不要指定此属性。动画框架会自动处理颜色值。

值	说明
intType	指定动画值为整数。
floatType（默认）	指定动画值为浮点数。

示例：

保存在 res/animator/property_animator.xml 的 XML 文件：

<set android:ordering="sequentially">
    <set>
        <objectAnimator
            android:propertyName="x"
            android:duration="500"
            android:valueTo="400"
            android:valueType="intType"/>
        <objectAnimator
            android:propertyName="y"
            android:duration="500"
            android:valueTo="300"
            android:valueType="intType"/>
    </set>
    <objectAnimator
        android:propertyName="alpha"
        android:duration="500"
        android:valueTo="1f"/>
</set>

若要运行此动画，您必须将代码中的 XML 资源膨胀为 AnimatorSet 对象，然后在开始运行动画集之前为所有动画设置目标对象。为方便起见，调用 setTarget() 即可设置一个用于 AnimatorSet 的所有子项的目标对象。以下代码展示了如何执行此操作：

Kotlin

val set: AnimatorSet = AnimatorInflater.loadAnimator(myContext, R.animator.property_animator)
    .apply {
        setTarget(myObject)
        start()
    }

Java

AnimatorSet set = (AnimatorSet) AnimatorInflater.loadAnimator(myContext,
    R.animator.property_animator);
set.setTarget(myObject);
set.start();

另请参阅：

• 属性动画概览
• 有关如何使用属性动画系统的示例，请参阅 API 演示

视图动画

视图动画框架可支持补间动画和逐帧动画，两者都是在 XML 中声明。以下几个部分将介绍如何使用这两种方法。

补间动画

在 XML 中定义的动画，用于对图形执行旋转、淡出、移动和拉伸等转换。

文件位置：

res/anim/filename.xml
文件名用作资源 ID。

编译后的资源数据类型：

指向 Animation 的资源指针

资源引用：

在 Java 中：R.anim.filename
在 XML 中：@[package:]anim/filename

语法：

<?xml version="1.0" encoding="utf-8"?>
<set xmlns:android="http://schemas.android.com/apk/res/android"
    android:interpolator="@[package:]anim/interpolator_resource"
    android:shareInterpolator=["true" | "false"] >
    <alpha
        android:fromAlpha="float"
        android:toAlpha="float" />
    <scale
        android:fromXScale="float"
        android:toXScale="float"
        android:fromYScale="float"
        android:toYScale="float"
        android:pivotX="float"
        android:pivotY="float" />
    <translate
        android:fromXDelta="float"
        android:toXDelta="float"
        android:fromYDelta="float"
        android:toYDelta="float" />
    <rotate
        android:fromDegrees="float"
        android:toDegrees="float"
        android:pivotX="float"
        android:pivotY="float" />
    <set>
        ...
    </set>
</set>

该文件必须具有一个根元素，可以是 <alpha>、<scale>、<translate> 或 <rotate>，也可以是包含一组（或多组）其他动画元素（包括嵌套的 <set> 元素）的 <set> 元素。

元素：

<set>

容纳其他动画元素（<alpha>、<scale>、<translate>、<rotate>）或其他 <set> 元素的容器。代表 AnimationSet。

属性：

android:interpolator

插值器资源。要应用于动画的 Interpolator。该值必须是对指定插值器的资源的引用，而不是插值器类名称。您可以使用平台提供的默认插值器资源，也可以创建自己的插值器资源。如需详细了解插值器，请参阅以下论述。

android:shareInterpolator

布尔值。如果要在所有子元素中共用同一插值器，则为 "true"。

<alpha>

淡入或淡出动画。代表 AlphaAnimation。

属性：

android:fromAlpha

浮点数。起始不透明度偏移，0.0 表示透明，1.0 表示不透明。

android:toAlpha

浮点数。结束不透明度偏移，0.0 表示透明，1.0 表示不透明。

如要了解 <alpha> 支持的更多属性，请参阅 Animation 的类引用，其 XML 属性会被此元素继承。

<scale>

调整大小的动画。您可以通过指定 pivotX 和 pivotY，来指定图片向外或向内扩展的中心点。例如，如果这两个值为 0,0（即左上角），则所有扩展都是向下和向右进行的。代表 ScaleAnimation。

属性：

android:fromXScale

浮点数。起始 X 尺寸偏移，其中 1.0 表示不变。

android:toXScale

浮点数。结束 X 尺寸偏移，其中 1.0 表示不变。

android:fromYScale

浮点数。起始 Y 尺寸偏移，其中 1.0 表示不变。

android:toYScale

浮点数。结束 Y 尺寸偏移，其中 1.0 表示不变。

android:pivotX

浮点数。在对象缩放时要保持不变的 X 坐标。

android:pivotY

浮点数。在对象缩放时要保持不变的 Y 坐标。

如要了解 <scale> 支持的更多属性，请参阅 Animation 的类引用，其 XML 属性会被此元素继承。

<translate>

竖直和/或水平移动。代表 TranslateAnimation。 支持这三种格式中任何一种的以下属性：

• 从 -100 到 100 的以“%”结尾的值，表示相对于自身的百分比。
• 从 -100 到 100 的以“%p”结尾的值，表示相对于其父项的百分比。
• 不带后缀的浮点值，表示绝对值。

属性：

android:fromXDelta

浮点数或百分比。起始 X 偏移量。表示方式：相对于正常位置的像素数（例如 "5"）；相对于元素宽度的百分比（例如 "5%"）；或相对于父项宽度的百分比（例如 "5%p"）。

android:toXDelta

浮点数或百分比。结束 X 偏移量。表示方式：相对于正常位置的像素数（例如 "5"）；相对于元素宽度的百分比（例如 "5%"）；或相对于父项宽度的百分比（例如 "5%p"）。

android:fromYDelta

浮点数或百分比。起始 Y 偏移量。表示方式：相对于正常位置的像素数（例如 "5"）；相对于元素高度的百分比（例如 "5%"）；或相对于父项高度的百分比（例如 "5%p"）。

android:toYDelta

浮点数或百分比。结束 Y 偏移量。表示方式：相对于正常位置的像素数（例如 "5"）；相对于元素高度的百分比（例如 "5%"）；或相对于父项高度的百分比（例如 "5%p"）。

如要了解 <translate> 支持的更多属性，请参阅 Animation 的类引用，其 XML 属性会被此元素继承。

<rotate>

旋转动画。代表 RotateAnimation。

属性：

android:fromDegrees

浮点数。起始角度位置，以度为单位。

android:toDegrees

浮点数。结束角度位置，以度为单位。

android:pivotX

浮点数或百分比。旋转中心的 X 坐标。表示方式：相对于对象左边缘的像素数（例如 "5"）；相对于对象左边缘的百分比（例如 "5%"）；或相对于父级容器左边缘的百分比（例如 "5%p"）。

android:pivotY

浮点数或百分比。旋转中心的 Y 坐标。表示方式：相对于对象上边缘的像素数（例如 "5"）；相对于对象上边缘的百分比（例如 "5%"）；或相对于父级容器上边缘的百分比（例如 "5%p"）。

如要了解 <rotate> 支持的更多属性，请参阅 Animation 的类引用，其 XML 属性会被此元素继承。

示例：

保存在 res/anim/hyperspace_jump.xml 的 XML 文件：

<set xmlns:android="http://schemas.android.com/apk/res/android"
    android:shareInterpolator="false">
    <scale
        android:interpolator="@android:anim/accelerate_decelerate_interpolator"
        android:fromXScale="1.0"
        android:toXScale="1.4"
        android:fromYScale="1.0"
        android:toYScale="0.6"
        android:pivotX="50%"
        android:pivotY="50%"
        android:fillAfter="false"
        android:duration="700" />
    <set
        android:interpolator="@android:anim/accelerate_interpolator"
        android:startOffset="700">
        <scale
            android:fromXScale="1.4"
            android:toXScale="0.0"
            android:fromYScale="0.6"
            android:toYScale="0.0"
            android:pivotX="50%"
            android:pivotY="50%"
            android:duration="400" />
        <rotate
            android:fromDegrees="0"
            android:toDegrees="-45"
            android:toYScale="0.0"
            android:pivotX="50%"
            android:pivotY="50%"
            android:duration="400" />
    </set>
</set>

以下应用代码会将动画应用到 ImageView 并启动动画：

Kotlin

val image: ImageView = findViewById(R.id.image)
val hyperspaceJump: Animation = AnimationUtils.loadAnimation(this, R.anim.hyperspace_jump)
image.startAnimation(hyperspaceJump)

Java

ImageView image = (ImageView) findViewById(R.id.image);
Animation hyperspaceJump = AnimationUtils.loadAnimation(this, R.anim.hyperspace_jump);
image.startAnimation(hyperspaceJump);

另请参阅：

• 视图动画

插值器

插值器是在 XML 中定义的一种影响动画变化速率的动画修改器，可让现有的动画效果加速、减速、重复、弹跳等。

插值器通过 android:interpolator 属性应用于动画元素，该属性的值是对插值器资源的引用。

Android 中提供的所有插值器都是 Interpolator 类的子类。为便于您使用 android:interpolator 属性将插值器应用于动画，Android 针对每个插值器类包含了一个可供您引用的公共资源。下表指定了每个插值器要使用的资源：

插值器类	资源 ID
AccelerateDecelerateInterpolator	@android:anim/accelerate_decelerate_interpolator
AccelerateInterpolator	@android:anim/accelerate_interpolator
AnticipateInterpolator	@android:anim/anticipate_interpolator
AnticipateOvershootInterpolator	@android:anim/anticipate_overshoot_interpolator
BounceInterpolator	@android:anim/bounce_interpolator
CycleInterpolator	@android:anim/cycle_interpolator
DecelerateInterpolator	@android:anim/decelerate_interpolator
LinearInterpolator	@android:anim/linear_interpolator
OvershootInterpolator	@android:anim/overshoot_interpolator

您可以通过以下方式使用 android:interpolator 属性应用上述某个插值器：

<set android:interpolator="@android:anim/accelerate_interpolator">
    ...
</set>

自定义插值器

如果您对平台提供的插值器不满意，则可以使用修改过的属性创建自定义插值器资源。例如，您可以调整 AnticipateInterpolator 的加速率或调整 CycleInterpolator 的循环次数。为此，您可以在 XML 文件中创建自己的插值器资源。

文件位置：

res/anim/filename.xml
文件名用作资源 ID。

编译后的资源数据类型：

指向相应插值器对象的资源指针。

资源引用：

在 XML 中：@[package:]anim/filename

语法：

<?xml version="1.0" encoding="utf-8"?>
<InterpolatorName xmlns:android="http://schemas.android.com/apk/res/android"
    android:attribute_name="value"
    />

如果您不应用任何属性，则该插值器的运作方式与上表所列平台提供的插值器完全相同。

元素：

请注意，在 XML 中定义的每个 Interpolator 实现的名称都以小写字母开头。

<accelerateDecelerateInterpolator>

变化率在开始和结束时缓慢，但在中间会加快。

无属性。

<accelerateInterpolator>

变化率在开始时较为缓慢，然后会加快。

属性：

android:factor

浮点数。加速率。默认值为 1。

<anticipateInterpolator>

先反向变化，然后再急速正向变化。

属性：

android:tension

浮点数。要应用的张力。默认值为 2。

<anticipateOvershootInterpolator>

先反向变化，再急速正向变化并超过目标值，然后以最终值结束。

属性：

android:tension

浮点数。要应用的张力。默认值为 2。

android:extraTension

浮点数。张力要乘以的倍数。默认值为 1.5。

<bounceInterpolator>

变化会在结束时退回。

无属性。

<cycleInterpolator>

按指定的循环次数重复动画。变化率符合正弦曲线图。

属性：

android:cycles

整数。循环次数。默认值为 1。

<decelerateInterpolator>

变化率开始时很快，然后减速。

属性：

android:factor

浮点数。减速率。默认值为 1。

<linearInterpolator>

变化率恒定不变。

无属性。

<overshootInterpolator>

先急速正向变化，再超过最终值，然后回到最终值。

属性：

android:tension

浮点数。要应用的张力。默认值为 2。

示例：

保存在 res/anim/my_overshoot_interpolator.xml 的 XML 文件：

<?xml version="1.0" encoding="utf-8"?>
<overshootInterpolator xmlns:android="http://schemas.android.com/apk/res/android"
    android:tension="7.0"
    />

此动画 XML 会应用插值器：

<scale xmlns:android="http://schemas.android.com/apk/res/android"
    android:interpolator="@anim/my_overshoot_interpolator"
    android:fromXScale="1.0"
    android:toXScale="3.0"
    android:fromYScale="1.0"
    android:toYScale="3.0"
    android:pivotX="50%"
    android:pivotY="50%"
    android:duration="700" />

帧动画

在 XML 中定义的按顺序显示一系列图片的动画（如电影）。

文件位置：

res/drawable/filename.xml
文件名用作资源 ID。

编译后的资源数据类型：

指向 AnimationDrawable 的资源指针

资源引用：

在 Java 中：R.drawable.filename
在 XML 中：@[package:]drawable.filename

语法：

<?xml version="1.0" encoding="utf-8"?>
<animation-list xmlns:android="http://schemas.android.com/apk/res/android"
    android:oneshot=["true" | "false"] >
    <item
        android:drawable="@[package:]drawable/drawable_resource_name"
        android:duration="integer" />
</animation-list>

元素：

<animation-list>

必需。该元素必须是根元素。包含一个或多个 <item> 元素。

属性：

android:oneshot

布尔值。如果您想要执行一次动画，则为 "true"；如果要循环播放动画，则为 "false"。

<item>

单帧动画。必须为 <animation-list> 元素的子项。

属性：

android:drawable

可绘制资源。要用于此帧的可绘制对象。

android:duration

整数。显示此帧的持续时间，以毫秒为单位。

示例：

保存在 res/drawable/rocket_thrust.xml 的 XML 文件：

<?xml version="1.0" encoding="utf-8"?>
<animation-list xmlns:android="http://schemas.android.com/apk/res/android"
    android:oneshot="false">
    <item android:drawable="@drawable/rocket_thrust1" android:duration="200" />
    <item android:drawable="@drawable/rocket_thrust2" android:duration="200" />
    <item android:drawable="@drawable/rocket_thrust3" android:duration="200" />
</animation-list>

以下应用代码会将该动画设置为 View 的背景，然后播放动画：

Kotlin

val rocketImage: ImageView = findViewById(R.id.rocket_image)
rocketImage.setBackgroundResource(R.drawable.rocket_thrust)

val rocketAnimation = rocketImage.background
if (rocketAnimation is Animatable) {
    rocketAnimation.start()
}

Java

ImageView rocketImage = (ImageView) findViewById(R.id.rocket_image);
rocketImage.setBackgroundResource(R.drawable.rocket_thrust);

rocketAnimation = rocketImage.getBackground();
if (rocketAnimation instanceof Animatable) {
    ((Animatable)rocketAnimation).start();
}

另请参阅：

• 视图动画