Ruffle - Emulador de Adobe Flash Player

Ruffle es un emulador de Adobe Flash Player esencial para ejecutar contenido Flash heredado (juegos, animaciones, aplicaciones y banners SWF). Funciona como una aplicación independiente en todos los sistemas operativos (incluyendo Windows, macOS y Linux) y se integra en los navegadores mediante WebAssembly.

Ruffle proporciona compilaciones independientes para Windows, macOS y Linux que funcionan como programas regulares: simplemente ejecute el ejecutable y abra el archivo SWF deseado dentro de él.

Ruffle aprovecha la seguridad de memoria del lenguaje Rust y el sandbox del navegador moderno. Esto permite que el contenido antiguo potencialmente riesgoso se ejecute sin riesgo de infección del sistema o filtración de datos.

El emulador combina soporte tanto para el AVM1 más antiguo (ActionScript 1 y 2, usado hasta 2006) como para el AVM2 más complejo (ActionScript 3). Esto es necesario para el correcto funcionamiento de prácticamente cualquier contenido Flash, desde animaciones de principios de los 2000 hasta juegos y aplicaciones complejos lanzados justo antes de que la tecnología fuera descontinuada.

Enlaces de descarga:

Windows (64 bits) macOS Linux (x86_64) Linux (ARM64) Flatpak

Todos los enlaces llevan a fuentes oficiales: las compilaciones para Windows (x86_64), macOS (universal para Intel y Apple Silicon), Linux (x86_64 y ARM64 para Raspberry Pi y dispositivos ARM) se distribuyen a través del repositorio de GitHub del proyecto Ruffle, mientras que la versión para Linux en formato Flatpak está disponible a través del catálogo oficial de Flathub con firmas digitales y aislamiento de la aplicación.

Contenido:

Características Clave de Ruffle

Integración mediante WebAssembly. Para su funcionamiento en el navegador, Ruffle se compila a WebAssembly (Wasm) — un bytecode de bajo nivel que se ejecuta dentro del sandbox aislado del navegador con un rendimiento cercano al nativo. Esto permite que el emulador cargue y procese gráficos y lógica Flash complejos sin necesidad de instalar complementos NPAPI/PPAPI obsoletos e inseguros.

Detección Automática y Polyfill de Contenido Flash. La versión web de Ruffle incluye un detector JavaScript que escanea la estructura DOM de la página en busca de elementos object, embed y applet, así como archivos con extensión .swf. Al detectar dicho contenido, Ruffle lo reemplaza automáticamente con su propio reproductor, reparando de forma transparente la página para el usuario y restaurando la funcionalidad de los elementos Flash.

Modo de Operación Dual (Aplicación de Escritorio y Extensión Web). Ruffle ofrece flexibilidad a los usuarios: se puede utilizar como una aplicación de escritorio independiente para reproducir SWF locales (simplemente asocie los archivos con el ejecutable de Ruffle) o como una extensión del navegador que se integra en el entorno de navegación web, proporcionando soporte Flash en cualquier sitio.

Soporte para ActionScript 1.0 y 2.0 (AVM1). Ruffle implementa la máquina virtual AVM1, asegurando la compatibilidad con una gran cantidad de contenido creado antes de 2006 y hasta 2013. El nivel de compatibilidad actual para las construcciones del lenguaje AVM1 alcanza el 99%, y para las APIs, el 81%, garantizando el correcto funcionamiento de la gran mayoría de los primeros juegos y animaciones Flash.

Soporte para ActionScript 3.0 (AVM2). Para el contenido creado después de 2006, Ruffle incluye una implementación de AVM2. Aunque el trabajo de compatibilidad está activo, el emulador ya proporciona un nivel de soporte suficiente para ejecutar muchos juegos y aplicaciones complejos escritos en ActionScript 3, expandiendo constantemente la cobertura de la API y las capacidades del lenguaje.

Seguridad a Nivel del Lenguaje Rust. Una de las principales ventajas arquitectónicas de Ruffle es el uso del lenguaje Rust. Rust garantiza la seguridad de la memoria en tiempo de compilación, eliminando por completo clases enteras de vulnerabilidades que afectaban al Adobe Flash Player original, como desbordamientos de búfer, dobles liberaciones y errores de use-after-free.

