Ruffle - Emulador de Adobe Flash Player

Ruffle é um emulador de Adobe Flash Player essencial para executar conteúdo Flash legado (jogos, animações, aplicações e banners SWF). Ele opera como uma aplicação autónoma em todos os sistemas operativos (incluindo Windows, macOS e Linux) e integra-se em navegadores via WebAssembly.

O Ruffle fornece compilações separadas para Windows, macOS e Linux que funcionam como programas normais: basta executar o executável e abrir o ficheiro SWF desejado dentro dele.

O Ruffle aproveita a segurança de memória da linguagem Rust e a sandbox do navegador moderno. Isso permite que conteúdo antigo potencialmente arriscado seja executado sem o risco de infeção do sistema ou fuga de dados.

O emulador combina suporte para o AVM1 mais antigo (ActionScript 1 e 2, usado até 2006) e o AVM2 mais complexo (ActionScript 3). Isto é necessário para o funcionamento correto de praticamente qualquer conteúdo Flash, desde animações do início dos anos 2000 até jogos e aplicações complexos lançados pouco antes da tecnologia ser descontinuada.

Links para download:

Windows (64-bit) macOS Linux (x86_64) Linux (ARM64) Flatpak

Todos os links direcionam para fontes oficiais: as compilações para Windows (x86_64), macOS (universal para Intel e Apple Silicon), Linux (x86_64 e ARM64 para Raspberry Pi e dispositivos ARM) são distribuídas através do repositório GitHub do projeto Ruffle, enquanto a versão Linux no formato Flatpak está disponível através do catálogo oficial Flathub com assinaturas digitais e isolamento da aplicação.

Conteúdo:

Principais Características do Ruffle

Integração via WebAssembly. Para operação no navegador, o Ruffle compila para WebAssembly (Wasm) — um bytecode de baixo nível executado dentro da sandbox isolada do navegador com desempenho próximo ao nativo. Isso permite que o emulador carregue e processe gráficos e lógica Flash complexos sem a necessidade de instalar plugins NPAPI/PPAPI desatualizados e inseguros.

Deteção Automática e Polyfilling de Conteúdo Flash. A versão web do Ruffle inclui um detetor JavaScript que examina a estrutura DOM da página em busca de elementos object, embed e applet, bem como ficheiros com extensão .swf. Ao detetar esse conteúdo, o Ruffle substitui-o automaticamente pelo seu próprio reprodutor, corrigindo de forma transparente a página para o utilizador e restaurando a funcionalidade do elemento Flash.

Modo Duplo de Operação (Aplicação Desktop e Extensão Web). O Ruffle oferece flexibilidade aos utilizadores: pode ser usado como uma aplicação desktop autónoma para reprodução local de SWF (simplesmente associando ficheiros ao executável do Ruffle) ou como uma extensão de navegador que se integra no ambiente de navegação web, fornecendo suporte Flash em qualquer site.

Suporte para ActionScript 1.0 e 2.0 (AVM1). O Ruffle implementa a máquina virtual AVM1, garantindo compatibilidade com um vasto corpo de conteúdo criado antes de 2006 e até 2013. O nível de compatibilidade atual para construções da linguagem AVM1 atinge 99%, e para APIs — 81%, garantindo o funcionamento correto da grande maioria dos jogos e animações Flash antigos.

Suporte para ActionScript 3.0 (AVM2). Para conteúdo criado após 2006, o Ruffle inclui uma implementação do AVM2. Embora o trabalho de compatibilidade esteja ativamente em andamento, o emulador já fornece um nível de suporte suficiente para executar muitos jogos e aplicações complexos escritos em ActionScript 3, expandindo constantemente a cobertura de API e as capacidades da linguagem.

Segurança ao Nível da Linguagem Rust. Uma das principais vantagens arquitetônicas do Ruffle é o uso da linguagem Rust. Rust garante segurança de memória em tempo de compilação, eliminando completamente classes inteiras de vulnerabilidades que afetavam o Adobe Flash Player original, como estouros de buffer, double frees e erros de use-after-free.

