Thực hiện thử nghiệm nhấn trong ứng dụng Android

Thực hiện hit-test để xác định vị trí chính xác của đối tượng 3D trong cảnh của bạn. Vị trí đúng sẽ đảm bảo nội dung AR hiển thị ở kích thước (rõ ràng) thích hợp.

Loại kết quả của lượt truy cập

Thử nghiệm lượt truy cập có thể mang lại bốn loại kết quả lượt truy cập khác nhau, như được thể hiện trong bảng sau.

Loại kết quả lượt truy cập Mô tả Hướng Trường hợp sử dụng Lệnh gọi phương thức
Chiều sâu (DepthPoint) Sử dụng thông tin về chiều sâu từ toàn bộ cảnh để xác định chiều sâu và hướng chính xác của một điểm vuông góc với bề mặt 3D Đặt một đối tượng ảo trên một bề mặt tuỳ ý (không chỉ trên sàn và tường) Bạn phải bật ArDepthMode để tính năng này hoạt động.

Frame.hitTest(…), kiểm tra các DepthPoint trong danh sách trả về
Plane Chạm vào các bề mặt nằm ngang và/hoặc dọc để xác định chiều sâu và hướng chính xác của một điểm vuông góc với bề mặt 3D Đặt một vật thể lên một mặt phẳng (sàn hoặc tường) bằng cách sử dụng toàn bộ hình học của máy bay đó. Cần tỷ lệ chính xác ngay lập tức. Dự phòng cho kiểm thử lượt truy cập theo chiều sâu Frame.hitTest(…), kiểm tra các Plane trong danh sách trả về
Điểm tính năng (Point) Dựa vào các đặc điểm trực quan xung quanh điểm người dùng nhấn để xác định vị trí và hướng chính xác của một điểm Vuông góc với bề mặt 3D Đặt một đối tượng trên một bề mặt tuỳ ý (không chỉ trên sàn và tường) Frame.hitTest(…), kiểm tra các Point trong danh sách trả về
Vị trí tức thì (InstantPlacementPoint) Sử dụng không gian màn hình để đặt nội dung. Ban đầu sử dụng độ sâu ước tính do ứng dụng cung cấp. Hoạt động tức thì, nhưng tư thế và chiều sâu thực tế sẽ thay đổi sau khi ARCore có thể xác định hình học cảnh thực +Y hướng lên, trái với trọng lực Đặt một đối tượng trên mặt phẳng (sàn hoặc tường) bằng cách sử dụng hình học đầy đủ của mặt phẳng, trong đó việc đặt nhanh là rất quan trọng và trải nghiệm có thể chấp nhận độ sâu và tỷ lệ ban đầu không xác định Frame.hitTestInstantPlacement(float, float, float)

Thực hiện kiểm thử nhấn chuẩn

Gọi Frame.hitTest() để thực hiện kiểm tra lượt truy cập, sử dụng tiện ích TapHelper để lấy MotionEvent từ chế độ xem AR.

Java

MotionEvent tap = tapHelper.poll();
if (tap == null) {
  return;
}

if (usingInstantPlacement) {
  // When using Instant Placement, the value in APPROXIMATE_DISTANCE_METERS will determine
  // how far away the anchor will be placed, relative to the camera's view.
  List<HitResult> hitResultList =
      frame.hitTestInstantPlacement(tap.getX(), tap.getY(), APPROXIMATE_DISTANCE_METERS);
  // Hit-test results using Instant Placement will only have one result of type
  // InstantPlacementResult.
} else {
  List<HitResult> hitResultList = frame.hitTest(tap);
  // TODO: Filter hitResultList to find a hit result of interest.
}

Kotlin

val tap = tapHelper.poll() ?: return
val hitResultList =
  if (usingInstantPlacement) {
    // When using Instant Placement, the value in APPROXIMATE_DISTANCE_METERS will determine
    // how far away the anchor will be placed, relative to the camera's view.
    frame.hitTestInstantPlacement(tap.x, tap.y, APPROXIMATE_DISTANCE_METERS)
    // Hit-test results using Instant Placement will only have one result of type
    // InstantPlacementResult.
  } else {
    frame.hitTest(tap)
  }

Lọc kết quả lượt truy cập dựa trên loại bạn quan tâm. Ví dụ: nếu bạn muốn tập trung vào DepthPoint:

Java

// Returned hit-test results are sorted by increasing distance from the camera or virtual ray's
// origin.
// The first hit result is often the most relevant when responding to user input.
for (HitResult hit : hitResultList) {
  Trackable trackable = hit.getTrackable();
  if (trackable instanceof DepthPoint) { // Replace with any type of trackable type
    // Do something with this hit result. For example, create an anchor at this point of
    // interest.
    Anchor anchor = hit.createAnchor();
    // TODO: Use this anchor in your AR experience.
    break;
  }
}

Kotlin

// Returned hit-test results are sorted by increasing distance from the camera or virtual ray's
// origin.
// The first hit result is often the most relevant when responding to user input.
val firstHitResult =
  hitResultList.firstOrNull { hit ->
    when (val trackable = hit.trackable!!) {
      is DepthPoint -> true // Replace with any type of trackable type
      else -> false
    }
  }
if (firstHitResult != null) {
  // Do something with this hit result. For example, create an anchor at this point of interest.
  val anchor = firstHitResult.createAnchor()
  // TODO: Use this anchor in your AR experience.
}

Tiến hành thử nghiệm nhấn bằng cách sử dụng một tia và hướng tuỳ ý

Kiểm thử nhấn thường được coi là các tia từ máy ảnh của thiết bị, nhưng bạn có thể sử dụng Frame.hitTest(float[], int, float[], int) để thực hiện kiểm thử nhấn bằng cách sử dụng một tia tuỳ ý trong toạ độ không gian thế giới thay vì điểm không gian trên màn hình.

Tạo quảng cáo cố định cuối màn hình bằng cách sử dụng kết quả lượt truy cập

Sau khi có kết quả nhấn, bạn có thể sử dụng tư thế của kết quả đó làm dữ liệu đầu vào để đặt nội dung AR trong cảnh. Sử dụng HitResult.createAnchor() để tạo Anchor mới, đảm bảo rằng nội dung gắn với Trackable cơ bản của kết quả lượt truy cập. Ví dụ: neo sẽ vẫn được gắn vào máy bay được phát hiện khi kết quả va chạm với máy bay, do đó dường như là một phần của thế giới thực.

Bước tiếp theo