Servicio reloj

El tiempo de la partida y los temporizadores.

Los tipos que aparecen en las firmas (Vec3, Texto, el selector) están en la referencia de la API.

Funciones y propiedades de reloj#

reloj.despues#

reloj.despues(segundos: number, fn: () => void): number

Llama a fn una vez, pasados segundos. Devuelve un id para cancelar.

De docs/EJEMPLOS.md, «reloj»:

reloj.despues(3, () => interfaz.mensaje(interfaz.t('ya')));

reloj.cada#

reloj.cada(segundos: number, fn: () => void): number

Llama a fn cada segundos. Devuelve un id para cancelar.

De docs/EJEMPLOS.md, «mundo: luces, ambiente y zonas creadas por el script»:

reloj.cada(0.5, () => (faro.encendida = !faro.encendida));

reloj.cancelar#

reloj.cancelar(id: number): void

Cancela un temporizador. Recibe el id que devolvió reloj.despues o reloj.cada.

De docs/EJEMPLOS.md, «reloj»:

mundo.alEntrar('meta', () => reloj.cancelar(ciclo));

Ejemplos completos#

Scripts completos de docs/EJEMPLOS.md. Cada uno supone una escena con lo que nombra, y las claves de texto (interfaz.t('...')) deben existir en textos de juego.json.

reloj#

import { interfaz, juego, mundo, reloj } from '@greengames/sdk';

juego.alIniciar(() => {
  reloj.despues(3, () => interfaz.mensaje(interfaz.t('ya')));
  const ciclo = reloj.cada(2, () => {
    const puerta = mundo.pieza('puerta');
    puerta.solida = !puerta.solida;
    puerta.visible = puerta.solida;
  });
  mundo.alEntrar('meta', () => reloj.cancelar(ciclo));
});

Sigue con#

• Servicio actores
• Referencia de la API: los once servicios y los tipos comunes.
• Scripts: las reglas de un script y cómo corre dentro de la sala.