XRTracker — C# API

class XRTrackerReckfellSharpНаследует RefCounted

XRTracker — базовый объект метаданных, не Entity игрового мира. Для pose используется XRPositionalTracker, для контроллера — XRControllerTracker. Базовые начальные значения: Name=Unknown, пустое Description, Type=Unknown; подкласс может задавать другую категорию.

Name служит ключом XRServer. Назначайте его до AddTracker и сохраняйте стабильным во время регистрации. Setter меняет только поле и не переносит запись реестра: после неправильного переименования поиск по старому ключу продолжает возвращать объект, а по новому — ничего. Для управляемого вами tracker сначала снимите регистрацию, затем измените имя и добавьте объект заново. Tracker реального устройства должен обслуживать его XR-интерфейс.

Type — категория, не запрос подключения устройства и не смена C#-подкласса. Description — текст для человека, не имя поиска или профиль. Setter метаданных сам по себе ничего не регистрирует. Для стандартных head, left_hand и right_hand используйте tracker, предоставленные интерфейсом, а не создавайте конфликтующие имена.

Начальные значения базовой части и ограничения имени проверены на отдельном XRPositionalTracker в установленном runtime. Это не проверка реального устройства, событий аппаратного подключения или всех специализированных подклассов. Настройка игрового рига: компоненты XR.

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

Свойства3

DescriptionСвойство

# Description

C#
public string Description { get; set; }

Произвольное человекочитаемое описание, изначально пустое. Не ключ поиска XRServer, не профиль устройства и не автоматический перевод. Setter сохраняет строку без регистрации tracker.

NameСвойство

# Name

C#
public StringName Name { get; set; }

Имя tracker, изначально Unknown с заглавной U в базовой реализации. Задайте уникальное имя до XRServer.AddTracker. Setter не переносит запись зарегистрированного tracker на новый ключ; перед сменой снимите регистрацию и после настройки добавьте заново. Не подменяйте имена tracker реального XR-интерфейса.

TypeСвойство

# Type

C#
public XRServer.TrackerType Type { get; set; }

Категория tracker. Базовая реализация начинается с Unknown и сохраняет переданное значение без проверки аппаратных возможностей. Изменение Type не превращает объект в другой подкласс и не подключает устройство; для контроллера используйте XRControllerTracker.

Методы6

GetTrackerDescstring

# GetTrackerDesc

C#
public string GetTrackerDesc();

Возвращает сохранённое человекочитаемое описание, изначально пустое. Не используется для поиска tracker.

Возвращает string

Сохранённое описание tracker.

GetTrackerNameStringName

# GetTrackerName

C#
public StringName GetTrackerName();

Возвращает сохранённое имя tracker. Оно может расходиться с ключом XRServer, если имя ошибочно изменили после регистрации.

Возвращает StringName

Настроенное имя tracker, не проверка регистрации.

GetTrackerTypeXRServer.TrackerType

# GetTrackerType

C#
public XRServer.TrackerType GetTrackerType();

Возвращает сохранённую категорию. Она не подтверждает подключение, pose или фактические возможности устройства.

Возвращает XRServer.TrackerType

Сохранённая категория tracker.

SetTrackerDescvoid

# SetTrackerDesc

C#
public void SetTrackerDesc(string description);

Параметры
Имя	Тип	По умолчанию
`description`	`string`	—

description

Человекочитаемый текст, не ключ поиска tracker.

SetTrackerNamevoid

# SetTrackerName

C#
public void SetTrackerName(StringName name);

Параметры
Имя	Тип	По умолчанию
`name`	`StringName`	—

name

Уникальное имя tracker, назначаемое до регистрации в XRServer.

SetTrackerTypevoid

# SetTrackerType

C#
public void SetTrackerType(XRServer.TrackerType type);

Параметры
Имя	Тип	По умолчанию
`type`	`XRServer.TrackerType`	—

type

Категория tracker; не способ создать устройство другого типа.