Nếu đã di chuyển ứng dụng sang API quay lại hệ thống mới, thì bạn có thể chọn sử dụng tính năng xem trước thao tác quay lại để tự động nhận được nội dung trong ứng dụng ảnh động đồng thời hỗ trợ chuyển đổi tuỳ chỉnh.
Thêm tính năng hỗ trợ cho ảnh động tích hợp sẵn trong ứng dụng
Sau khi chọn tham gia, ứng dụng của bạn sẽ hiện ảnh động cho thao tác quay lại trang chủ, giữa các hoạt động và tác vụ.
Bạn cũng có thể nâng cấp phần phụ thuộc thành phần Material lên phiên bản 1.10.0 của MDC Android để nhận được các ảnh động của thành phần Material như sau:
Xem hướng dẫn dành cho nhà phát triển thành phần Material trên GitHub để biết thêm của bạn.
Video này minh hoạ nhanh về ảnh động xem trước thao tác quay lại cho nhiều hoạt động và thao tác quay lại trang chủ qua ứng dụng Cài đặt của Android.
- Ví dụ về ảnh động của nhiều hoạt động: Trong ảnh động, người dùng vuốt ngược lại để quay lại màn hình cài đặt trước đó.
- Ví dụ về ảnh động quay lại trang chủ: Lúc này, trên màn hình trước, người dùng bắt đầu vuốt ngược lại lần thứ hai, thì bản xem trước của màn hình chính cùng với hình nền sẽ hiện ra.
- Người dùng tiếp tục vuốt sang phải, thì ảnh động cho thấy cửa sổ hiện tại bị thu nhỏ thành biểu tượng trên màn hình chính sẽ xuất hiện.
- Giờ đây, người dùng hoàn toàn đã trở lại màn hình chính.
Hãy đọc thêm về Hỗ trợ tính năng xem trước thao tác quay lại.
Thêm hiệu ứng chuyển đổi và ảnh động tuỳ chỉnh trong ứng dụng
Bạn có thể tạo ảnh động và hiệu ứng chuyển đổi tuỳ chỉnh cho thuộc tính trong ứng dụng bằng cách sử dụng Progress API và phương thức ảnh động tuỳ chỉnh trên nhiều hoạt động overrideActivityTransition.
Thêm hiệu ứng chuyển đổi tuỳ chỉnh bằng Progress API
Trên AndroidX Activity 1.8.0-alpha01 trở lên, bạn có thể sử dụng Predictive Back Progress API để phát triển các ảnh động tuỳ chỉnh cho cử chỉ xem trước thao tác quay lại trong ứng dụng. Trong OnBackPressedCallback, chúng tôi đã ra mắt các phương thức handleOnBackProgressed, handleOnBackCancelled và handleOnBackStarted để tạo ảnh động cho đối tượng trong khi người dùng vuốt ngược lại. Áp dụng các phương thức này nếu bạn cần nhiều ảnh động tuỳ chỉnh hơn số ảnh động mặc định do ảnh động hệ thống mới hoặc Thành phần Material cung cấp.
Chúng tôi dự kiến rằng hầu hết ứng dụng sẽ dùng các API AndroidX tương thích ngược. Tuy nhiên, trong OnBackAnimationCallback cũng có sẵn các API nền tảng tương tự để kiểm thử trong Bản dùng thử 1 cho nhà phát triển trên Android 14 trở lên.
Sử dụng Progress API với hiệu ứng chuyển đổi AndroidX
Bạn có thể sử dụng Progress API với AndroidX Transitions 1.5.0-alpha01 trở lên trên Android 14 trở lên để tạo các hiệu ứng chuyển đổi Xem trước thao tác quay lại.
- Sử dụng
TransitionManager#controlDelayedTransitionthay vìbeginDelayedTransitionđể phát các hiệu ứng chuyển đổi khi người dùng vuốt ngược lại. - Tạo hiệu ứng chuyển đổi trong
handleOnBackStarted. - Phát hiệu ứng chuyển đổi với sự kiện quay lại trong
handleOnBackProgressedbằng cách liên kếtcurrentFractionvớiBackEvent.progressđể cho biết khoảng cách mà người dùng đã vuốt ngược lại. - Hoàn tất hiệu ứng chuyển đổi sau khi người dùng thực hiện cử chỉ quay lại trong
handleOnBackPressed. - Cuối cùng, đặt lại hiệu ứng chuyển đổi trong
handleOnBackCancelled.
Video, mã Kotlin và XML sau đây minh hoạ hiệu ứng chuyển đổi tuỳ chỉnh giữa 2 hộp được triển khai bằng 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>
Khi sử dụng hiệu ứng chuyển đổi Xem trước thao tác quay lại, hãy lưu ý những điều sau đây:
- Dùng
isSeekingSupportedđể kiểm tra xem hiệu ứng chuyển đổi có hỗ trợ cử chỉ Xem trước thao tác quay lại hay không. - Ghi đè
isSeekingSupportedđể trả về giá trị true cho hiệu ứng chuyển đổi tuỳ chỉnh. - Tạo một bộ điều khiển cho mỗi ảnh động.
- Hiệu ứng chuyển đổi Xem trước thao tác quay lại được hỗ trợ với hiệu ứng chuyển đổi AndroidX, nhưng không được hỗ trợ với hiệu ứng chuyển đổi khung. Bạn nên thoát khỏi các hiệu ứng chuyển đổi khung.
- Hiệu ứng chuyển đổi Xem trước thao tác quay lại được hỗ trợ trên các thiết bị Android 14 trở lên và không tương thích ngược.
- Các hiệu ứng chuyển đổi được tạo bằng cảnh XML cũng được hỗ trợ. Trong
handleOnBackStarted, hãy đặtTransitionSeekControllerthành kết quả củaTransitionManager.createSeekControllerthay vì kết quả củacontrolDelayedTransition.
Thêm hiệu ứng chuyển đổi tuỳ chỉnh cho hoạt động trên Android 14 trở lên
Để đảm bảo các hiệu ứng chuyển đổi tuỳ chỉnh của Hoạt động hỗ trợ tính năng xem trước thao tác quay lại trên Android 14 trở lên, bạn có thể sử dụng overrideActivityTransition thay vì overridePendingTransition. Điều này có nghĩa là ảnh động hiệu ứng chuyển đổi sẽ phát khi người dùng vuốt ngược lại.
Để có một ví dụ về cách hoạt động của điều này, hãy tưởng tượng một tình huống trong đó Hoạt động B nằm ở trên Hoạt động A trong ngăn xếp lui. Bạn sẽ xử lý ảnh động tuỳ chỉnh của Hoạt động theo cách sau:
- Gọi chuyển đổi mở hoặc đóng trong phương thức
onCreatecủa Hoạt động B. - Khi người dùng chuyển đến Hoạt động B, hãy sử dụng
OVERRIDE_TRANSITION_OPEN. Khi người dùng vuốt để quay lại Hoạt động A, hãy sử dụngOVERRIDE_TRANSITION_CLOSE. Khi chỉ định
OVERRIDE_TRANSITION_CLOSE,enterAnimlà ảnh động tiến nhập của Hoạt động A vàexitAnimlà ảnh động rời khỏi của Hoạt động B.