Zasoby animacji

Zasób animacji może definiować jeden z 2 typów animacji:

Animacja właściwości
Tworzy animację, modyfikując wartości właściwości obiektu w ustawionym okresie za pomocą Animator.
Wyświetl animację

W ramach animacji widoku możesz tworzyć 2 rodzaje animacji:

Animacja właściwości

Animacja zdefiniowana w pliku XML, która w określonym czasie modyfikuje właściwości obiektu docelowego, takie jak kolor tła lub wartość alfa.

lokalizacja pliku:
res/animator/filename.xml
Nazwa pliku jest używana jako identyfikator zasobu.
skompilowany typ danych zasobu:
Wskaźnik zasobu do ValueAnimator, ObjectAnimator lub AnimatorSet
odwołanie do zasobu:
W kodzie Java lub Kotlin: R.animator.filename
W pliku XML: @[package:]animator/filename
składnia:
<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>

Plik musi mieć jeden element główny: <set>, <objectAnimator> lub <valueAnimator>. Elementy animacji możesz grupować w elemencie <set>, w tym w innych elementach <set>.

elements:
<set>
Kontener zawierający inne elementy animacji (<objectAnimator>, <valueAnimator> lub inne elementy <set>). Reprezentuje AnimatorSet.

Możesz określić zagnieżdżone tagi <set>, aby dodatkowo pogrupować animacje. Każdy element <set> może definiować własny atrybut ordering.

Atrybuty:

android:ordering
Słowo kluczowe. Określa kolejność odtwarzania animacji w tym zestawie.
WartośćOpis
sequentiallyOdtwarzaj animacje z tego zestawu sekwencyjnie.
together (domyślnie)Odtwarzaj animacje w tym zestawie jednocześnie.
<objectAnimator>
Animuje określoną właściwość obiektu przez określony czas. Reprezentuje ObjectAnimator.

Atrybuty:

android:propertyName
Ciąg znaków. Wymagany. Właściwość obiektu, która ma być animowana, określona przez jej nazwę. Możesz na przykład określić "alpha" lub "backgroundColor" dla obiektu View. Element objectAnimator nie udostępnia jednak atrybutu target, więc nie można ustawić animacji obiektu w deklaracji XML. Musisz rozwinąć zasób XML animacji, wywołując loadAnimator(), i wywołać setTarget(), aby ustawić obiekt docelowy zawierający tę właściwość.
android:valueTo
float, int lub color. Wymagany. Wartość, na której kończy się animowana właściwość. Kolory są reprezentowane przez 6-cyfrowe liczby szesnastkowe, np. #333333.
android:valueFrom
float, int lub color. Wartość, od której zaczyna się animowana właściwość. Jeśli nie zostanie określona, animacja rozpocznie się od wartości uzyskanej przez metodę get właściwości. Kolory są reprezentowane przez 6-cyfrowe liczby szesnastkowe, np. #333333.
android:duration
int. Czas animacji w milisekundach. Wartość domyślna to 300 milisekund.
android:startOffset
int. Liczba milisekund, o którą opóźniona jest animacja po wywołaniu start().
android:repeatCount
int. Liczba powtórzeń animacji. Ustaw wartość "-1", aby powtarzać w nieskończoność, lub dodatnią liczbę całkowitą. Na przykład wartość "1" oznacza, że animacja jest powtarzana raz po pierwszym uruchomieniu, więc odtwarza się łącznie 2 razy. Wartością domyślną jest "0", co oznacza brak powtórzeń.
android:repeatMode
int. Sposób zachowania animacji po jej zakończeniu. Aby ten atrybut działał, właściwość android:repeatCount musi być ustawiona na dodatnią liczbę całkowitą lub "-1". Ustaw wartość "reverse", aby animacja zmieniała kierunek przy każdej iteracji, lub "restart", aby animacja za każdym razem była odtwarzana od początku.
android:valueType
Słowo kluczowe. Nie podawaj tego atrybutu, jeśli wartością jest kolor. Platforma animacji automatycznie obsługuje wartości kolorów.
WartośćOpis
intTypeOkreśla, że animowane wartości są liczbami całkowitymi.
floatType (domyślnie)Określa, że animowane wartości są liczbami zmiennoprzecinkowymi.
<animator>
Wykonuje animację w określonym czasie. Reprezentuje ValueAnimator.

Atrybuty:

