Hướng dẫn cho nhà phát triển về Vị trí tức thì trong AR Foundation

Tìm hiểu cách sử dụng Instant Placement API (API Vị trí tức thì) hoặc raycasts ổn định trong ứng dụng của riêng bạn.

Điều kiện tiên quyết

Hãy đảm bảo rằng bạn hiểu rõ các khái niệm cơ bản về thực tế tăng cường và cách định cấu hình một phiên ARCore trước khi tiếp tục.

Tên khái niệm

Tên của một số khái niệm và phương thức có thể khác nhau giữa AR Foundation và SDK ARCore cho Unity. Các loại tệp này được liệt kê trong bảng dưới đây để bạn dễ tham khảo.

AR Foundation SDK ARCore dành cho Unity
Raycast liên tục Vị trí tức thì
ARRaycastManager.AddRaycast(Vector2, float) Frame.RaycastInstantPlacement(float, float, float, out TrackableHit)
ARRaycast TrackableHit
(Không tương đương) InstantPlacementPoint
ARRaycast.trackingState InstantPlacementPointTrackingMethod

Điều kiện tiên quyết

Hướng dẫn này giả định rằng bạn đã cài đặt và định cấu hình Unity. Nếu chưa, hãy xem bài viết Bắt đầu sử dụng Tiện ích ARCore cho AR Foundation để biết các bước cài đặt và thiết lập.

Định cấu hình một phiên mới bằng ARRaycastManager

Tính năng Đặt tức thì (các tia chiếu cố định) có sẵn trong gói AR Foundation. Hãy làm theo các bước sau để thiết lập cảnh.

AR Foundation 4.x

  1. Thêm các đối tượng trò chơi được xác định trước AR Session Origin và AR Session.

  2. Thêm thành phần AR Raycast Manager vào đối tượng trò chơi AR Session Origin.

Khi Raycast Prefab không phải là giá trị rỗng, ARRaycastManager sẽ tạo bản sao cho prefab và tự động đồng bộ hoá tư thế của prefab với tư thế của ARRaycast.

AR Foundation 5.x

  1. Thêm các đối tượng trò chơi được xác định trước XR Origin và AR Session.

  2. Thêm thành phần AR Raycast Manager vào đối tượng trò chơi XR Origin.

Khi Raycast Prefab không phải là giá trị rỗng, ARRaycastManager sẽ tạo bản sao cho prefab và tự động đồng bộ hoá tư thế của prefab với tư thế của ARRaycast.

Đặt đối tượng

Trong phiên ARCore mới, hãy kiểm thử lượt truy cập bằng ARRaycastManager.AddRaycast(Vector2, float).

public ARRaycastManager RaycastManager; // set from the Editor Inspector.

void Update()
{
    Touch touch;
    if (Input.touchCount < 1 || (touch = Input.GetTouch(0)).phase != TouchPhase.Began)
    {
        return;
    }

    if (EventSystem.current.IsPointerOverGameObject(touch.fingerId))
    {
        return;
    }

    ARRaycast raycast = RaycastManager.AddRaycast(touch.position, _estimateDistance);
    if (raycast != null)
    {
        // You can instantiate a 3D object here if you haven’t set Raycast Prefab in the scene.
        …
    }
}

Theo dõi trạng thái theo dõi ARRaycast

Nếu ARCore có tư thế 3D chính xác, thì ARRaycast.trackingState sẽ là Tracking. Nếu không, nó sẽ bắt đầu bằng Limited và chuyển đổi sang Tracking sau khi ARCore có tư thế 3D chính xác. Sau khi trạng thái theo dõi trở thành Tracking, trạng thái này sẽ không quay lại Limited.