Isolamento dentro da Sandbox do Navegador. Quando opera num ambiente web, o Ruffle (via WebAssembly) cumpre totalmente a política de segurança do navegador. Isso adiciona uma camada extra de isolamento: o emulador não tem acesso direto ao sistema de ficheiros do utilizador ou a outros processos do sistema, tornando a sua exploração extremamente difícil em comparação com o plugin Flash clássico.

Gestão Eficiente de Memória. Ao contrário do Flash Player original, que usava coleta de lixo com pausas não determinísticas, o Ruffle herda o rigoroso modelo de propriedade do Rust. Isso permite um uso de memória mais previsível, reduzindo a fragmentação e eliminando vazamentos de memória que frequentemente levavam a um comportamento instável do navegador.

Suporte a Linha de Comando. A versão desktop do Ruffle oferece uma interface de linha de comando totalmente funcional. Os utilizadores podem executar o emulador com parâmetros, por exemplo: ruffle filename.swf para um ficheiro local, ou ruffle https://example.com/filename.swf para reproduzir um SWF a partir de um URL. O comando ruffle --help exibe uma lista abrangente de todos os argumentos e configurações disponíveis.

Código Aberto e Transparência de Desenvolvimento. O Ruffle é distribuído sob as licenças Apache 2.0 e MIT. A total abertura do código fonte significa que qualquer programador pode auditar a segurança do emulador, contribuir com correções e participar no seu desenvolvimento, eliminando a possibilidade de funcionalidades ocultas ou vulnerabilidades que possam ser introduzidas por programadores corporativos.

Compatibilidade com uma Ampla Gama de Navegadores. Graças à tecnologia WebAssembly, o Ruffle é suportado por todos os navegadores modernos, incluindo Google Chrome, Mozilla Firefox, Microsoft Edge, Safari, Opera, Brave e Vivaldi. Isso garante uma experiência consistente com conteúdo Flash, independentemente das preferências do utilizador por engines de navegador (Chromium, Gecko ou WebKit).

Suporte para Navegadores Móveis (iOS e Android). Ao contrário do Adobe Flash Player original, que nunca foi oficialmente suportado no iOS e tinha suporte limitado no Android, o Ruffle funciona em plataformas móveis. Isso permite que jogos e animações Flash sejam executados em smartphones e tablets diretamente através do navegador móvel, abrindo acesso a conteúdo arquivado para audiências móveis.

Nenhuma Configuração Necessária. O Ruffle é projetado no princípio "configure e esqueça". Após instalar a extensão ou iniciar a aplicação desktop, o emulador não requer configuração complexa. Ele deteta automaticamente parâmetros de reprodução como tamanho do palco, taxa de quadros e tipo de interação, aplicando configurações ideais sem intervenção do utilizador.

Proteção Contra Vulnerabilidades Zero-Day. Como o Ruffle não é um plugin, não usa APIs desatualizadas e seu código é escrito em Rust com foco na segurança, ele é imune a ataques que eram característicos do Adobe Flash Player. Isso o torna uma solução ideal para organizações que devem manter acesso a conteúdo legado, mas não podem arriscar o comprometimento do sistema.

Compatibilidade com Vários Métodos de Instalação. O Ruffle oferece vários métodos de implantação. Os programadores web podem instalá-lo como uma extensão estática em navegadores baseados em Chromium (via modo de programador) ou como um add-on temporário no Firefox (via about:debugging). A integração via inserção simples de código JavaScript no lado do servidor também está disponível.

Reprodução de Conteúdo Online e Offline. A versão desktop do Ruffle permite abrir e reproduzir ficheiros SWF guardados localmente no computador. Isso torna o emulador uma ferramenta indispensável para colecionadores, arquivistas e investigadores que trabalham com arquivos locais de jogos e animações Flash.

Alto Desempenho de Renderização. O Ruffle usa APIs gráficas modernas (como OpenGL, Vulkan, DirectX ou WebGL) através de bibliotecas multiplataforma. Isso fornece aceleração por hardware para renderização de gráficos vetoriais e rasterizados, permitindo uma reprodução suave mesmo em dispositivos mais fracos onde o Flash Player original poderia engasgar.

