--- title: GetComponentData summary: Leer los datos de los componentes en Lua UI, usando el nombre del objeto como ejemplo. 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/"] --- ## Valor devuelto | Tipo | Significado | | --- | --- | | [`any`](wiki:type-results), ... | Un resultado por campo solicitado. El campo de nombres en este ejemplo es string; otros campos tienen sus propios contratos. | [Tipos y métodos](wiki:types) ## Forma observada Capa: juego Lua UI. `component` es un ID de componente de script en la representación esperada por esta función; `name` selecciona el campo. Primero se obtiene el objeto en el proceso actual. La función no crea automáticamente la variable componente. ```lua local name = GetComponentData(component, "name") ``` **Qué ocurre:** Para una referencia válida de componente, el nombre recibe su nombre; un objeto llamado Scout da la cadena "Scout". El valor no se registra automáticamente. ## Observación de proyectos Después de cambiar el nombre, lea el nombre del objeto real y compárela con el resultado esperado. Actualizar su propio texto de ventana no es prueba de que el objeto del juego haya cambiado. ## Escribir errores No pases los datos de FFI simplemente porque se refieren a un objeto. La investigación de navegación encontró diferentes rutas de conversión para los mangos de UI, identificadores de la condicional y UniverseID. El soporte de campo y los tipos de retorno dependen de la consulta; este artículo documenta el nombre de readback en lugar de cada clave soportada. [Precisión del ID](wiki:ids-and-precision).