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
- Xem ứng dụng mẫu
hello_ar_java
vàhello_ar_kotlin
trên GitHub.