Desenvolvimento Ativo e Atualizações Frequentes. O projeto está em desenvolvimento ativo. Os lançamentos saem regularmente e incluem correções críticas de bugs e suporte expandido à API ActionScript. Por exemplo, versões recentes corrigiram casos extremos nos métodos String.indexOf e lastIndexOf, e trataram corretamente índices negativos em Array.indexOf.

Integração com Grandes Arquivos e Plataformas. O Ruffle foi escolhido como o reprodutor oficial para reprodução de conteúdo Flash por gigantes como o Internet Archive, Newgrounds, Coolmath Games e Armor Games. Isso confirma o alto grau de fiabilidade e compatibilidade do emulador, bem como a sua capacidade de operar sob alta carga em condições reais.

Suporte para Gravações e Estado do Jogo. Como o Flash Player original, o Ruffle suporta Objetos Locais Partilhados (LSO), que muitos jogos usam para guardar o progresso. O emulador emula corretamente os mecanismos de leitura e escrita de dados neste armazenamento, garantindo a integridade do save dentro do tempo de execução da aplicação.

Emulação Precisa de Temporizações e Taxa de Quadros. O Ruffle emula com precisão o temporizador interno do Flash Player, o que é crítico para a lógica de jogos e animações. Isso garante a sincronização adequada de eventos, som e movimento de objetos, evitando situações em que um jogo funcione mais devagar ou mais rápido que o original.

Suporte para Interação DOM e JavaScript (ExternalInterface). Para aplicações web complexas que usavam a API ExternalInterface para trocar dados entre ActionScript e JavaScript, o Ruffle implementa uma ponte compatível. Isso permite que o emulador trate corretamente chamadas de função e transferência de dados, preservando a interatividade do conteúdo com a página web circundante.

Escalonamento Automático e Adaptação de Resolução. Ao reproduzir conteúdo Flash criado para uma resolução específica (por exemplo, 800x600), o Ruffle aplica automaticamente algoritmos de escalonamento para se adaptar ao tamanho atual da janela do navegador ou da aplicação desktop. Ele preserva proporções e qualidade de imagem e trata corretamente as áreas de interação do rato.

Suporte para Diversos Formatos de Mídia. O emulador suporta a descodificação de vários formatos de mídia que podem estar embutidos em ficheiros SWF, incluindo MP3 para áudio e compressão de vídeo usada em versões posteriores do Flash. A descodificação é realizada através de bibliotecas de alto desempenho escritas em Rust, reduzindo a carga do sistema.

Depuração e Registo Avançados. Para programadores e utilizadores avançados, o Ruffle fornece a capacidade de ativar registos detalhados das operações das máquinas virtuais AVM1/AVM2. Isso permite diagnosticar problemas de compatibilidade, rastrear erros no código ActionScript e compreender os processos internos da emulação para um ajuste mais preciso.

Emulação de Cursor e Elementos Interativos. O Ruffle trata corretamente as alterações de estilo do cursor especificadas pelo conteúdo Flash. Por exemplo, para elementos interativos como LoaderDisplay, o emulador muda automaticamente o cursor padrão para um ponteiro, imitando o comportamento do reprodutor Flash original e fornecendo navegação familiar para o utilizador.

Suporte para Compilações Noturnas (Nightly) para Acesso Antecipado. Além dos lançamentos estáveis, a equipa do Ruffle fornece acesso a compilações experimentais diárias (Nightly). Essas compilações contêm as correções e inovações mais recentes ainda não incluídas na versão estável.

Preservação do Património Cultural Digital. Esta não é apenas uma função técnica, mas um objetivo fundamental do projeto. O Ruffle foi criado como uma ferramenta para preservar o conteúdo histórico da internet. Graças à sua capacidade de funcionar em navegadores modernos sem comprometer a segurança, milhões de jogos Flash, animações e aplicações que teriam sido permanentemente perdidos após a descontinuação do Adobe Flash Player permanecem acessíveis para as gerações futuras.

