Get Geo Tracking State
ARGeoTrackingSupportЧто это
Pure-функция, возвращающая текущее состояние гео-трекинга (GeoTracking) у AR-устройства. Позволяет узнать, доступен ли гео-трекинг, идёт ли его инициализация, активен ли он или произошла ошибка. Используется в AR-проектах для проверки готовности перед запуском гео-привязки (например, размещения AR-объектов на реальные координаты).
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные):
- Target (ARGeoTrackingSupport Object Reference) — экземпляр AR-поддержки гео-трекинга (обычно получается через
Get GeoTracking Support)
Выходы (данные):
- Return Value (EGeoTrackingState Enum) — текущее состояние:
Initializing— инициализацияActive— трекинг работаетInactive— не активенError— ошибка
Когда используется
- Проверка, поддерживает ли устройство гео-трекинг и готов ли он к использованию перед размещением объектов с географической привязкой.
- Управление логикой приложения в зависимости от состояния (например, показывать индикатор загрузки при
Initializing, скрывать AR-контент приError).
Типичные проблемы
- Вызов функции без предварительной проверки, доступен ли AR-сеанс (необходимо сначала создать сессию через
Start AR Session). - Игнорирование возвращаемого состояния
Error— при ошибке гео-трекинг не будет работать, а последующие AR-действия могут упасть. - Предположение, что состояние
Activeостаётся неизменным весь сеанс — оно может перейти вErrorилиInactiveпри потере сигнала GPS.