android:valueTo
float, int lub color. Wymagany. Wartość, przy której kończy się animacja. Kolory są reprezentowane przez 6-cyfrowe liczby szesnastkowe, np. #333333.
android:valueFrom
float, int lub color. Wymagany. Wartość, od której zaczyna się animacja. Kolory są reprezentowane przez 6-cyfrowe liczby szesnastkowe, np. #333333.
android:duration
int. Czas animacji w milisekundach. Wartość domyślna to 300 ms.
android:startOffset
int. Liczba milisekund, o którą opóźniona jest animacja po wywołaniu start().
android:repeatCount
int. Liczba powtórzeń animacji. Ustaw wartość "-1", aby powtarzać w nieskończoność, lub dodatnią liczbę całkowitą. Na przykład wartość "1" oznacza, że animacja jest powtarzana raz po pierwszym uruchomieniu, więc odtwarza się łącznie 2 razy. Wartością domyślną jest "0", co oznacza brak powtórzeń.
android:repeatMode
int. Sposób zachowania animacji po jej zakończeniu. Aby ten atrybut działał, właściwość android:repeatCount musi być ustawiona na dodatnią liczbę całkowitą lub "-1". Ustaw wartość "reverse", aby animacja zmieniała kierunek przy każdej iteracji, lub "restart", aby animacja za każdym razem była odtwarzana od początku.
android:valueType
Słowo kluczowe. Nie podawaj tego atrybutu, jeśli wartością jest kolor. Platforma animacji automatycznie obsługuje wartości kolorów.
WartośćOpis
intTypeOkreśla, że animowane wartości są liczbami całkowitymi.
floatType (domyślnie)Określa, że animowane wartości są liczbami zmiennoprzecinkowymi.
przykład:

Plik XML zapisany w res/animator/property_animator.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>

Aby uruchomić tę animację, rozwiń zasoby XML w kodzie do obiektu AnimatorSet, a następnie ustaw obiekty docelowe dla wszystkich animacji przed uruchomieniem zestawu animacji. Wywołanie metody setTarget() ustawia dla wygody pojedynczy obiekt docelowy dla wszystkich obiektów podrzędnych obiektu AnimatorSet. Poniższy kod pokazuje, jak to zrobić:

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();
patrz też:

Wyświetl animację

Platforma animacji widoku obsługuje zarówno animacje klatek pośrednich, jak i animacje klatka po klatce, które są deklarowane w pliku XML. W sekcjach poniżej znajdziesz opis obu metod.

Animacja klatek pośrednich

Animacja zdefiniowana w pliku XML, która wykonuje przejścia na grafice, takie jak obracanie, zanikanie, przesuwanie i rozciąganie.

lokalizacja pliku:
res/anim/filename.xml
Nazwa pliku jest używana jako identyfikator zasobu.
skompilowany typ danych zasobu:
Wskaźnik zasobu do Animation
odwołanie do zasobu:
W języku Java: R.anim.filename
W języku XML: @[package:]anim/filename
składnia:
<?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>

Plik musi mieć jeden element główny: <alpha>, <scale>, <translate>, <rotate> lub <set>, który zawiera grupę (lub grupy) innych elementów animacji (w tym zagnieżdżone elementy <set>).

elements:
<set>
Kontener, który zawiera inne elementy animacji (<alpha>, <scale>, <translate>, <rotate>) lub inne elementy <set>. Reprezentuje AnimationSet.

Atrybuty:

android:interpolator
Zasób interpolatora. Interpolator, który zostanie zastosowany do animacji. Wartość musi być odwołaniem do zasobu, który określa interpolator, a nie nazwę klasy interpolatora. Na platformie dostępne są domyślne zasoby interpolatora, ale możesz też utworzyć własny zasób interpolatora. Więcej informacji o interpolatorach znajdziesz w poniższej dyskusji.
android:shareInterpolator
Wartość logiczna. "true", jeśli chcesz udostępnić ten sam interpolator wszystkim elementom podrzędnym.
<alpha>
Animacja pojawiania się lub zanikania. Reprezentuje AlphaAnimation.

Atrybuty:

android:fromAlpha
Float. Przesunięcie początkowej nieprzezroczystości, gdzie 0,0 oznacza przezroczystość, a 1,0 – nieprzezroczystość.
android:toAlpha
Float. Przesunięcie nieprzezroczystości końcowej, gdzie 0,0 oznacza przezroczystość, a 1,0 nieprzezroczystość.

Więcej atrybutów obsługiwanych przez <alpha> znajdziesz w dokumentacji klasy Animation, której atrybuty XML są dziedziczone przez ten element.

<scale>
Animacja zmiany rozmiaru. Możesz określić punkt środkowy obrazu, od którego będzie on powiększany lub pomniejszany, podając wartości pivotX i pivotY. Jeśli na przykład te wartości to 0,0 (lewy górny róg), wszystkie elementy będą się powiększać w dół i w prawo. Reprezentuje ScaleAnimation.

Atrybuty:

android:fromXScale
Float. Przesunięcie rozmiaru początkowego X, gdzie 1,0 oznacza brak zmian.
android:toXScale
Float. Przesunięcie rozmiaru końcowego X, gdzie 1,0 oznacza brak zmiany.
android:fromYScale
Float. Przesunięcie początkowego rozmiaru Y, gdzie 1,0 oznacza brak zmiany.
android:toYScale
Float. Przesunięcie rozmiaru końcowego w osi Y, gdzie 1,0 oznacza brak zmiany.
android:pivotX
Float. Współrzędna X, która ma pozostać stała podczas skalowania obiektu.
android:pivotY
Float. Współrzędna Y, która ma pozostać stała podczas skalowania obiektu.

Więcej atrybutów obsługiwanych przez <scale> znajdziesz w dokumentacji klasy Animation, której atrybuty XML są dziedziczone przez ten element.

<translate>
Ruch w pionie lub w poziomie. Reprezentuje TranslateAnimation. Obsługuje te atrybuty w dowolnym z tych 3 formatów:
  • Wartości od -100 do 100 kończące się znakiem „%”, wskazujące wartość procentową względem siebie.
  • Wartości od -100 do 100 kończące się na „%p”, wskazujące wartość procentową względem elementu nadrzędnego.
  • Wartość zmiennoprzecinkowa bez sufiksu, wskazująca wartość bezwzględną.

Atrybuty:

android:fromXDelta
Liczba zmiennoprzecinkowa lub wartość procentowa. Początkowe przesunięcie na osi X. Wartość jest wyrażona w pikselach względem normalnej pozycji, np. "5", w procentach względem szerokości elementu, np. "5%", lub w procentach względem szerokości elementu nadrzędnego, np. "5%p".
android:toXDelta
Liczba zmiennoprzecinkowa lub wartość procentowa. Końcowe przesunięcie X. Wartość jest wyrażona w pikselach względem normalnej pozycji, np. "5", w procentach względem szerokości elementu, np. "5%", lub w procentach względem szerokości elementu nadrzędnego, np. "5%p".
android:fromYDelta
Liczba zmiennoprzecinkowa lub wartość procentowa. Początkowe przesunięcie na osi Y. Wartość jest wyrażona w pikselach względem normalnej pozycji, np. "5", w procentach względem wysokości elementu, np. "5%", lub w procentach względem wysokości elementu nadrzędnego, np. "5%p".
android:toYDelta
Liczba zmiennoprzecinkowa lub wartość procentowa. Końcowe przesunięcie na osi Y. Wartość jest wyrażona w pikselach względem normalnej pozycji, np. "5", w procentach względem wysokości elementu, np. "5%", lub w procentach względem wysokości elementu nadrzędnego, np. "5%p".

Więcej atrybutów obsługiwanych przez <translate> znajdziesz w dokumentacji klasy Animation, której atrybuty XML są dziedziczone przez ten element.

<rotate>
Animacja obrotu. Reprezentuje RotateAnimation.

Atrybuty:

android:fromDegrees
Float. Początkowa pozycja kątowa w stopniach.
android:toDegrees
Float. Końcowa pozycja kątowa w stopniach.
android:pivotX
Liczba zmiennoprzecinkowa lub wartość procentowa. Współrzędna X środka obrotu. Wartość wyrażona w pikselach względem lewej krawędzi obiektu, np. "5", w procentach względem lewej krawędzi obiektu, np. "5%", lub w procentach względem lewej krawędzi kontenera nadrzędnego, np. "5%p".
android:pivotY
Liczba zmiennoprzecinkowa lub wartość procentowa. Współrzędna Y środka obrotu. Wartość wyrażona w pikselach względem górnej krawędzi obiektu, np. "5", w procentach względem górnej krawędzi obiektu, np. "5%", lub w procentach względem górnej krawędzi kontenera nadrzędnego, np. "5%p".

Więcej atrybutów obsługiwanych przez <rotate> znajdziesz w dokumentacji klasy Animation, której atrybuty XML są dziedziczone przez ten element.

przykład:

Plik XML zapisany w res/anim/hyperspace_jump.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>

Poniższy kod aplikacji stosuje animację do elementu ImageView i ją uruchamia:

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);
patrz też:

Interpolatory

Interpolator to modyfikator animacji zdefiniowany w pliku XML, który wpływa na tempo zmian w animacji. Dzięki temu możesz przyspieszać, zwalniać, powtarzać, odbijać itp. istniejące efekty animacji.

Interpolator jest stosowany do elementu animacji z atrybutem android:interpolator, którego wartość jest odwołaniem do zasobu interpolatora.

Wszystkie interpolatory dostępne na Androidzie są podklasami klasy Interpolator. Dla każdej klasy interpolatora Android zawiera zasób publiczny, do którego możesz się odwołać, aby zastosować interpolator do animacji za pomocą atrybutu android:interpolator. W tabeli poniżej znajdziesz zasoby, których należy użyć w przypadku poszczególnych interpolatorów:

Klasa interpolatoraIdentyfikator zasobu
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