12 Capacidades Técnicas Menos Conhecidas do Ruffle

  1. Uso do WGPU como Backend de Renderização Principal. Ao contrário de muitos emuladores que dependem de OpenGL legado, o Ruffle usa a biblioteca WGPU — uma API gráfica moderna, segura e multiplataforma. No desktop, o WGPU seleciona automaticamente o backend de baixo nível mais ideal: Vulkan, DirectX 12 ou Metal. No navegador, pode funcionar via WebGPU (quando disponível) ou emular a operação através do WebGL com perda mínima de desempenho.

  2. Suporte a WebGPU no Navegador para Máximo Desempenho. Para utilizadores de navegadores modernos (por exemplo, versões mais recentes do Chrome e Edge), o Ruffle pode usar a API de ponta WebGPU. Isso proporciona um tempo de compilação de shaders significativamente reduzido e menor sobrecarga em comparação com o backend WebGL padrão, o que é crítico para gráficos 3D complexos e aplicações Stage3D.

  3. Ajuste Fino do Backend de Renderização (canvas, webgl, wgpu-webgl). Poucos sabem que o comportamento da renderização pode ser controlado manualmente. Além do padrão wgpu-webgl, existe a opção de forçar a ativação:

    • webgl — um backend clássico que inicializa mais rápido e pode ser útil para conteúdo simples que não requer efeitos bitmap complexos.

    • canvas — o backend mais lento, mas mais preciso. É o único que escala corretamente traços finos em gráficos vetoriais, que podem parecer muito grossos ao usar aceleração por hardware.

  4. Emulação de Stage3D e Compilação de AGAL para WGSL. O Ruffle suporta não apenas gráficos 2D, mas também aceleração 3D através da API Stage3D (Context3D). Shaders escritos em AGAL (Adobe Graphics Assembly Language) são compilados "em tempo real" para WGSL (WebGPU Shading Language) ou GLSL modernos. Isso permite executar jogos e aplicações 3D complexos criados para Flash Player 11 e superior, utilizando um pipeline completo de shaders programáveis.

  5. Suporte para fscommand para Retrocompatibilidade. O Ruffle manteve o suporte para o mecanismo legado, mas importante, fscommand. Isso permite que filmes Flash antigos (criados antes do ExternalInterface) interajam com JavaScript na página, enviando comandos e argumentos arbitrários. Na implementação moderna do Ruffle, esses comandos são processados via onFSCommand, permitindo funcionalidade mesmo para conteúdo web muito antigo.

  6. Double Buffering para Context3D. Ao trabalhar com conteúdo 3D, o Ruffle usa um sofisticado mecanismo de double buffering (back buffer / front buffer). Esta é uma técnica de desempenho padrão, mas criticamente importante, permitindo que o próximo quadro seja renderizado no buffer de fundo enquanto o atual é exibido no ecrã, eliminando artefatos visuais (frame tearing) em jogos dinâmicos.

  7. Ferramentas de Benchmarking: ruffle_scanner e exporter. Dentro do repositório do Ruffle, existem ferramentas utilitárias não incluídas na compilação padrão, mas disponíveis para programadores:

    • ruffle_scanner — permite testar a compatibilidade do emulador com uma pasta inteira de ficheiros SWF, gerando um relatório CSV sobre o sucesso da análise.

    • exporter — uma ferramenta para gerar em lote capturas de ecrã PNG a partir de ficheiros SWF, que pode ser executada em modo headless (sem GUI), útil para testes automatizados e criação de pré-visualizações.

  8. Isolamento Completo via Sandbox Flatpak. Para utilizadores Linux, existe uma compilação oficial do Ruffle no formato Flatpak. Esta não é apenas um método de instalação, mas uma camada adicional de segurança: a aplicação é executada num ambiente isolado onde todos os saves, configurações e registos são armazenados estritamente dentro do diretório home do Flatpak (~/.var/app/rs.ruffle.Ruffle/), sem acesso ao resto do sistema.

  9. Suporte à Integração via Homebrew e Scoop. Para utilizadores experientes, o Ruffle oferece métodos de instalação avançados além do download manual. No macOS, pode ser instalado via Homebrew (brew install --HEAD ruffle-rs/ruffle/ruffle), permitindo atualizações automáticas para a compilação noturna mais recente. No Windows, o gestor de pacotes Scoop serve uma função semelhante.

  10. Sistema de Armazenamento de Dados Transparente (SharedObjects). O Ruffle emula com precisão o sistema de armazenamento local Flash (LSO — Local Shared Objects). No entanto, ao contrário do reprodutor proprietário, a localização destes ficheiros é padronizada e transparente para o utilizador. No Windows, estão localizados em %AppData%\Local\Ruffle\SharedObjects\, no Linux — em ~/.local/share/ruffle/SharedObjects/. Isso permite backup manual de saves de jogos antigos.

  11. Configuração via API JavaScript e Configurações Globais. Para programadores web, o Ruffle fornece uma poderosa API JavaScript, permitindo não apenas embutir o reprodutor, mas também controlar o seu estado. Métodos estão disponíveis para carregar SWF programaticamente (load), controlar volume (volume), pausar (suspend/resume) e interceptar saídas trace() do ActionScript para depuração via traceObserver.

  12. Assinatura Automática e Notarização das Compilações macOS. No processo CI/CD, todas as compilações noturnas do Ruffle para macOS passam por assinatura de código e notarização pela Apple. Isso significa que mesmo versões instáveis do emulador não serão bloqueadas pelo Gatekeeper como software inseguro, garantindo operação sem problemas nas versões mais recentes do macOS, onde os requisitos de segurança são rigorosos.