Aislamiento dentro del Sandbox del Navegador. Cuando opera en un entorno web, Ruffle (a través de WebAssembly) cumple plenamente con la política de seguridad del navegador. Esto añade una capa adicional de aislamiento: el emulador no tiene acceso directo al sistema de archivos del usuario ni a otros procesos del sistema, lo que hace que su explotación sea extremadamente difícil en comparación con el complemento Flash clásico.

Gestión Eficiente de la Memoria. A diferencia del Flash Player original, que utilizaba la recolección de basura con pausas no deterministas, Ruffle hereda el estricto modelo de propiedad de Rust. Esto permite un uso de la memoria más predecible, reduciendo la fragmentación y eliminando las pérdidas de memoria que a menudo provocaban un comportamiento inestable del navegador.

Soporte de Línea de Comandos. La versión de escritorio de Ruffle ofrece una interfaz de línea de comandos completamente funcional. Los usuarios pueden ejecutar el emulador con parámetros, por ejemplo: ruffle nombrearchivo.swf para un archivo local, o ruffle https://ejemplo.com/nombrearchivo.swf para reproducir un SWF desde una URL. El comando ruffle --help muestra una lista completa de todos los argumentos y configuraciones disponibles.

Código Abierto y Transparencia de Desarrollo. Ruffle se distribuye bajo las licencias Apache 2.0 y MIT. La total apertura del código fuente significa que cualquier desarrollador puede auditar la seguridad del emulador, contribuir con correcciones y participar en su desarrollo, eliminando la posibilidad de características ocultas o vulnerabilidades que podrían ser introducidas por desarrolladores corporativos.

Compatibilidad con una Amplia Gama de Navegadores. Gracias a la tecnología WebAssembly, Ruffle es compatible con todos los navegadores modernos, incluyendo Google Chrome, Mozilla Firefox, Microsoft Edge, Safari, Opera, Brave y Vivaldi. Esto asegura una experiencia consistente con el contenido Flash independientemente de las preferencias del usuario sobre los motores de navegación (Chromium, Gecko o WebKit).

Soporte para Navegadores Móviles (iOS y Android). A diferencia del Adobe Flash Player original, que nunca tuvo soporte oficial en iOS y tenía soporte limitado en Android, Ruffle funciona en plataformas móviles. Esto permite que los juegos y animaciones Flash se ejecuten en smartphones y tabletas directamente a través del navegador móvil, abriendo el acceso al contenido archivado para audiencias móviles.

No Requiere Configuración. Ruffle está diseñado bajo el principio de "configurar y olvidar". Después de instalar la extensión o lanzar la aplicación de escritorio, el emulador no requiere configuración compleja. Detecta automáticamente los parámetros de reproducción como el tamaño del escenario, la velocidad de fotogramas y el tipo de interacción, aplicando la configuración óptima sin intervención del usuario.

Protección Contra Vulnerabilidades de Día Cero. Debido a que Ruffle no es un complemento, no utiliza APIs obsoletas y su código está escrito en Rust con un enfoque en la seguridad, es inmune a los ataques que eran característicos de Adobe Flash Player. Esto lo convierte en una solución ideal para las organizaciones que deben mantener el acceso a contenido heredado pero no pueden arriesgarse a comprometer el sistema.

Compatibilidad con Varios Métodos de Instalación. Ruffle ofrece varios métodos de implementación. Los desarrolladores web pueden instalarlo como una extensión estática en navegadores basados en Chromium (a través del modo desarrollador) o como un complemento temporal en Firefox (a través de about:debugging). También está disponible la integración mediante la inserción de código JavaScript simple en el lado del servidor.

Reproducción de Contenido Tanto Online como Offline. La versión de escritorio de Ruffle permite abrir y reproducir archivos SWF guardados localmente en el ordenador. Esto convierte al emulador en una herramienta indispensable para coleccionistas, archivistas e investigadores que trabajan con archivos locales de juegos y animaciones Flash.

Alto Rendimiento de Renderizado. Ruffle utiliza APIs gráficas modernas (como OpenGL, Vulkan, DirectX o WebGL) a través de bibliotecas multiplataforma. Esto proporciona aceleración por hardware para el renderizado de gráficos vectoriales y rasterizados, permitiendo una reproducción fluida incluso en dispositivos más débiles donde el Flash Player original podría haberse quedado corto.

