Tạo một ảnh động chuyển tiếp tuỳ chỉnh

Hiệu ứng chuyển đổi tuỳ chỉnh cho phép bạn tạo ảnh động chưa có sẵn từ bất kỳ các lớp chuyển đổi tích hợp sẵn. Ví dụ: bạn có thể xác định hiệu ứng chuyển đổi tuỳ chỉnh màu nền trước của văn bản và các trường nhập dữ liệu sang màu xám để cho biết các trường này đã bị tắt trong màn hình mới. Loại thay đổi này giúp người dùng thấy các trường bạn đã vô hiệu hoá.

Hiệu ứng chuyển đổi tuỳ chỉnh, chẳng hạn như một trong các loại hiệu ứng chuyển đổi tích hợp sẵn, sẽ áp dụng ảnh động cho khung hiển thị con của cả cảnh bắt đầu và cảnh kết thúc. Tuy nhiên, không giống như các loại chuyển đổi tích hợp sẵn, bạn phải cung cấp mã để ghi lại giá trị thuộc tính và tạo ảnh động. Bạn cũng có thể xác định một tập hợp con các thành phần hiển thị mục tiêu cho ảnh động.

Trang này hướng dẫn bạn cách thu thập giá trị thuộc tính và tạo ảnh động để tạo hiệu ứng chuyển cảnh tuỳ chỉnh.

Mở rộng lớp Transition

Để tạo một hiệu ứng chuyển đổi tuỳ chỉnh, hãy thêm một lớp vào dự án giúp mở rộng lớp Transition và ghi đè các hàm hiển thị trong đoạn mã sau:

Kotlin

class CustomTransition : Transition() {

    override fun captureStartValues(transitionValues: TransitionValues) {}

    override fun captureEndValues(transitionValues: TransitionValues) {}

    override fun createAnimator(
        sceneRoot: ViewGroup,
        startValues: TransitionValues?,
        endValues: TransitionValues?
    ): Animator? {}

}

Java

public class CustomTransition extends Transition {

    @Override
    public void captureStartValues(TransitionValues values) {}

    @Override
    public void captureEndValues(TransitionValues values) {}

    @Override
    public Animator createAnimator(ViewGroup sceneRoot,
                                   TransitionValues startValues,
                                   TransitionValues endValues) {}
}

Các phần sau đây giải thích cách ghi đè các hàm này.

Ghi lại giá trị thuộc tính chế độ xem

Ảnh động chuyển tiếp sử dụng hệ thống ảnh động thuộc tính được mô tả trong Tổng quan về ảnh động thuộc tính. Tài sản ảnh động thay đổi thuộc tính chế độ xem từ giá trị bắt đầu thành giá trị kết thúc trong giá trị được chỉ định do đó, khung cần có cả giá trị bắt đầu và giá trị kết thúc là thuộc tính để tạo ảnh động.

Tuy nhiên, ảnh động thuộc tính thường chỉ cần một tập hợp con nhỏ của tất cả thuộc tính của chế độ xem giá trị. Ví dụ: ảnh động màu cần giá trị thuộc tính màu, trong khi chuyển động ảnh động cần giá trị thuộc tính vị trí. Vì giá trị thuộc tính cần thiết cho ảnh động dành riêng cho một quá trình chuyển đổi, khung chuyển đổi không cung cấp mọi giá trị thuộc tính chuyển đổi. Thay vào đó, khung sẽ gọi các hàm callback cho phép chuyển đổi đến chỉ thu thập các giá trị thuộc tính cần thiết rồi lưu trữ các giá trị đó trong khung.

Thu thập giá trị bắt đầu

Để chuyển các giá trị của khung hiển thị ban đầu vào khung, hãy triển khai phương thức captureStartValues(transitionValues) . Khung này gọi hàm này cho mọi thành phần hiển thị trong cảnh bắt đầu. Hàm đối số là một đối tượng TransitionValues có chứa tham chiếu vào thành phần hiển thị và thực thể Map, trong đó bạn có thể lưu trữ các giá trị của thành phần hiển thị mà bạn muốn. Trong quá trình triển khai, hãy truy xuất các giá trị thuộc tính này và chuyển lại cho bằng cách lưu trữ chúng trong bản đồ.

Để đảm bảo rằng khoá cho một giá trị thuộc tính không xung đột với khoá khác TransitionValues khoá, hãy dùng lược đồ đặt tên sau:

package_name:transition_name:property_name

Đoạn mã sau đây cho thấy cách triển khai hàm captureStartValues():

Kotlin

class CustomTransition : Transition() {

    // Define a key for storing a property value in
    // TransitionValues.values with the syntax
    // package_name:transition_class:property_name to avoid collisions
    private val PROPNAME_BACKGROUND = "com.example.android.customtransition:CustomTransition:background"

    override fun captureStartValues(transitionValues: TransitionValues) {
        // Call the convenience method captureValues
        captureValues(transitionValues)
    }

