执行命中测试,以确定 3D 对象在您的场景中的正确位置。正确的放置位置可确保 AR 内容以适当的(表观)尺寸呈现。
命中结果类型
一个命中测试可以产生四种不同类型的命中结果,如下表所示。
命中结果类型 | 说明 | 方向 | 使用场景 | 方法调用 |
---|---|---|---|---|
厚度 (AR_TRACKABLE_DEPTH_POINT ) |
使用整个场景中的深度信息来确定点的正确深度和方向 | 垂直于 3D 表面 | 将虚拟对象放置在任意表面(不仅仅是地面和墙壁) |
必须启用 ArDepthMode 才能使用此功能。ArFrame_hitTest ,检查返回列表中是否有 ArDepthPoint
|
平面 (AR_TRACKABLE_PLANE ) |
点击水平和/或垂直表面,以确定某个点的正确深度和方向 | 垂直于 3D 表面 | 使用平面的完整几何图形将对象放置在平面(地板或墙壁)上。需要立即调整比例。Depth 点击测试的后备 |
ArFrame_hitTest ,检查返回列表中是否有 ArPlane
|
特征点 (AR_TRACKABLE_POINT ) |
依赖用户点按点周围的视觉特征来确定点的正确位置和方向 | 垂直于 3D 表面 | 将物体放在任意表面(不仅仅是地面和墙壁) |
ArFrame_hitTest ,检查返回列表中是否有 ArPoint
|
即时展示位置 (AR_TRACKABLE_INSTANT_PLACEMENT_POINT ) |
占用屏幕空间来放置内容。最初使用应用提供的估算深度。可立即运行,但一旦 ARCore 能够确定实际场景几何形状,姿势和实际深度就会发生变化 | +Y 指向上,与重力相反 | 使用平面的完整几何图形将对象放置在平面(地板或墙壁)上,此时快速放置至关重要,并且体验可以容忍未知的初始深度和缩放 |
ArFrame_hitTestInstantPlacement
|
执行标准的点击测试
调用 ArFrame_hitTest
以执行点击测试。
ArHitResultList* hit_result_list = NULL;
ArHitResultList_create(ar_session, &hit_result_list);
CHECK(hit_result_list);
if (is_instant_placement_enabled) {
ArFrame_hitTestInstantPlacement(ar_session, ar_frame, x, y,
k_approximate_distance_meters,
hit_result_list);
} else {
ArFrame_hitTest(ar_session, ar_frame, x, y, hit_result_list);
}
根据您感兴趣的类型过滤匹配结果。例如,如果您想关注 ArPlane
:
int32_t hit_result_list_size = 0;
ArHitResultList_getSize(ar_session, hit_result_list, &hit_result_list_size);
// 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.
ArHitResult* ar_hit_result = NULL;
for (int32_t i = 0; i < hit_result_list_size; ++i) {
ArHitResult* ar_hit = NULL;
ArHitResult_create(ar_session, &ar_hit);
ArHitResultList_getItem(ar_session, hit_result_list, i, ar_hit);
if (ar_hit == NULL) {
LOGE("No item was hit.");
return;
}
ArTrackable* ar_trackable = NULL;
ArHitResult_acquireTrackable(ar_session, ar_hit, &ar_trackable);
ArTrackableType ar_trackable_type = AR_TRACKABLE_NOT_VALID;
ArTrackable_getType(ar_session, ar_trackable, &ar_trackable_type);
// Creates an anchor if a plane was hit.
if (ar_trackable_type == AR_TRACKABLE_PLANE) {
// Do something with this hit result. For example, create an anchor at
// this point of interest.
ArAnchor* anchor = NULL;
ArHitResult_acquireNewAnchor(ar_session, ar_hit, &anchor);
// TODO: Use this anchor in your AR experience.
ArAnchor_release(anchor);
ArHitResult_destroy(ar_hit);
ArTrackable_release(ar_trackable);
break;
}
ArHitResult_destroy(ar_hit);
ArTrackable_release(ar_trackable);
}
ArHitResultList_destroy(hit_result_list);
使用任意光线和方向执行点击测试
点击测试通常被视为来自设备或设备相机的射线,但您可以使用 ArFrame_hitTestRay
通过现实世界空间坐标中的任意射线(而不是屏幕空间点)执行点击测试。
将锚点附加到 HitResult
获得命中结果后,您可以使用其姿势作为输入,在场景中放置 AR 内容。使用 ArHitResult_acquireNewAnchor
在命中位置创建一个新的锚点。
后续步骤
- 查看 GitHub 上的
hello_ar_c
示例应用。