Instalando a Versão Desktop do Ruffle

A versão desktop do Ruffle é uma aplicação nativa que permite abrir e reproduzir ficheiros SWF diretamente no seu computador, sem necessidade de navegador. Esta é uma escolha ideal para visualizar arquivos locais de jogos e animações Flash.

Windows (10, 11)

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

  1. Descarregue o ficheiro chamado ruffle-windows-x86_64.zip (para sistemas de 64 bits) ou ruffle-windows-x86.zip (para sistemas de 32 bits).

  2. Extraia o conteúdo do arquivo para qualquer pasta conveniente (por exemplo, C:\Program Files\Ruffle ou C:\Users\[Seu_NomeDeUtilizador]\Documents\Ruffle).

  3. Para executar, clique duas vezes no ficheiro executável ruffle.exe. A interface gráfica da aplicação será aberta.

  4. Para abrir um ficheiro SWF, clique no botão Open File na interface ou simplesmente arraste e solte o ficheiro SWF para a janela da aplicação.

  5. Método alternativo: Configure a associação de ficheiros. Clique com o botão direito em qualquer ficheiro .swf, selecione Open with → Choose another app, localize ruffle.exe e marque a opção Always use this app to open .swf files.

Método 2: Linha de Comando

Para utilizadores experientes, uma interface de linha de comando está disponível:

  1. Abra o Prompt de Comando (CMD) ou PowerShell.

  2. Navegue até a pasta que contém ruffle.exe ou adicione essa pasta à sua variável de ambiente PATH.

  3. Para executar um ficheiro local, execute o comando:

    ruffle.exe C:\caminho\para\seu\ficheiro.swf

  4. Para executar um ficheiro SWF a partir de um URL:

    ruffle.exe https://exemplo.com/animacao.swf

  5. Para ver todos os parâmetros de linha de comando disponíveis:

    ruffle.exe --help

Método 3: Instalação via Gestor de Pacotes Scoop

Para quem prefere instalação automatizada:

scoop bucket add extras
scoop install ruffle

macOS

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

  1. Descarregue o ficheiro ruffle-macos-x86_64.dmg ou ruffle-macos-aarch64.dmg (para Apple Silicon M1/M2/M3) da página de lançamentos.

  2. Abra o ficheiro .dmg descarregado.

  3. Arraste o ícone do Ruffle para a pasta Applications.

  4. Inicie o Ruffle a partir da pasta Applications. No primeiro lançamento, o sistema pode pedir confirmação — clique em Open.

  5. Após a aplicação iniciar, use o botão Open File ou arraste e solte um ficheiro SWF para a janela.

Método 2: Instalação via Homebrew