Oto jak możesz zastosować jedną z nich za pomocą atrybutu android:interpolator:

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

Niestandardowe interpolatory

Jeśli interpolatory udostępniane przez platformę nie spełniają Twoich oczekiwań, możesz utworzyć niestandardowy zasób interpolatora ze zmodyfikowanymi atrybutami. Możesz na przykład dostosować szybkość przyspieszania w przypadku AnticipateInterpolator lub liczbę cykli w przypadku CycleInterpolator. W tym celu utwórz własny zasób interpolatora w pliku XML.

lokalizacja pliku:
res/anim/filename.xml
Nazwa pliku jest używana jako identyfikator zasobu.
skompilowany typ danych zasobu:
Wskaźnik zasobu do odpowiedniego obiektu interpolatora
odwołanie do zasobu:
W pliku XML: @[package:]anim/filename
składnia:
<?xml version="1.0" encoding="utf-8"?>
<InterpolatorName xmlns:android="http://schemas.android.com/apk/res/android"
    android:attribute_name="value"
    />

Jeśli nie zastosujesz żadnych atrybutów, interpolator będzie działać dokładnie tak samo jak te udostępniane przez platformę, które są wymienione w tabeli powyżej.

elements:
Zwróć uwagę, że każda implementacja Interpolator zdefiniowana w pliku XML ma nazwę zaczynającą się od małej litery.
<accelerateDecelerateInterpolator>
Tempo zmiany jest wolne na początku i na końcu, ale przyspiesza w środku.

Brak atrybutów.

<accelerateInterpolator>
Zmiana zaczyna się powoli, a potem przyspiesza.

Atrybuty:

android:factor
Float. Współczynnik przyspieszenia. Wartość domyślna to 1.
<anticipateInterpolator>
Zmiana zaczyna się od tyłu, a potem przeskakuje do przodu.

Atrybuty:

android:tension
Float. Wartość napięcia, które ma zostać zastosowane. Wartość domyślna to 2.
<anticipateOvershootInterpolator>
Zmiana zaczyna się od ruchu do tyłu, a następnie gwałtownie przeskakuje do przodu i przekracza wartość docelową, po czym zatrzymuje się na wartości końcowej.

Atrybuty:

android:tension
Float. Wartość napięcia, które ma zostać zastosowane. Wartość domyślna to 2.
android:extraTension
Float. Wartość, przez którą ma zostać pomnożone napięcie. Wartość domyślna to 1,5.
<bounceInterpolator>
Zmiana odbija się na końcu.

Brak atrybutów

<cycleInterpolator>
Powtarza animację określoną liczbę razy. Tempo zmian jest zgodne ze wzorcem sinusoidalnym.

Atrybuty:

android:cycles
Liczba całkowita. Liczba cykli. Wartość domyślna to 1.
<decelerateInterpolator>
Tempo zmiany jest na początku szybkie, a potem maleje.

Atrybuty:

android:factor
Float. Współczynnik spowolnienia. Wartość domyślna to 1.
<linearInterpolator>
Tempo zmian jest stałe.

Brak atrybutów.

<overshootInterpolator>
Zmiana przeskakuje do przodu i przekracza ostatnią wartość, a następnie wraca.

Atrybuty:

android:tension
Float. Wartość napięcia, które ma zostać zastosowane. Wartość domyślna to 2.
przykład:

Plik XML zapisany w res/anim/my_overshoot_interpolator.xml:

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

Ten plik XML animacji stosuje interpolator:

<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" />

Animacja klatek

Animacja zdefiniowana w pliku XML, która pokazuje sekwencję obrazów w określonej kolejności, podobnie jak film.

lokalizacja pliku:
res/drawable/filename.xml
Nazwa pliku jest używana jako identyfikator zasobu.
skompilowany typ danych zasobu:
Wskaźnik zasobu do AnimationDrawable
odwołanie do zasobu:
W języku Java: R.drawable.filename
W języku XML: @[package:]drawable.filename
składnia:
<?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>
elements:
<animation-list>
Wymagany. Musi to być element główny. Zawiera co najmniej 1 element <item>.

Atrybuty:

android:oneshot
Wartość logiczna. "true", jeśli chcesz, aby animacja została wykonana raz, lub "false", aby ją zapętlić.
<item>
Pojedyncza klatka animacji. Musi być elementem podrzędnym elementu <animation-list>.

Atrybuty:

android:drawable
Obiekt rysowalny. Element rysowalny, który ma być używany w tej klatce.
android:duration
Liczba całkowita. Czas wyświetlania tej klatki w milisekundach.
przykład:

Plik XML zapisany w res/drawable/rocket_thrust.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>

Poniższy kod aplikacji ustawia animację jako tło dla View, a następnie odtwarza animację:

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();
}
patrz też: