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í chính xác giúp đảm bảo nội dung thực tế tăng cường được hiển thị ở kích thước thích hợp (cao nhất).

Loại kết quả 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 trình bày trong bảng sau.

Loại kết quả lượt truy cập Nội dung 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 chiều sâu từ toàn bộ cảnh để xác định độ 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ể ả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 thì mã này mới hoạt động.

Frame.hitTest(…), kiểm tra DepthPoint trong danh sách trả về
Plane Nhấn vào bề mặt ngang và/hoặc dọc để xác định độ 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ể trên 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ặt phẳng. Cần sửa tỷ lệ ngay lập tức. Dự phòng cho kỹ thuật kiểm tra độ sâu Frame.hitTest(…), kiểm tra để tìm Plane trong danh sách trả về
Điểm tính năng (Point) Dựa vào các đặc điểm hình ảnh 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 vật thể trên một bề mặt tuỳ ý (không chỉ trên sàn nhà và tường) Frame.hitTest(…), kiểm tra để tìm 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 dạng cảnh thực tế +Y hướng lên trên, ngược với trọng lực Đặt một vật thể trên mặt phẳng (sàn hoặc tường) bằng cách sử dụng toàn bộ hình dạng của máy bay, mà ở đó vị trí nhanh là rất quan trọng, và trải nghiệm có thể chịu được độ sâu và tỷ lệ ban đầu không xác định Frame.hitTestInstantPlacement(float, float, float)

Thực hiện thử nghiệm 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 mà bạn quan tâm. Ví dụ: nếu bạn muốn tập trung vào các 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.
}

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

Kiểm thử lượt truy cập thường được xem là tia từ máy ảnh của thiết bị hoặc thiết bị. Tuy nhiên, bạn có thể dùng Frame.hitTest(float[], int, float[], int) để kiểm thử lượt truy cập 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 màn hình.

Tạo liên kết bằng cách sử dụng kết quả lần truy cập

Sau khi có một kết quả nổi bật, bạn có thể sử dụng tư thế của thành phần đó làm đầu vào để đặt nội dung thực tế tăng cường vào cảnh của bạn. Sử dụng HitResult.createAnchor() để tạo Anchor mới, đảm bảo rằng nội dung đính kèm với Trackable cơ sở 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 đối với kết quả va chạm Máy bay, do đó dường như là một phần của thế giới thực.

Bước tiếp theo