Plus API de Lua

Callbacks de video

Esta página documenta los callbacks Lua expuestos por LuaVideo.hx y las variables internas que controlan la reproducción, ubicación y limpieza de sprites de video.

CallbacksFunciones Lua disponibles para videos Variables de videoEstado interno y parámetros Video de presentaciónVista local usando present.mp4

Video de presentación

La vista previa ahora usa el archivo local assets/videos/present.mp4. Con eso la página ya no depende de embeds externos y evita bloqueos del navegador.

Callbacks de video

  • playLuaVideoSprite(tag, path, x, y, front) crea y reproduce un sprite de video.
  • pauseLuaVideo(tag) pausa el video activo asociado al tag.
  • resumeLuaVideo(tag) reanuda el video activo asociado al tag.
  • removeLuaVideo(tag) solicita una eliminación segura del sprite.
  • forceRemoveLuaVideo(tag) omite la protección de eliminación retrasada.
  • luaVideoExists(tag) verifica si el video etiquetado existe.
  • isLuaVideoPlaying(tag) devuelve el estado actual de reproducción.
  • setLuaVideoVolume(tag, volume) ajusta el volumen de reproducción.
  • getLuaVideoDuration(tag) devuelve la duración total en segundos.
  • getLuaVideoTime(tag) devuelve la posición actual de reproducción en segundos.

Variables de video

Estas variables y parámetros siguen el mismo estilo de documentación que Psych: primero el nombre y después una explicación directa de qué hace cada uno.

tagClave única para guardar y recuperar el sprite de video. pathRuta de medios resuelta con Paths.video(path). xPosición horizontal aplicada cuando termina la configuración del formato. yPosición vertical aplicada cuando termina la configuración del formato. frontSi es true, el sprite se agrega encima de la pila de juego. volumeVolumen normalizado usado por setLuaVideoVolume. activeVideosMapa interno que guarda los sprites activos por tag. allowDestroyProtección interna que retrasa la destrucción hasta que el sprite esté listo. isDestroyedBandera interna que evita destruir el mismo video dos veces.

tag

Identificador usado como clave de referencia para el sprite de video. Todos los callbacks que trabajan con un video usan ese mismo tag para encontrarlo.

path

Ruta del archivo de video que recibe playLuaVideoSprite. El motor la resuelve con Paths.video(path) antes de cargar el sprite.

x

Posición horizontal del sprite de video. Se aplica cuando termina el callback de configuración del formato y ya se puede actualizar el hitbox.

y

Posición vertical del sprite de video. Igual que x, se aplica después de la configuración inicial del video.

front

Bandera de capa usada por playLuaVideoSprite. Si vale true, el sprite se agrega por encima de la pila del playfield.

volume

Valor de volumen normalizado usado por setLuaVideoVolume. El callback lo traduce al volumen interno del reproductor.

activeVideos

Mapa interno que guarda los sprites de video activos por tag.

allowDestroy

Protección interna que retrasa la destrucción unos segundos para que el sprite no se elimine durante la inicialización.

isDestroyed

Bandera interna que evita destruir el mismo video dos veces.

Notas

  • VIDEOS_ALLOWED debe estar activado al compilar.
  • onVideoFinished(tag) se dispara cuando el video termina.
  • forceRemoveLuaVideo(tag) sirve cuando la limpieza debe ser inmediata.
  • La documentación queda lista para sumar más ejemplos de video después.