執行 hit-test 以確定 3D 物件的正確位置 (在場景中)。正確放置的位置可確保 AR 內容能以適當的大小 (透明) 顯示。
命中結果類型
命中測試可能會產生四種不同類型的命中結果,如下表所示。
命中結果類型 | 說明 | 方向 | 用途 | 方法呼叫數 |
---|---|---|---|---|
深度 (DepthPoint ) |
使用整個場景的深度資訊,判斷點的正確深度和方向 | 與 3D 表面垂直 | 將虛擬物件置於任意平面上 (不僅限於樓層和牆面) |
您必須啟用 ArDepthMode ,這項功能才能正常運作。Frame.hitTest(…) ,請在退貨清單中查看 DepthPoint
|
Plane |
命中水平和/或垂直表面,判斷點的正確深度和方向 | 與 3D 表面垂直 | 使用飛機的完整幾何圖形將物體放置在平面 (地板或牆壁) 上。需要立即正確的體重計。深度命中測試的備用方法 |
Frame.hitTest(…) ,在退貨清單中查看 Plane |
特徵點 (Point ) |
提供使用者輕觸該點周圍的視覺地圖項目,以決定點的正確位置和方向 | 與 3D 表面垂直 | 將物件置於任意表面 (不限於樓層和牆上) |
Frame.hitTest(…) ,在退貨清單中查看 Point |
即時刊登位置 (InstantPlacementPoint ) |
使用螢幕空間放置內容。一開始使用應用程式提供的預估深度。雖然可立即運作,但 ARCore 能判斷實際場景的幾何圖形後,姿勢和實際深度也會跟著改變 | +Y 指朝上,與重力相反 | 使用飛機的完整幾何圖形將物體放置在平面 (地板或牆壁) 上,如此快速擺放位置至關重要,且體驗可以容忍初始的初始深度和縮放比例不明 |
Frame.hitTestInstantPlacement(float, float, float)
|
執行標準命中測試
呼叫 Frame.hitTest()
可使用 TapHelper
公用程式從 AR 檢視畫面取得 MotionEvent
,用於執行命中測試。
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) }
根據您感興趣的類型篩選命中結果。舉例來說,如果您想聚焦 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. }
使用任意陣列和方向進行命中測試
命中測試通常視為來自裝置或裝置相機的光線,但您可以使用 Frame.hitTest(float[], int, float[], int)
,使用世界空間座標中的任意光線 (而非螢幕空間點) 進行命中測試。
根據命中結果建立錨定標記
取得命中結果後,您可以使用其姿勢輸入場景中放置 AR 內容。使用 HitResult.createAnchor()
建立新的 Anchor
,確保內容會附加至命中結果的基礎 Trackable
。舉例來說,在偵測到飛機命中時,錨點會保持附在偵測到的平面上,因此出現在真實世界中。
後續步驟
- 歡迎前往 GitHub 查看
hello_ar_java
和hello_ar_kotlin
範例應用程式。