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 các khái niệm cơ bản về AR và cách định cấu hình 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 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 không, 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. 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.

AR Foundation 6.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 một phiên ARCore mới, hãy thực hiện kiểm thử lượt nhấn 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.