    // For the view in transitionValues.view, get the values you
    // want and put them in transitionValues.values
    private fun captureValues(transitionValues: TransitionValues) {
        // Get a reference to the view
        val view = transitionValues.view
        // Store its background property in the values map
        transitionValues.values[PROPNAME_BACKGROUND] = view.background
    }

    ...

}

Java

public class CustomTransition extends Transition {

    // Define a key for storing a property value in
    // TransitionValues.values with the syntax
    // package_name:transition_class:property_name to avoid collisions
    private static final String PROPNAME_BACKGROUND =
            "com.example.android.customtransition:CustomTransition:background";

    @Override
    public void captureStartValues(TransitionValues transitionValues) {
        // Call the convenience method captureValues
        captureValues(transitionValues);
    }


    // For the view in transitionValues.view, get the values you
    // want and put them in transitionValues.values
    private void captureValues(TransitionValues transitionValues) {
        // Get a reference to the view
        View view = transitionValues.view;
        // Store its background property in the values map
        transitionValues.values.put(PROPNAME_BACKGROUND, view.getBackground());
    }
    ...
}

Lấy giá trị kết thúc

Khung này sẽ gọi hàm captureEndValues(TransitionValues) một lần cho mỗi khung hiển thị mục tiêu trong cảnh kết thúc. Trong mọi khía cạnh khác, captureEndValues() hoạt động giống như captureStartValues().

Đoạn mã sau đây cho thấy cách triển khai hàm captureEndValues():

Kotlin

override fun captureEndValues(transitionValues: TransitionValues) {
    captureValues(transitionValues)
}

Java

@Override
public void captureEndValues(TransitionValues transitionValues) {
    captureValues(transitionValues);
}

Trong ví dụ này, cả captureStartValues() và captureEndValues() các hàm gọi captureValues() để truy xuất và lưu trữ các giá trị. Thuộc tính khung hiển thị mà captureValues() truy xuất giống nhau, nhưng có các giá trị khác nhau trong phần tử cảnh bắt đầu và cảnh kết thúc. Khung này duy trì các bản đồ riêng biệt cho điểm xuất phát và điểm kết thúc của một khung hiển thị.

Tạo một ảnh động tuỳ chỉnh

Để tạo ảnh động cho các thay đổi đối với thành phần hiển thị giữa trạng thái của cảnh bắt đầu và trạng thái của thành phần hiển thị đó trong cảnh kết thúc, cung cấp ảnh động bằng cách ghi đè createAnimator() . Khi gọi hàm này, khung sẽ chuyển vào chế độ xem gốc của cảnh và Đối tượng TransitionValues chứa giá trị bắt đầu và giá trị kết thúc mà bạn đã chụp.

Số lần khung gọi hàm createAnimator() tuỳ thuộc vào những thay đổi xảy ra giữa cảnh bắt đầu và cảnh kết thúc.

Ví dụ: cân nhắc việc làm mờ hoặc ảnh động mờ dần được triển khai dưới dạng hiệu ứng chuyển đổi tuỳ chỉnh. Nếu cảnh bắt đầu có 5 mục tiêu, là hai cảnh được xóa khỏi cảnh kết thúc và cảnh kết thúc có ba mục tiêu từ khi bắt đầu cảnh cùng với một mục tiêu mới, sau đó khung sẽ gọi createAnimator() 6 lần. Ba lệnh gọi tạo hiệu ứng động mờ dần và rõ dần của các mục tiêu ở trong cả hai cảnh . Hai lệnh gọi khác tạo hiệu ứng động cho việc làm mờ các mục tiêu bị xoá khỏi cảnh kết thúc. Một lệnh gọi tạo hoạt ảnh mờ dần của mục tiêu mới trong cảnh kết thúc.

Đối với khung hiển thị mục tiêu tồn tại trong cả cảnh bắt đầu và cảnh kết thúc, khung này sẽ cung cấp đối tượng TransitionValues cho cả startValues và endValues đối số. Đối với các chế độ xem mục tiêu chỉ tồn tại trong phần đầu hoặc cảnh kết thúc, khung này sẽ cung cấp một đối tượng TransitionValues cho đối số tương ứng và null cho đối số còn lại.

Để triển khai hàm createAnimator(ViewGroup, TransitionValues, TransitionValues) khi bạn tạo hiệu ứng chuyển đổi tuỳ chỉnh, hãy sử dụng các giá trị thuộc tính khung hiển thị mà bạn đã chụp được để tạo một đối tượng Animator và trả về đối tượng đó cho khung. Ví dụ về cách triển khai, hãy xem lớp ChangeColor trong Mẫu CustomTransition. Để biết thêm thông tin về ảnh động tài sản, hãy xem Ảnh động thuộc tính.

Áp dụng hiệu ứng chuyển đổi tuỳ chỉnh

Hiệu ứng chuyển đổi tuỳ chỉnh hoạt động giống như hiệu ứng chuyển đổi tích hợp sẵn. Bạn có thể áp dụng hiệu ứng chuyển đổi tuỳ chỉnh bằng trình quản lý chuyển đổi, như mô tả trong Áp dụng hiệu ứng chuyển đổi.