XRAnchor3D — C# API

Привязка Entity к pose якоря; локальная плоскость.

class XRAnchor3DReckfellSharpНаследует XREntity3D

XRAnchor3D наследует XREntity3D: выберите Tracker, затем Pose и разместите Entity непосредственно под XROrigin3D. Он не включает AR-обнаружение и не гарантирует, что платформа создаст tracker якоря. Имена и доступность определяет поставщик данных.

GetPlane строит бесконечную плоскость по локальному Position и оси Y локального Transform. Это пространство родителя, не мир. Следующий выполненный helper добавляет трансформ origin один раз:

C#
using System;
using Reckfell;

public static class AnchorPlane
{
    // Infinite geometric plane only: no tracking-validity or detected-area claim.
    public static Plane ToWorld(XRAnchor3D anchor)
    {
        ArgumentNullException.ThrowIfNull(anchor);
        if (!anchor.IsInsideTree() || anchor.GetParent() is not XROrigin3D origin)
            throw new ArgumentException("Expected an anchor directly under an in-tree XROrigin3D.");
        return origin.GlobalTransform * anchor.GetPlane();
    }
}

Plane не содержит границы, геометрию коллизии или подтверждение обнаруженной поверхности. До взаимодействий отдельно проверяйте актуальную pose. GetSize в текущей реализации остаётся нулевым, в том числе после обновления pose: путь заполнения размеров не реализован. Не используйте его как площадь пола или размер коллайдера.

Проверены локальная геометрия, мировой helper, трансформ от искусственного tracker и нулевой размер. Реальная AR-поверхность, пространственная привязка платформы, сохранение якорей и обнаружение границ не проверялись. Состояние tracking: XREntity3D.

Объявления сверены с C# SDK 1.0.0. Раскройте имя, чтобы увидеть сигнатуры и описание.

Конструкторы1

XRAnchor3DКонструктор

# XRAnchor3D

C#
public XRAnchor3D();

Создаёт Entity привязки к tracker; наследует Tracker/Pose у XREntity3D. Не включает обнаружение поверхностей, не создаёт AR-сеанс или tracker автоматически. Нужен отдельный поставщик данных.

Методы2

GetPlanePlane

# GetPlane

C#
public Plane GetPlane();

Строит бесконечную Plane по Position и нормализованной оси Y локального Transform. Результат в пространстве родителя, не мировом. Метод не проверяет tracking и не подтверждает обнаружение поверхности. Для мира примените GlobalTransform родителя один раз; границ обнаруженной области у Plane нет.

Возвращает Plane

Бесконечная плоскость в пространстве родителя, не границы AR-поверхности.

GetSizeVector3

# GetSize

C#
public Vector3 GetSize();

В текущей реализации возвращает нулевой Vector3: получение pose обновляет трансформ, но не заполняет size. Не используйте результат как ширину/длину обнаруженной поверхности и не создавайте по нему коллайдер. Подтверждённых AR-границ этот класс не предоставляет.

Возвращает Vector3

Vector3.Zero в текущей реализации; размер обнаруженной области не заполнен.