Desarrollo Activo y Actualizaciones Frecuentes. El proyecto está en desarrollo activo. Los lanzamientos salen regularmente e incluyen tanto correcciones críticas de errores como un mayor soporte de la API de ActionScript. Por ejemplo, las versiones recientes han solucionado casos extremos en los métodos String.indexOf y lastIndexOf, y manejan correctamente los índices negativos en Array.indexOf.

Integración con Archivos y Plataformas Principales. Ruffle ha sido elegido como el reproductor oficial para la reproducción de contenido Flash por gigantes como Internet Archive, Newgrounds, Coolmath Games y Armor Games. Esto confirma el alto grado de fiabilidad y compatibilidad del emulador, así como su capacidad para operar bajo alta carga en condiciones del mundo real.

Soporte para Guardados de Juegos y Estado. Al igual que el Flash Player original, Ruffle es compatible con Local Shared Objects (LSO), que muchos juegos utilizan para guardar el progreso. El emulador emula correctamente los mecanismos de lectura y escritura de datos en este almacenamiento, asegurando la integridad del guardado dentro del tiempo de ejecución de la aplicación.

Emulación Precisa de Tiempos y Velocidad de Fotogramas. Ruffle emula con precisión el temporizador interno del Flash Player, lo cual es crítico para la lógica de juegos y animaciones. Esto asegura una sincronización adecuada de eventos, sonido y movimiento de objetos, evitando situaciones en las que un juego se ejecuta más lento o más rápido que el original.

Soporte para Interacción DOM y JavaScript (ExternalInterface). Para aplicaciones web complejas que utilizaban la API ExternalInterface para intercambiar datos entre ActionScript y JavaScript, Ruffle implementa un puente compatible. Esto permite que el emulador maneje correctamente las llamadas a funciones y la transferencia de datos, preservando la interactividad del contenido con la página web circundante.

Escalado Automático y Adaptación de Resolución. Al reproducir contenido Flash creado para una resolución específica (por ejemplo, 800x600), Ruffle aplica automáticamente algoritmos de escalado para adaptarse al tamaño actual de la ventana del navegador o de la aplicación de escritorio. Conserva las proporciones y la calidad de la imagen, y maneja correctamente las áreas de interacción del mouse.

Soporte para Diversos Formatos Multimedia. El emulador soporta la decodificación de varios formatos multimedia que pueden estar incrustados en archivos SWF, incluyendo MP3 para audio y compresión de video utilizada en versiones posteriores de Flash. La decodificación se realiza a través de bibliotecas de alto rendimiento escritas en Rust, reduciendo la carga del sistema.

Depuración y Registro Avanzados. Para desarrolladores y usuarios avanzados, Ruffle proporciona la capacidad de habilitar registros detallados de las operaciones de la máquina virtual AVM1/AVM2. Esto permite diagnosticar problemas de compatibilidad, rastrear errores en el código ActionScript y comprender los procesos internos de emulación para un ajuste más preciso.

Emulación del Cursor y Elementos Interactivos. Ruffle maneja correctamente los cambios de estilo del cursor especificados por el contenido Flash. Por ejemplo, para elementos interactivos como LoaderDisplay, el emulador cambia automáticamente el cursor estándar a un puntero, imitando el comportamiento del reproductor Flash original y proporcionando una navegación familiar para el usuario.

Soporte para Compilaciones Nocturnas para Acceso Temprano. Además de los lanzamientos estables, el equipo de Ruffle proporciona acceso a compilaciones experimentales diarias (Nightly). Estas compilaciones contienen las últimas correcciones e innovaciones que aún no se han incluido en la versión estable.

Preservación del Patrimonio Cultural Digital. Esta no es solo una función técnica, sino un objetivo fundamental del proyecto. Ruffle fue creado como una herramienta para preservar el contenido histórico de Internet. Gracias a su capacidad para funcionar en navegadores modernos sin comprometer la seguridad, millones de juegos, animaciones y aplicaciones Flash que se habrían perdido permanentemente después de que se descontinuara Adobe Flash Player permanecen accesibles para las generaciones futuras.

