Xử lý cử chỉ nhiều điểm nhấn

Thử cách sử dụng Compose
Jetpack Compose là bộ công cụ giao diện người dùng được đề xuất cho Android. Tìm hiểu cách sử dụng thao tác chạm và nhập trong Compose.

Cử chỉ nhiều điểm chạm là khi nhiều con trỏ (ngón tay) nhấn vào màn hình cùng lúc. Tài liệu này mô tả cách phát hiện các cử chỉ liên quan đến nhiều con trỏ.

Theo dõi nhiều con trỏ

Khi nhiều con trỏ nhấn vào màn hình cùng một lúc, hệ thống sẽ tạo ra các sự kiện chạm sau đây:

  • ACTION_DOWN: được gửi khi con trỏ đầu tiên nhấn vào màn hình. Thao tác này sẽ bắt đầu cử chỉ. Dữ liệu con trỏ cho con trỏ này luôn ở chỉ mục 0 trong MotionEvent.
  • ACTION_POINTER_DOWN: được gửi khi có con trỏ bổ sung nhập vào màn hình sau lệnh đầu tiên. Bạn có thể lấy chỉ mục của con trỏ vừa giảm bằng cách sử dụng getActionIndex().
  • ACTION_MOVE: được gửi khi có thay đổi trong một cử chỉ, liên quan đến số lượng con trỏ bất kỳ.
  • ACTION_POINTER_UP: được gửi khi con trỏ phụ tăng lên. Bạn có thể lấy chỉ mục của con trỏ vừa di chuyển lên bằng cách sử dụng getActionIndex().
  • ACTION_UP: được gửi khi con trỏ cuối cùng rời khỏi màn hình.
  • ACTION_CANCEL: cho biết toàn bộ cử chỉ (bao gồm cả mọi con trỏ) đã bị huỷ.

Cử chỉ bắt đầu và kết thúc

Cử chỉ là một chuỗi các sự kiện bắt đầu bằng sự kiện ACTION_DOWN và kết thúc bằng sự kiện ACTION_UP hoặc ACTION_CANCEL. Mỗi lần có một cử chỉ đang hoạt động. Các thao tác XUỐNG, MOVE, LÊN và HUỶ áp dụng cho toàn bộ cử chỉ. Ví dụ: một sự kiện có ACTION_MOVE có thể cho biết một chuyển động của tất cả con trỏ xuống tại thời điểm đó.

Theo dõi con trỏ

Sử dụng chỉ mục và mã nhận dạng của con trỏ để theo dõi các vị trí của từng con trỏ trong MotionEvent.

  • Chỉ mục: MotionEvent lưu trữ thông tin con trỏ trong một mảng. Chỉ mục của một con trỏ là vị trí của con trỏ trong mảng này. Hầu hết các phương thức MotionEvent đều lấy chỉ mục con trỏ làm tham số, thay vì mã nhận dạng con trỏ.
  • Mã nhận dạng: mỗi con trỏ cũng có một mục ánh xạ mã nhận dạng duy trì liên tục giữa các sự kiện chạm để cho phép theo dõi một con trỏ riêng lẻ trong toàn bộ cử chỉ.

Con trỏ riêng lẻ xuất hiện trong một sự kiện chuyển động theo thứ tự không xác định. Do đó, chỉ mục của con trỏ có thể thay đổi từ sự kiện này sang sự kiện tiếp theo, nhưng mã nhận dạng con trỏ của con trỏ được đảm bảo sẽ không đổi miễn là con trỏ vẫn hoạt động. Sử dụng phương thức getPointerId() để lấy mã nhận dạng của con trỏ nhằm theo dõi con trỏ trong tất cả các sự kiện chuyển động tiếp theo trong một cử chỉ. Sau đó, đối với các sự kiện chuyển động liên tiếp, hãy sử dụng phương thức findPointerIndex() để lấy chỉ mục con trỏ cho một mã con trỏ nhất định trong sự kiện chuyển động đó. Ví dụ:

Kotlin

private var mActivePointerId: Int = 0

override fun onTouchEvent(event: MotionEvent): Boolean {
    ...
    // Get the pointer ID.
    mActivePointerId = event.getPointerId(0)

    // ... Many touch events later...

    // Use the pointer ID to find the index of the active pointer
    // and fetch its position.
    val (x: Float, y: Float) = event.findPointerIndex(mActivePointerId).let { pointerIndex ->
        // Get the pointer's current position.
        event.getX(pointerIndex) to event.getY(pointerIndex)
    }
    ...
}

Java

private int mActivePointerId;

public boolean onTouchEvent(MotionEvent event) {
    ...
    // Get the pointer ID.
    mActivePointerId = event.getPointerId(0);

    // ... Many touch events later...

    // Use the pointer ID to find the index of the active pointer
    // and fetch its position.
    int pointerIndex = event.findPointerIndex(mActivePointerId);
    // Get the pointer's current position.
    float x = event.getX(pointerIndex);
    float y = event.getY(pointerIndex);
    ...
}

