Property Animation: что это, ObjectAnimator и ValueAnimator

Что такое Property Animation?

Property Animation — это фреймворк в Android SDK (пакет android.animation), который анимирует любые свойства любого объекта (View, Drawable, кастомный класс) за указанное время. В отличие от View Animation, которая работает только с View и меняет лишь визуальное представление (matrix transform), Property Animation изменяет реальные поля объекта. Это значит, что после анимации translationX объект действительно находится на новой позиции, и клики обрабатываются в новом месте.

Архитектура Property Animation построена на трёх ключевых классах: ValueAnimator — базовый генератор значений, ObjectAnimator — подкласс для привязки к свойству объекта, AnimatorSet — оркестратор для групповой анимации. Все три поддерживают Interpolator (кривая скорости) и TypeEvaluator (правило интерполяции между значениями).

По данным Android Performance Patterns (Google, 2025), Property Animation работает на частоте до 60 FPS при правильно настроенном Interpolator и отсутствии тяжёлых вычислений в onAnimationUpdate(). Для сложных анимаций (3D, физика) рекомендуется RenderThread (RenderNode Animations) в Android 12+. Property Animation остаётся основным выбором для анимации свойств View — translationX, rotationY, scaleX, alpha и других.

ObjectAnimator: анимация свойств объекта

ObjectAnimator — самый популярный класс Property Animation. Он наследуется от ValueAnimator и автоматически вызывает setter указанного свойства объекта с анимированными значениями. Для работы ObjectAnimator требуется, чтобы у объекта был публичный setter для анимируемого свойства (например, setTranslationX(float) для свойства «translationX»).

import android.animation.ObjectAnimator
import android.view.View

// ObjectAnimator для translationX
val animator = ObjectAnimator.ofFloat(
    myView,
    "translationX",
    0f,
    300f
).apply {
    duration = 500L
    startDelay = 200L
    repeatCount = 1
    repeatMode = ValueAnimator.REVERSE
    interpolator = FastOutSlowInInterpolator()
    start()
}

Поддерживаемые свойства View: translationX, translationY, translationZ, rotation, rotationX, rotationY, scaleX, scaleY, alpha, x, y, elevation. ObjectAnimator.ofFloat() используется для float-свойств, ofInt() — для int, ofObject() — для кастомных типов (цвет, точка). Для анимации цвета используйте ofObject() с ArgbEvaluator или HsvEvaluator.

// ObjectAnimator с кастомным TypeEvaluator (цвет)
import android.animation.ObjectAnimator
import android.animation.ArgbEvaluator
import android.graphics.Color

val colorAnim = ObjectAnimator.ofObject(
    myView,
    "backgroundColor",
    ArgbEvaluator(),
    Color.BLUE,
    Color.RED
).apply {
    duration = 1000L
    repeatCount = ValueAnimator.INFINITE
    repeatMode = ValueAnimator.REVERSE
    start()
}

// Анимация нескольких свойств одновременно
val scaleXAnim = ObjectAnimator.ofFloat(myView, "scaleX", 1f, 1.5f)
val scaleYAnim = ObjectAnimator.ofFloat(myView, "scaleY", 1f, 1.5f)
val alphaAnim = ObjectAnimator.ofFloat(myView, "alpha", 1f, 0.5f)

AnimatorListener — интерфейс для отслеживания событий анимации: onAnimationStart, onAnimationEnd, onAnimationCancel, onAnimationRepeat. Используйте AnimatorListenerAdapter для переопределения только нужных методов. Начиная с Android 12, добавлен Animator.AnimationCallback с поддержкой корутин через suspendAnimationFrame.

ValueAnimator: генерация анимированных значений

ValueAnimator — базовый класс Property Animation, который генерирует анимированные значения от start до end за заданное время. В отличие от ObjectAnimator, ValueAnimator не привязан к объекту — он просто вычисляет промежуточные значения и уведомляет об этом через слушателя. Разработчик сам решает, что делать с полученными значениями: установить свойство View, изменить параметр Drawable, обновить кастомную отрисовку в onDraw().

import android.animation.ValueAnimator
import android.view.animation.LinearInterpolator

"> ValueAnimator: анимация прогресса загрузки
val valueAnimator = ValueAnimator.ofFloat(0f, 100f).apply {
    duration = 2000L
    interpolator = LinearInterpolator()
    repeatCount = ValueAnimator.INFINITE

    addUpdateListener { animator ->
        val progress = animator.animatedValue as Float
        progressBar.progress = progress.toInt()
        progressText.text = "${progress.toInt()}%"
    }

    addListener(object : AnimatorListenerAdapter() {
        override fun onAnimationRepeat(animation: Animator) {
            Log.d("Anim", "Progress animation restarted")
        }
    })
    start()
}

ValueAnimator.ofInt() — используется для целочисленных свойств (ширина, высота, количество шагов). ValueAnimator.ofObject() — для кастомных типов с TypeEvaluator. ValueAnimator.ofPropertyValuesHolder() — для параллельной анимации нескольких свойств с одним таймером, что экономит ресурсы по сравнению с отдельными Animator для каждого свойства.

// ValueAnimator.ofObject с PointEvaluator
import android.animation.ValueAnimator
import android.graphics.PointF
import android.animation.PointFEvaluator

