Возвращаемое значение#

Тип Значение
any, ... По результату на запрошенное поле. Поле name в примере является string; у других полей свои контракты.

Типы и методы

Используемая форма#

Слой: Lua UI игры.

LUA
local name = GetComponentData(component, "name")

Что произойдёт: Если component является допустимой ссылкой, name получает имя компонента. Например, для объекта с именем Scout это строка "Scout". В журнал значение автоматически не выводится.

Аргумент Назначение
component Script component ID в форме, ожидаемой UI-функцией
"name" Имя запрашиваемого поля в этом примере

Объект должен быть разрешён в текущем процессе. Здесь component - заранее полученный ID, а не переменная, которую игра создаёт автоматически.

Наблюдение проекта#

После переименования считайте настоящее имя объекта и сравните с ожидаемым. Обновление текста своего окна само по себе не доказывает, что имя изменилось в игре.

Ошибки типов#

Не передавайте сюда FFI cdata только потому, что она тоже обозначает объект. В исследовании навигации UI handle, числовой ID и UniverseID требовали разных путей преобразования.

Поле и тип результата зависят от запроса. Эта статья описывает чтение name, а не полный список всех поддерживаемых ключей.

См. ID и точность.