Để hỗ trợ nhiều con trỏ cảm ứng, bạn có thể lưu tất cả con trỏ đang hoạt động vào bộ nhớ đệm cùng với mã nhận dạng của chúng tại thời điểm sự kiện ACTION_POINTER_DOWNACTION_DOWN riêng lẻ. Xoá con trỏ khỏi bộ nhớ đệm tại các sự kiện ACTION_POINTER_UPACTION_UP của chúng. Bạn có thể thấy những mã nhận dạng đã lưu vào bộ nhớ đệm này rất hữu ích trong việc xử lý các sự kiện hành động khác một cách chính xác. Ví dụ: khi xử lý sự kiện ACTION_MOVE, hãy tìm chỉ mục cho từng mã con trỏ đang hoạt động được lưu vào bộ nhớ đệm, truy xuất toạ độ của con trỏ bằng hàm getX()getY(), sau đó so sánh các toạ độ này với toạ độ đã lưu vào bộ nhớ đệm để khám phá xem con trỏ nào đã di chuyển.

Chỉ sử dụng hàm getActionIndex() với các sự kiện ACTION_POINTER_UPACTION_POINTER_DOWN. Đừng dùng hàm này cùng với các sự kiện ACTION_MOVE, vì hàm này luôn trả về 0.

Truy xuất MotionEvent hành động

Sử dụng phương thức getActionMasked() hoặc phiên bản tương thích MotionEventCompat.getActionMasked() để truy xuất hành động của MotionEvent. Không giống như phương thức getAction() trước đó, getActionMasked() được thiết kế để hoạt động với nhiều con trỏ. Phương thức này trả về thao tác mà không có chỉ mục con trỏ. Đối với các thao tác có chỉ mục con trỏ hợp lệ, hãy sử dụng getActionIndex() để trả về chỉ mục của các con trỏ liên kết với thao tác như minh hoạ trong đoạn mã sau:

Kotlin

val (xPos: Int, yPos: Int) = MotionEventCompat.getActionMasked(event).let { action ->
    Log.d(DEBUG_TAG, "The action is ${actionToString(action)}")
    // Get the index of the pointer associated with the action.
    MotionEventCompat.getActionIndex(event).let { index ->
        // The coordinates of the current screen contact, relative to
        // the responding View or Activity.
        MotionEventCompat.getX(event, index).toInt() to MotionEventCompat.getY(event, index).toInt()
    }
}

if (event.pointerCount > 1) {
    Log.d(DEBUG_TAG, "Multitouch event")

} else {
    // Single touch event.
    Log.d(DEBUG_TAG, "Single touch event")
}

...

// Given an action int, returns a string description.
fun actionToString(action: Int): String {
    return when (action) {
        MotionEvent.ACTION_DOWN -> "Down"
        MotionEvent.ACTION_MOVE -> "Move"
        MotionEvent.ACTION_POINTER_DOWN -> "Pointer Down"
        MotionEvent.ACTION_UP -> "Up"
        MotionEvent.ACTION_POINTER_UP -> "Pointer Up"
        MotionEvent.ACTION_OUTSIDE -> "Outside"
        MotionEvent.ACTION_CANCEL -> "Cancel"
        else -> ""
    }
}

Java

int action = MotionEventCompat.getActionMasked(event);
// Get the index of the pointer associated with the action.
int index = MotionEventCompat.getActionIndex(event);
int xPos = -1;
int yPos = -1;

Log.d(DEBUG_TAG,"The action is " + actionToString(action));

if (event.getPointerCount() > 1) {
    Log.d(DEBUG_TAG,"Multitouch event");
    // The coordinates of the current screen contact, relative to
    // the responding View or Activity.
    xPos = (int)MotionEventCompat.getX(event, index);
    yPos = (int)MotionEventCompat.getY(event, index);

} else {
    // Single touch event.
    Log.d(DEBUG_TAG,"Single touch event");
    xPos = (int)MotionEventCompat.getX(event, index);
    yPos = (int)MotionEventCompat.getY(event, index);
}
...

// Given an action int, returns a string description
public static String actionToString(int action) {
    switch (action) {

        case MotionEvent.ACTION_DOWN: return "Down";
	case MotionEvent.ACTION_MOVE: return "Move";
	case MotionEvent.ACTION_POINTER_DOWN: return "Pointer Down";
	case MotionEvent.ACTION_UP: return "Up";
	case MotionEvent.ACTION_POINTER_UP: return "Pointer Up";
	case MotionEvent.ACTION_OUTSIDE: return "Outside";
	case MotionEvent.ACTION_CANCEL: return "Cancel";
    }
    return "";
}
Hình 1. Mẫu vẽ bằng nhiều điểm chạm.

Tài nguyên khác

Để biết thêm thông tin liên quan đến các sự kiện nhập, hãy xem các tham chiếu sau: