Interfaces
interface tesoro global {
live gemas : int = 01 · Un archivo para lo compartidoUna interfaz guarda datos que comparten varios scripts. Va en su propio archivo, tesoro.iface.gro. global quiere decir que hay una sola para todo el juego.}Este código todavía no imprime nada.
use interface::tesoro as tesoro
fn _ready() void {
tesoro.gemas += 12 · Usarla desde un scriptuse interface:: la trae, igual que un actor o un prefab. Después lees y cambias sus campos con un punto: tesoro.gemas. print(tesoro.gemas)
}1
use interface::tesoro as tesoro
@onready watch tesoro.gemas(valor: int) {
print($"Contador: {valor} gemas")
}3 · Mirarla desde otro scriptEste es el código del contador de gemas. Con watch reacciona cada vez que cambian, como si fueran una variable live suya.Contador: 0 gemas
use interface::tesoro as tesoro
fn _ready() void {
tesoro.gemas += 1
tesoro.gemas += 14 · Los dos a la vezEn esta escena, el contador del paso anterior es un actor más. El nivel suma gemas y el contador las muestra, sin que ninguno sepa que el otro existe.}Contador: 0 gemas Contador: 1 gemas Contador: 2 gemas
Gobi recoge una gema y el contador de la pantalla tiene que subir. Son dos scripts distintos: el del nivel y el del contador. Podrían buscarse el uno al otro para pasarse el número, pero entonces cada uno dependería del otro: cambias uno y se rompe el otro.
Una interfaz es un bloque de datos (y funciones) compartido, que los dos usan sin saber nada el uno del otro.
Declarar una interfaz
Cada interfaz va en su propio archivo, llamado <nombre>.iface.gro. Este es tesoro.iface.gro:
interface tesoro global { live gemas : int = 0
fn recoger(n: int) void { set gemas += n }}interface tesorole pone nombre. El que cuenta es el escrito dentro del archivo.globalsignifica que hay una sola para todo el juego: todos los scripts que la usan ven los mismos datos.- Los campos se declaran como variables. Con
live, otros scripts pueden observarlos conwatch. - Las funciones, como cualquier función. Dentro, los cambios a un campo
livellevanset, como en la lección anterior.
Usarla
Un script la trae con use interface::, por el nombre de dentro:
module Nivel
use interface::tesoro as tesoro
fn _ready() void { tesoro.gemas += 1 tesoro.recoger(2) print(tesoro.gemas)}tesoro.gemas += 1cambia el campo directamente. Desde otro script no hace faltaset: el cambio avisa igual.tesoro.recoger(2)llama a la función de la interfaz, que suma 2 más.
Dos scripts, un mismo dato
Ahora el contador. Su código no sabe nada del nivel: solo observa el campo gemas.
module ContadorGemas
use interface::tesoro as tesoro
@onready watch tesoro.gemas(valor: int) { print($"Contador: {valor} gemas")}Pon el contador en la escena del nivel, y el nivel solo tiene que sumar gemas:
module Nivel
use interface::tesoro as tesoro
fn _ready() void { print("Nivel listo") tesoro.gemas += 1 tesoro.recoger(2)}- El contador muestra el 0 al empezar, gracias al
@onready. - Cada cambio del nivel le llega al contador, que lo muestra.
- Ninguno conoce al otro. Podrías cambiar el contador por una barra o un sonido, y el nivel no cambiaría ni una línea.
¿Y sin global?
Sin global, hay una instancia por actor: cada uno que la usa con use interface:: tiene la
suya. Sirve para datos que cada enemigo lleva por su cuenta, como su propia salud:
interface salud { live puntos : int = 10 }.
Empezar de nuevo: reset()
Todas las interfaces tienen la función reset(): devuelve sus campos a los valores con los que
se declararon. Es lo que usas para empezar de nuevo un nivel o una partida.
module Nivel
use interface::tesoro as tesoro
fn _ready() void { tesoro.recoger(5) print(tesoro.gemas) tesoro.reset() print(tesoro.gemas)}Quien observa la interfaz con watch también ve el cambio, así que un contador volvería a
mostrar 0.
Hora de practicar
¿Dónde se escribe una interfaz?
<nombre>.iface.gro, y los scripts la traen con use interface::.Completa el código del contador para que muestre las gemas desde el principio y cada vez que cambien.
Gemas: 0
use ::tesoro as tesoro
@onready tesoro.gemas(valor: int) {
print($"Gemas: {valor}")
}use interface::tesoro as tesoro
@onready watch tesoro.gemas(valor: int) {
print($"Gemas: {valor}")
}¿Qué quiere decir global en interface tesoro global { ... }?
global hay una única instancia compartida: lo que escribe un script lo ve cualquier otro. Sin global, hay una por actor.La interfaz tesoro tiene fn recoger(n: int), que suma n gemas. ¿Qué imprime este código?
use interface::tesoro as tesoro
fn _ready() void {
tesoro.recoger(2)
tesoro.recoger(3)
tesoro.reset()
tesoro.recoger(1)
print(tesoro.gemas)
}reset() deja gemas otra vez en 0, y luego suma 1.reset() devuelve los campos al valor con el que se declararon.