---
title: GetComponentData
summary: 在 Lua UI 中阅读组件数据,使用对象名称作为一个例子.
section: reference
kind: api
status: reference
updated: 2026-10-22
tags: ["X4","modding","get","component","data"]
sources: ["https://wiki.egosoft.com/X4%20Foundations%20Wiki/Modding%20Support/"]
---
## 返回值

| 类型 | 含义 |
| --- | --- |
| [`any`](wiki:type-results), ... | 要求的每个字段均有1个结果. 在本例中,名称字段是字符串;其他字段都有自己的合同. |

[类型与方法](wiki:types)

## 观察到的形式


层:游戏 Lua 接口. `component` 是该函数预期的表示中的脚本组件ID; `name` 选择该领域. 首先解决当前过程中的对象. 函数不会自动创建组件变量.




```lua
local name = GetComponentData(component, "name")
```



**运行效果：** 对于一个有效的组件引用,名称得到其名称;一个名为Scout的对象输出了字符串"Scoat". 值不会自动记录.

## 项目观察


改名后,读取真实物体的名字,并与预期结果进行比较. 更新自己的窗口文本并不是证明游戏对象改变.



## 类型错误


仅仅因为它指向一个对象而不能传递FFI cdata. 导航研究发现了 UI 手柄,数字ID和 UniverseID的不同转换路径. 支持字段和返回类型取决于查询;本文记录了名称反读,而不是每个支持的键. 看到 [识别精度](wiki:ids-and-precision).