Para utilizadores avançados:

# Instalar a versão estável mais recente (se disponível)
brew install ruffle

# Ou instalar a compilação noturna mais recente a partir do código fonte
brew install --HEAD ruffle-rs/ruffle/ruffle

Método 3: Linha de Comando

Após a instalação via Homebrew ou colocando manualmente o ruffle em /usr/local/bin:

ruffle ~/Downloads/game.swf
ruffle https://exemplo.com/game.swf

Linux

Método 1: Instalação via Flatpak (recomendado para isolamento)

Flatpak fornece segurança máxima ao executar o Ruffle numa sandbox isolada:

# Adicionar o repositório Flathub
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

# Instalar o Ruffle
flatpak install flathub rs.ruffle.Ruffle

# Executar
flatpak run rs.ruffle.Ruffle

Método 2: Instalação via AppImage (não requer instalação)

  1. Descarregue o ficheiro ruffle-x86_64.AppImage da página de lançamentos.

  2. Torne o ficheiro executável:

    chmod +x ruffle-x86_64.AppImage

  3. Execute-o clicando duas vezes ou via terminal:

    ./ruffle-x86_64.AppImage

Método 3: Instalação Manual (para distribuições baseadas em Debian/Ubuntu)

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

  2. Extraia o arquivo:

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

  3. Copie o ficheiro executável para um diretório do sistema:

    sudo cp ruffle /usr/local/bin/

  4. Execute a partir do terminal:

    ruffle

Instalando o Ruffle como Extensão de Navegador

A extensão Ruffle deteta automaticamente conteúdo Flash em qualquer página web e substitui-o pelo emulador.

Nota Importante

Atualmente, a extensão não está alojada nas lojas de extensões oficiais (Chrome Web Store, Firefox Add-ons) e está em desenvolvimento ativo. A instalação é feita manualmente, através do modo de programador do navegador.

Instalação no Google Chrome e Navegadores Baseados em Chromium

Navegadores suportados: Google Chrome, Microsoft Edge, Brave, Opera, Vivaldi, Arc e outros baseados em Chromium.

Instruções passo a passo:

  1. Vá para a página de lançamentos do Ruffle no GitHub.

  2. Descarregue o arquivo chamado ruffle-chromium.zip (ou similar contendo chromium).

  3. Extraia o arquivo para uma pasta permanente no seu computador. Importante: Não elimine esta pasta após a instalação, pois o navegador a acederá para a extensão funcionar. Localizações recomendadas:

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

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

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

  4. Abra o seu navegador e digite o seguinte na barra de endereço:

    chrome://extensions/

  5. No canto superior direito da página, ative o Modo de programador.

  6. Clique no botão Carregar sem compactação.

  7. No diálogo que se abre, selecione a pasta onde extraiu o arquivo ruffle-chromium.zip e clique em Selecionar Pasta.

  8. A extensão está instalada. Agora, ao visitar sites com conteúdo Flash, o Ruffle será ativado automaticamente.

Para Microsoft Edge (Chromium): O processo é idêntico ao do Chrome. Use edge://extensions/ em vez de chrome://extensions/ e ative o modo de programador.

Instalação no Mozilla Firefox

Importante: No Firefox, a extensão instala apenas temporariamente e será removida após o reinício do navegador. Esta é uma limitação do Firefox para extensões não assinadas. Para uso permanente, recomenda-se usar a versão desktop ou aguardar a publicação na loja oficial.

Instruções passo a passo:

  1. Vá para a página de lançamentos do Ruffle no GitHub.

  2. Descarregue o ficheiro chamado ruffle-firefox.xpi. Ao descarregar, escolha Guardar Ficheiro.

  3. No Firefox, digite o seguinte na barra de endereço:

    about:debugging

  4. Na barra lateral esquerda, selecione Este Firefox.

  5. Clique no botão Carregar Add-on Temporário….

  6. No diálogo de ficheiros, selecione o ficheiro ruffle-firefox.xpi descarregado e clique em Abrir.

  7. A extensão será carregada e ativada. Funcionará até fechar o navegador.