12 Capacidades Técnicas Menos Conocidas de Ruffle

  1. Uso de WGPU como el Motor de Renderizado Principal. A diferencia de muchos emuladores que dependen de OpenGL heredado, Ruffle utiliza la biblioteca WGPU — una API gráfica moderna, segura y multiplataforma. En el escritorio, WGPU selecciona automáticamente el backend de bajo nivel más óptimo: Vulkan, DirectX 12 o Metal. En el navegador, puede funcionar a través de WebGPU (cuando está disponible) o emular la operación a través de WebGL con una pérdida mínima de rendimiento.

  2. Soporte de WebGPU en el Navegador para Máximo Rendimiento. Para los usuarios de navegadores modernos (por ejemplo, las últimas versiones de Chrome y Edge), Ruffle puede usar la API de vanguardia WebGPU. Esto proporciona un tiempo de compilación de shaders significativamente reducido y una sobrecarga menor en comparación con el backend estándar de WebGL, lo cual es crítico para gráficos 3D complejos y aplicaciones Stage3D.

  3. Ajuste Fino del Motor de Renderizado (canvas, webgl, wgpu-webgl). Pocos saben que el comportamiento del renderizado se puede controlar manualmente. Además del wgpu-webgl estándar, existe la opción de forzar la activación de:

    • webgl — un backend clásico que se inicializa más rápido y puede ser útil para contenido simple que no requiere efectos de mapa de bits complejos.

    • canvas — el backend más lento, pero más preciso. Es el único que escala correctamente los trazos de línea fina en gráficos vectoriales, que pueden aparecer demasiado gruesos cuando se utiliza aceleración por hardware.

  4. Emulación de Stage3D y Compilación de AGAL a WGSL. Ruffle no solo admite gráficos 2D, sino también aceleración 3D a través de la API Stage3D (Context3D). Los shaders escritos en AGAL (Adobe Graphics Assembly Language) se compilan "sobre la marcha" a WGSL moderno (WebGPU Shading Language) o GLSL. Esto permite ejecutar juegos y aplicaciones 3D complejos creados para Flash Player 11 y superiores, utilizando una canalización completa de shaders programables.

  5. Soporte para fscommand para Compatibilidad con Versiones Anteriores. Ruffle ha conservado el soporte para el mecanismo fscommand heredado pero importante. Esto permite que las películas Flash antiguas (creadas antes de ExternalInterface) interactúen con JavaScript en la página, enviando comandos y argumentos arbitrarios. En la implementación moderna de Ruffle, estos comandos se procesan a través de onFSCommand, permitiendo la funcionalidad incluso para contenido web muy antiguo.

  6. Doble Buffer para Context3D. Cuando se trabaja con contenido 3D, Ruffle utiliza un sofisticado mecanismo de doble buffer (back buffer / front buffer). Esta es una técnica de rendimiento estándar pero críticamente importante, que permite que el siguiente fotograma se renderice en el búfer de fondo mientras el actual se muestra en pantalla, eliminando los artefactos visuales (frame tearing) en juegos dinámicos.

  7. Herramientas de Benchmarking: ruffle_scanner y exporter. Dentro del repositorio de Ruffle, hay herramientas de utilidad no incluidas en la compilación estándar pero disponibles para los desarrolladores:

    • ruffle_scanner — permite probar la compatibilidad del emulador con una carpeta completa de archivos SWF, generando un informe CSV sobre el éxito del análisis.

    • exporter — una herramienta para generar por lotes capturas de pantalla PNG a partir de archivos SWF, que puede ejecutarse en modo headless (sin interfaz gráfica), útil para pruebas automatizadas y creación de vistas previas.

  8. Aislamiento Completo a través del Sandbox de Flatpak. Para usuarios de Linux, hay una compilación oficial de Ruffle en formato Flatpak. Esto no es solo un método de instalación, sino una capa adicional de seguridad: la aplicación se ejecuta en un entorno aislado donde todos los guardados, configuraciones y registros se almacenan estrictamente dentro del directorio home de Flatpak (~/.var/app/rs.ruffle.Ruffle/), sin acceso al resto del sistema.

  9. Soporte de Integración a través de Homebrew y Scoop. Para usuarios experimentados, Ruffle ofrece métodos de instalación avanzados más allá de la descarga manual. En macOS, se puede instalar a través de Homebrew (brew install --HEAD ruffle-rs/ruffle/ruffle), permitiendo actualizaciones automáticas a la última compilación nocturna. En Windows, el administrador de paquetes Scoop cumple una función similar.

  10. Sistema de Almacenamiento de Datos Transparente (SharedObjects). Ruffle emula con precisión el sistema de almacenamiento local de Flash (LSO — Local Shared Objects). Sin embargo, a diferencia del reproductor propietario, la ubicación de estos archivos está estandarizada y es transparente para el usuario. En Windows, se encuentran en %AppData%\Local\Ruffle\SharedObjects\, en Linux — en ~/.local/share/ruffle/SharedObjects/. Esto permite realizar copias de seguridad manuales de los guardados de juegos antiguos.

  11. Configuración a través de la API de JavaScript y Configuración Global. Para desarrolladores web, Ruffle proporciona una potente API de JavaScript, que permite no solo incrustar el reproductor sino también controlar su estado. Hay métodos disponibles para cargar SWF programáticamente (load), controlar el volumen (volume), pausar (suspend/resume) e interceptar las salidas de trace() de ActionScript para depuración a través de traceObserver.

  12. Firma Automática y Notarización de Compilaciones de macOS. En el proceso de CI/CD, todas las compilaciones nocturnas de Ruffle para macOS se someten a firma de código y notarización por parte de Apple. Esto significa que incluso las versiones inestables del emulador no serán bloqueadas por Gatekeeper como software inseguro, lo que garantiza un funcionamiento sin problemas en las últimas versiones de macOS donde los requisitos de seguridad son estrictos.