val pointAnim = ValueAnimator.ofObject(
    PointFEvaluator(),
    PointF(0f, 0f),
    PointF(300f, 500f)
).apply {
    duration = 1000L
    addUpdateListener { animator ->
        val point = animator.animatedValue as PointF
        movingView.x = point.x
        movingView.y = point.y
    }
    start()
}

Производительность ValueAnimator: при частоте 60 FPS onAnimationUpdate вызывается каждые ~16.7 мс. Избегайте внутри слушателя: аллокации объектов (создавайте PointF/RectF один раз), вызова findViewById(), тяжёлых вычислений (файловый ввод-вывод, сеть). Для анимации 20+ одновременных элементов используйте PropertyValuesHolder в одном Animator вместо 20 отдельных Animator. Для анимации с изменением размера используйте View.setLayoutParams() только в конце анимации (через AnimatorListenerAdapter.onAnimationEnd).

AnimatorSet: композиция анимаций

AnimatorSet — оркестратор, который позволяет запускать несколько Animator (ObjectAnimator, ValueAnimator) в определённом порядке: последовательно (playSequentially), параллельно (playTogether), с задержками (after, before, with). AnimatorSet поддерживает вложенность — AnimatorSet может содержать другие AnimatorSet для сложных сценариев.

import android.animation.AnimatorSet
import android.animation.ObjectAnimator

// AnimatorSet: последовательная и параллельная анимация
val fadeIn = ObjectAnimator.ofFloat(myView, "alpha", 0f, 1f)
val slideUp = ObjectAnimator.ofFloat(myView, "translationY", 100f, 0f)
val bounce = ObjectAnimator.ofFloat(myView, "scaleX", 1f, 1.1f, 1f)

val animatorSet = AnimatorSet().apply {
    // Параллельно: fadeIn + slideUp
    play(fadeIn).with(slideUp)
    "> После: bounce с задержкой 200ms
    play(bounce).after(200L)

    duration = 400L
    interpolator = FastOutSlowInInterpolator()
    addListener(object : AnimatorListenerAdapter() {
        override fun onAnimationEnd(animation: Animator) {
            Log.d("Anim", "Set completed")
        }
    })
    start()
}

AnimatorSet.Builder предоставляет fluent API для построения цепочек: with() — параллельно, before() — до, after() — после. AnimatorSet поддерживает cancel() для остановки всех анимаций в сете. Для сложных сценариев (25+ аниматоров) используйте PropertyValuesHolder — он производительнее, так как использует один общий таймер вместо отдельных для каждого Animator.

Interpolator и TypeEvaluator: управление скоростью и типом

Interpolator определяет кривую изменения скорости анимации от 0 до 1. Android предоставляет встроенные Interpolator: LinearInterpolator (равномерно), AccelerateDecelerateInterpolator (медленно-быстро-медленно), FastOutSlowInInterpolator (Material Design), OvershootInterpolator (с перелётом цели), BounceInterpolator (с отскоком), AnticipateOvershootInterpolator (с откатом назад перед началом и перелётом цели). Кастомный Interpolator реализуется через TimeInterpolator.

import android.animation.ObjectAnimator
import android.view.animation.BounceInterpolator
import android.view.animation.OvershootInterpolator
import android.view.animation.AnticipateOvershootInterpolator

// BounceInterpolator — эффект отскока в конце
val bounceAnim = ObjectAnimator.ofFloat(myView, "translationY", 0f, -50f).apply {
    duration = 600L
    interpolator = BounceInterpolator()
    start()
}

// AnticipateOvershoot — откат назад, затем перелёт
val anticipateAnim = ObjectAnimator.ofFloat(myView, "scaleX", 1f, 1.3f).apply {
    duration = 500L
    interpolator = AnticipateOvershootInterpolator(2.0f)
    start()
}

TypeEvaluator — интерфейс с методом evaluate(fraction, startValue, endValue), который вычисляет промежуточное значение между start и end. Встроенные: ArgbEvaluator (цвет int), FloatEvaluator, IntEvaluator, PointFEvaluator, RectEvaluator. Для кастомных типов данных (например, анимация кастомного класса с тремя полями) реализуйте свой TypeEvaluator. Для анимации нескольких View с одинаковыми настройками используйте PropertyValuesHolder — он принимает массив Property-имён и соответствующих значений.

// Кастомный TypeEvaluator для класса ProgressState
data class ProgressState(val progress: Float, val color: Int)

class ProgressEvaluator : TypeEvaluator<ProgressState> {
    override fun evaluate(
        fraction: Float,
        startValue: ProgressState,
        endValue: ProgressState
    ): ProgressState {
        val progress = startValue.progress + fraction * (endValue.progress - startValue.progress)
        val color = ArgbEvaluator().evaluate(
            fraction, startValue.color, endValue.color
        ) as Int
        return ProgressState(progress, color)
    }
}

"> PropertyValuesHolder — максимальная производительность
val pvh1 = PropertyValuesHolder.ofFloat("scaleX", 1f, 1.5f)
val pvh2 = PropertyValuesHolder.ofFloat("scaleY", 1f, 1.5f)
val pvhAnim = ObjectAnimator.ofPropertyValuesHolder(myView, pvh1, pvh2).apply {
    duration = 300L
    start()
}