Za pomocą widoków lub Compose możesz tworzyć niestandardowe animacje i przejścia właściwości w aplikacji, niestandardowe animacje między aktywnościami i niestandardowe animacje między fragmentami z gestami przewidywanego przejścia wstecz. Aby wypróbować metodę Compose, zapoznaj się z artykułem Dodawanie obsługi animacji przewidywanego przejścia wstecz.
Dodawanie niestandardowych przejść za pomocą interfejsu Progress API
W AndroidX Activity w wersji 1.8.0-alpha01 lub nowszej możesz używać interfejsów Predictive Back Progress API do tworzenia niestandardowych animacji dla gestu przewidywanego przejścia wstecz w aplikacji. Interfejsy Progress API są przydatne do animowania widoków, ale mają ograniczenia, jeśli chodzi o animowanie przejść między fragmentami. W ramach OnBackPressedCallback wprowadziliśmy metody handleOnBackProgressed, handleOnBackCancelled i handleOnBackStarted, które umożliwiają animowanie obiektów, gdy użytkownik przesuwa palcem wstecz. Użyj tych metod, jeśli chcesz dostosować więcej niż domyślne animacje udostępniane przez system lub animacje komponentów Material Design.
Spodziewamy się, że większość aplikacji będzie używać zgodnych wstecznie interfejsów API AndroidX, ale w interfejsie OnBackAnimationCallback dostępne są też podobne interfejsy API platformy, które można przetestować w Androidzie 14 i nowszych wersjach.
Używanie interfejsów API postępu z przejściami AndroidX
Interfejsów API postępu można używać z AndroidX Transitions w wersji 1.5.0-alpha01 lub nowszej na Androidzie 14 lub nowszym, aby tworzyć przejścia z przewidywanym przejściem wstecz.
- Użyj
TransitionManager#controlDelayedTransitionzamiastbeginDelayedTransition, aby odtwarzać przejścia, gdy użytkownik przesuwa palcem wstecz. - Utwórz przejście w ciągu
handleOnBackStarted. - Odtwórz przejście ze zdarzeniem wstecz w ciągu
handleOnBackProgressed, powiązująccurrentFractionzBackEvent.progress, co pokazuje, jak daleko użytkownik przesunął palcem wstecz. - Zakończ przejście po wykonaniu przez użytkownika gestu wstecz w aplikacji
handleOnBackPressed. - Na koniec zresetuj stan przejścia w
handleOnBackCancelled.
Poniższy film, kod Kotlin i kod XML pokazują niestandardowe przejście między 2 polami zaimplementowane za pomocą OnBackPressedCallback:
class MyFragment : Fragment() { val transitionSet = TransitionSet().apply { addTransition(Fade(Fade.MODE_OUT)) addTransition(ChangeBounds()) addTransition(Fade(Fade.MODE_IN)) } ... override fun onViewCreated(view: View, savedInstanceState: Bundle?) { super.onViewCreated(view, savedInstanceState) val callback = object : OnBackPressedCallback(enabled = false) { var controller: TransitionSeekController? = null @RequiresApi(34) override fun handleOnBackStarted(backEvent: BackEvent) { // Create the transition controller = TransitionManager.controlDelayedTransition( binding.card, transitionSet ) changeTextVisibility(ShowText.SHORT) } @RequiresApi(34) override fun handleOnBackProgressed(backEvent: BackEvent) { // Play the transition as the user swipes back if (controller?.isReady == true) { controller?.currentFraction = backEvent.progress } } override fun handleOnBackPressed() { // Finish playing the transition when the user commits back controller?.animateToEnd() this.isEnabled = false } @RequiresApi(34) override fun handleOnBackCancelled() { // If the user cancels the back gesture, reset the state transition(ShowText.LONG) } } binding.shortText.setOnClickListener { transition(ShowText.LONG) callback.isEnabled = true } this.requireActivity().onBackPressedDispatcher.addCallback(callback) } private fun transition(showText: ShowText) { TransitionManager.beginDelayedTransition( binding.card, transitionSet ) changeTextVisibility(showText) } enum class ShowText { SHORT, LONG } private fun changeTextVisibility(showText: ShowText) { when (showText) { ShowText.SHORT -> { binding.shortText.isVisible = true binding.longText.isVisible = false } ShowText.LONG -> { binding.shortText.isVisible = false binding.longText.isVisible = true } } } }
<?xml version="1.0" encoding="utf-8"?>
...
<androidx.constraintlayout.widget.ConstraintLayout
android:id="@+id/card"
android:layout_width="match_parent"
android:layout_height="wrap_content"
...>
<TextView
android:id="@+id/short_text"
android:layout_width="match_parent"
android:layout_height="match_parent"
... />
<TextView
android:id="@+id/long_text"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:visibility="gone"
.../>
</androidx.constraintlayout.widget.ConstraintLayout>
Podczas pracy z przejściami przewidywanego przejścia wstecz pamiętaj o tych kwestiach:
- Użyj
isSeekingSupported, aby sprawdzić, czy przejście obsługuje przewidywane przejście wstecz. - Zastąp
isSeekingSupported, aby zwracać wartość „true” w przypadku niestandardowych przejść. - Utwórz po 1 kontrolerze na każdą animację.
- Przejścia przewidywanego przejścia wstecz są obsługiwane w przypadku przejść AndroidX, ale nie w przypadku przejść platformy. Zrezygnuj z przejść platformy i używaj przejść
Animatori AndroidX. - Przejścia z przewidywanym przejściem wstecz są obsługiwane na urządzeniach z Androidem 14 lub nowszym i nie są zgodne wstecznie.
- Obsługiwane są też przejścia utworzone za pomocą scen XML. W
handleOnBackStartedustawTransitionSeekControllerna wynikTransitionManager.createSeekControllerzamiast wynikucontrolDelayedTransition.
Dodatkowe materiały
- Przykładowy kod przewidywanego przejścia wstecz
- Podstawowe informacje o filmie z tylnego aparatu
- Tworzymy przyszłość filmów na Androidzie