Instalación de la Versión de Escritorio de Ruffle

La versión de escritorio de Ruffle es una aplicación nativa que le permite abrir y reproducir archivos SWF directamente en su ordenador, sin necesidad de un navegador. Es una opción ideal para ver archivos locales de juegos y animaciones Flash.

Windows (10, 11)

Método 1: Interfaz Gráfica (recomendado)

  1. Descargue el archivo llamado ruffle-windows-x86_64.zip (para sistemas de 64 bits) o ruffle-windows-x86.zip (para sistemas de 32 bits).

  2. Extraiga el contenido del archivo a cualquier carpeta conveniente (por ejemplo, C:\Program Files\Ruffle o C:\Users\[Su_Nombre_de_Usuario]\Documents\Ruffle).

  3. Para ejecutarlo, haga doble clic en el archivo ejecutable ruffle.exe. Se abrirá la interfaz gráfica de la aplicación.

  4. Para abrir un archivo SWF, haga clic en el botón Abrir Archivo en la interfaz o simplemente arrastre y suelte el archivo SWF en la ventana de la aplicación.

  5. Método alternativo: Configure la asociación de archivos. Haga clic derecho en cualquier archivo .swf, seleccione Abrir con → Elegir otra aplicación, ubique ruffle.exe y marque la opción Usar siempre esta aplicación para abrir archivos .swf.

Método 2: Línea de Comandos

Para usuarios experimentados, hay una interfaz de línea de comandos disponible:

  1. Abra el Símbolo del sistema (CMD) o PowerShell.

  2. Navegue hasta la carpeta que contiene ruffle.exe, o agregue esa carpeta a su variable de entorno PATH.

  3. Para ejecutar un archivo local, ejecute el comando:

    ruffle.exe C:\ruta\a\su\archivo.swf

  4. Para ejecutar un archivo SWF desde una URL:

    ruffle.exe https://ejemplo.com/animacion.swf

  5. Para ver todos los parámetros de línea de comandos disponibles:

    ruffle.exe --help

Método 3: Instalación a través del Administrador de Paquetes Scoop

Para quienes prefieren la instalación automatizada:

scoop bucket add extras
scoop install ruffle

macOS

Método 1: Interfaz Gráfica (recomendado)

  1. Descargue el archivo ruffle-macos-x86_64.dmg o ruffle-macos-aarch64.dmg (para Apple Silicon M1/M2/M3) desde la página de lanzamientos.

  2. Abra el archivo .dmg descargado.

  3. Arrastre el icono de Ruffle a la carpeta Aplicaciones.

  4. Inicie Ruffle desde la carpeta Aplicaciones. En el primer inicio, el sistema puede pedir confirmación — haga clic en Abrir.

  5. Después de que la aplicación se inicie, use el botón Abrir Archivo o arrastre y suelte un archivo SWF en la ventana.

Método 2: Instalación a través de Homebrew

Para usuarios avanzados:

# Instalar la última versión estable (si está disponible)
brew install ruffle

# O instalar la última compilación nocturna desde el código fuente
brew install --HEAD ruffle-rs/ruffle/ruffle

Método 3: Línea de Comandos

Después de la instalación a través de Homebrew o de colocar manualmente ruffle en /usr/local/bin:

ruffle ~/Descargas/juego.swf
ruffle https://ejemplo.com/juego.swf

Linux

Método 1: Instalación a través de Flatpak (recomendado para aislamiento)

Flatpak proporciona la máxima seguridad al ejecutar Ruffle en un sandbox aislado:

# Agregar el repositorio Flathub
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

# Instalar Ruffle
flatpak install flathub rs.ruffle.Ruffle

# Ejecutar
flatpak run rs.ruffle.Ruffle

Método 2: Instalación a través de AppImage (no requiere instalación)

  1. Descargue el archivo ruffle-x86_64.AppImage desde la página de lanzamientos.

  2. Haga que el archivo sea ejecutable:

    chmod +x ruffle-x86_64.AppImage

  3. Ejecútelo haciendo doble clic o a través de la terminal:

    ./ruffle-x86_64.AppImage

Método 3: Instalación Manual (para distribuciones basadas en Debian/Ubuntu)

  1. Descargue ruffle-linux-x86_64.tar.gz (o ruffle-linux-armv7.tar.gz para dispositivos ARM como Raspberry Pi).

  2. Extraiga el archivo:

    tar -xzf ruffle-linux-x86_64.tar.gz

  3. Copie el archivo ejecutable a un directorio del sistema:

    sudo cp ruffle /usr/local/bin/

  4. Ejecute desde la terminal:

    ruffle

Instalación de Ruffle como Extensión del Navegador

La extensión de Ruffle detecta automáticamente el contenido Flash en cualquier página web y lo reemplaza con el emulador.

Nota Importante

Actualmente, la extensión no está alojada en las tiendas oficiales de extensiones (Chrome Web Store, Firefox Add-ons) y está en desarrollo activo. La instalación se realiza manualmente, a través del modo desarrollador del navegador.

Instalación en Google Chrome y Navegadores Basados en Chromium

Navegadores compatibles: Google Chrome, Microsoft Edge, Brave, Opera, Vivaldi, Arc y otros basados en Chromium.

Instrucciones paso a paso:

  1. Vaya a la página de lanzamientos de Ruffle en GitHub.

  2. Descargue el archivo llamado ruffle-chromium.zip (o similar que contenga chromium).

  3. Extraiga el archivo a una carpeta permanente en su ordenador. Importante: No elimine esta carpeta después de la instalación, ya que el navegador accederá a ella para que la extensión funcione. Ubicaciones recomendadas:

    • Windows: C:\Users\[Su_Nombre_de_Usuario]\AppData\Local\Ruffle\

    • macOS: ~/Library/Application Support/Ruffle/

    • Linux: ~/.local/share/ruffle/

  4. Abra su navegador e ingrese lo siguiente en la barra de direcciones:

    chrome://extensions/

  5. En la esquina superior derecha de la página, active el Modo desarrollador.

  6. Haga clic en el botón Cargar descomprimida.

  7. En el cuadro de diálogo que se abre, seleccione la carpeta donde extrajo el archivo ruffle-chromium.zip y haga clic en Seleccionar carpeta.

  8. La extensión está instalada. Ahora, al visitar sitios con contenido Flash, Ruffle se activará automáticamente.

Para Microsoft Edge (Chromium): El proceso es idéntico al de Chrome. Use edge://extensions/ en lugar de chrome://extensions/ y active el modo desarrollador.

Instalación en Mozilla Firefox

Importante: En Firefox, la extensión se instala solo de forma temporal y se eliminará después de reiniciar el navegador. Esta es una limitación de Firefox para extensiones no firmadas. Para un uso permanente, se recomienda utilizar la versión de escritorio o esperar la publicación en la tienda oficial.

Instrucciones paso a paso:

  1. Vaya a la página de lanzamientos de Ruffle en GitHub.

  2. Descargue el archivo llamado ruffle-firefox.xpi. Al descargar, elija Guardar archivo.

  3. En Firefox, ingrese lo siguiente en la barra de direcciones:

    about:debugging

  4. En la barra lateral izquierda, seleccione Este Firefox.

  5. Haga clic en el botón Cargar complemento temporal….

  6. En el cuadro de diálogo de archivos, seleccione el archivo ruffle-firefox.xpi descargado y haga clic en Abrir.

  7. La extensión se cargará y activará. Funcionará hasta que cierre el navegador.

