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í đặt chính xác đảm bảo nội dung AR được kết xuất ở kích thước (hiển thị) 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(…), hãy kiểm tra 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 đặc trư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 vật thể lên một mặt phẳng (sàn hoặc tường) bằng cách sử dụng hình dạng đầy đủ của máy bay, trong đó vị trí nhanh là rất quan trọng và trải nghiệm này có thể chịu được độ sâu và quy mô ban đầu chưa biết 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 thử lượt nhấn, 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ả về 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 nhận được kết quả lượt truy cập, bạn có thể sử dụng tư thế của kết quả đó làm thông tin đầu vào để đặt nội dung thực tế tăng cường vào cảnh của mì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 gắn liền với mặt phẳng được phát hiện cho kết quả va chạm với mặt phẳng, do đó, nó sẽ xuất hiện như một phần của thế giới thực.

Bước tiếp theo