Dica: Se usar Firefox Nightly ou Developer Edition, pode desativar a verificação de assinatura da extensão via about:config, o que permite a instalação permanente, mas isto não é recomendado para uso diário por razões de segurança.

Instalação no Safari (macOS)

A instalação da extensão Ruffle no Safari requer passos adicionais devido à política de segurança da Apple.

  1. Descarregue o ficheiro ruffle-safari.zip da página de lançamentos.

  2. Extraia o arquivo.

  3. Execute o ficheiro Ruffle.app da pasta extraída. Isto instalará a extensão no seu sistema.

  4. Abra o Safari, vá a Safari → Definições → separador Extensões.

  5. Certifique-se de que o interruptor ao lado de Ruffle está definido como Ativado.

  6. A extensão está ativada e funcionará com conteúdo Flash em páginas web.

Instalando o Ruffle num Site (para Webmasters)

Se é proprietário de um site que aloja conteúdo Flash, pode integrar o Ruffle diretamente no código da sua página. Isto permitirá que os visitantes do seu site reproduzam conteúdo Flash automaticamente sem instalar extensões.

O Método Mais Simples: Usando o Reprodutor JavaScript

  1. Descarregue o ficheiro ruffle.js e a pasta de recursos ruffle da página de lançamentos.

  2. Carregue estes ficheiros para o seu servidor (por exemplo, numa pasta como /js/ruffle/).

  3. Adicione o seguinte código à secção <head> de cada página onde o conteúdo Flash está presente:

<script src="/js/ruffle/ruffle.js"></script>
<script>
    window.RufflePlayer = window.RufflePlayer || {};
    window.RufflePlayer.config = {
        // Configurações do reprodutor
        autoplay: "auto", // "on", "off" ou "auto"
        splashScreen: false, // Desativar ecrã de abertura
    };
</script>

  1. O Ruffle detetará automaticamente todos os elementos object, embed e applet na página e substituí-los-á pelo seu reprodutor.

Configuração Avançada via CDN (sem descarregar ficheiros)

Para testes rápidos, pode usar um CDN:

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

Inicialização Manual para Conteúdo Carregado Dinamicamente:

Se os ficheiros SWF são adicionados à página dinamicamente (via JavaScript), pode inicializar manualmente o reprodutor:

const ruffle = window.RufflePlayer.newest();
const player = ruffle.createPlayer();
player.style.width = "800px";
player.style.height = "600px";
player.load("caminho/para/seu/ficheiro.swf");
document.body.appendChild(player);

Verificando a Funcionalidade

Após instalar o Ruffle usando qualquer método, pode verificar o seu funcionamento:

  1. Versão desktop: Simplesmente abra qualquer ficheiro SWF.

  2. Extensão do navegador: Visite a coleção de jogos Flash do Internet Archive ou qualquer site com conteúdo Flash conhecido. Se o elemento Flash for exibido e reproduzido, o Ruffle está a funcionar corretamente.

  3. Diagnóstico: No seu navegador, pressione F12 para abrir as ferramentas de programador. Na consola, verá mensagens do Ruffle confirmando a sua ativação.

Resolução de Problemas Comuns

Problema Solução Possível
A extensão não ativa num site Certifique-se de que o site não está bloqueado nas definições da extensão. Verifique se o modo de programador está ativado em chrome://extensions/.
O ficheiro SWF não reproduz ou mostra um ecrã branco A versão atual do Ruffle pode não suportar este ficheiro SWF específico. Verifique se o conteúdo é AVM2 (ActionScript 3), cujo suporte ainda está a ser refinado.
Não é possível abrir o ficheiro na versão desktop Certifique-se de que o ficheiro não está corrompido. Tente abri-lo a partir da linha de comando com a flag --verbose para obter registos de erro detalhados.
A extensão desapareceu após reiniciar o Firefox Este é um comportamento normal para extensões temporárias. Use a versão desktop ou aguarde a publicação oficial na loja de add-ons.
Baixo desempenho no navegador Tente mudar o backend de renderização nas definições da extensão. Para navegadores Chromium, verifique também se a aceleração por hardware está ativada nas definições do navegador.