Consejo: Si usa Firefox Nightly o Developer Edition, puede desactivar la verificación de firmas de extensiones a través de about:config, lo que permite la instalación permanente, pero esto no se recomienda para el uso diario por razones de seguridad.

Instalación en Safari (macOS)

La instalación de la extensión Ruffle en Safari requiere pasos adicionales debido a la política de seguridad de Apple.

  1. Descargue el archivo ruffle-safari.zip desde la página de lanzamientos.

  2. Extraiga el archivo.

  3. Ejecute el archivo Ruffle.app de la carpeta extraída. Esto instalará la extensión en su sistema.

  4. Abra Safari, vaya a Safari → Configuración → pestaña Extensiones.

  5. Asegúrese de que el interruptor junto a Ruffle esté en On.

  6. La extensión está activada y funcionará con el contenido Flash en las páginas web.

Instalación de Ruffle en un Sitio Web (para Webmasters)

Si posee un sitio web que aloja contenido Flash, puede integrar Ruffle directamente en el código de su página. Esto permitirá que los visitantes de su sitio reproduzcan automáticamente el contenido Flash sin instalar ninguna extensión.

El Método Más Simple: Usando el Reproductor JavaScript

  1. Descargue el archivo ruffle.js y la carpeta de recursos ruffle desde la página de lanzamientos.

  2. Sube estos archivos a su servidor (por ejemplo, en una carpeta como /js/ruffle/).

  3. Agregue el siguiente código a la sección <head> de cada página donde esté presente el contenido Flash:

<script src="/js/ruffle/ruffle.js"></script>
<script>
    window.RufflePlayer = window.RufflePlayer || {};
    window.RufflePlayer.config = {
        // Configuración del reproductor
        autoplay: "auto", // "on", "off" or "auto"
        splashScreen: false, // Desactivar pantalla de presentación
    };
</script>

  1. Ruffle detectará automáticamente todos los elementos object, embed y applet en la página y los reemplazará con su reproductor.

Configuración Avanzada a través de CDN (sin descargar archivos)

Para pruebas rápidas, puede usar un CDN:

<script src="https://unpkg.com/@ruffle-rs/ruffle"></script>
<script>
    window.RufflePlayer = window.RufflePlayer || {};
    window.RufflePlayer.config = {
        autoplay: "on",
    };
</script>

Inicialización Manual para Contenido Cargado Dinámicamente:

Si los archivos SWF se agregan a la página de forma dinámica (a través de JavaScript), puede inicializar manualmente el reproductor:

const ruffle = window.RufflePlayer.newest();
const player = ruffle.createPlayer();
player.style.width = "800px";
player.style.height = "600px";
player.load("ruta/a/su/archivo.swf");
document.body.appendChild(player);

Verificación del Funcionamiento

Después de instalar Ruffle utilizando cualquier método, puede verificar su funcionamiento:

  1. Versión de escritorio: Simplemente abra cualquier archivo SWF.

  2. Extensión del navegador: Visite la colección de juegos Flash de Internet Archive o cualquier sitio con contenido Flash conocido. Si el elemento Flash se muestra y reproduce, Ruffle está funcionando correctamente.

  3. Diagnóstico: En su navegador, presione F12 para abrir las herramientas de desarrollo. En la consola, verá mensajes de Ruffle confirmando su activación.

Solución de Problemas Comunes

Problema Solución Posible
La extensión no se activa en un sitio Asegúrese de que el sitio no esté bloqueado en la configuración de la extensión. Verifique que el modo desarrollador esté activado en chrome://extensions/.
El archivo SWF no se reproduce o muestra una pantalla blanca La versión actual de Ruffle puede no ser compatible con este archivo SWF específico. Verifique si el contenido es AVM2 (ActionScript 3), cuyo soporte aún se está perfeccionando.
No se puede abrir el archivo en la versión de escritorio Asegúrese de que el archivo no esté dañado. Intente abrirlo desde la línea de comandos con la bandera --verbose para obtener registros de error detallados.
La extensión desapareció después de reiniciar Firefox Este es un comportamiento normal para las extensiones temporales. Utilice la versión de escritorio o espere la publicación oficial en la tienda de complementos.
Bajo rendimiento en el navegador Intente cambiar el motor de renderizado en la configuración de la extensión. Para navegadores Chromium, también verifique si la aceleración por hardware está activada en la configuración del navegador.