Converter SB3 para HTML

Um navegador, site ou quiosque offline pode exigir um projeto Scratch como um arquivo HTML reproduzível em vez de um download .sb3. Empacotar o projeto como HTML permite que os destinatários o executem sem abrir o editor Scratch, preservando o arquivo SB3 original para edição futura.

O que é o formato SB3

SB3 é o formato de projeto do Scratch usado pelo Scratch e por editores compatíveis, como o TurboWarp. Um arquivo SB3 é um arquivo ZIP contendo project.json, sprites, fantasias, sons, scripts e outros recursos do projeto.

O Scratch cria um arquivo SB3 por meio de File → Save to your computer. Projetos baixados do Scratch, transferidos entre computadores ou importados para um editor compatível normalmente usam esse formato. Renomear .sb3 para .html não converte o arquivo; um navegador não pode executar a estrutura de projeto do Scratch sem um runtime JavaScript.

O que é o formato HTML

HTML é o formato de documento interpretado por navegadores da Web. Para um projeto Scratch, o resultado útil é um aplicativo HTML empacotado que contenha ou carregue um runtime JavaScript compatível com Scratch e os recursos do projeto.

O resultado pode ser compartilhado como uma página da Web, incorporado a um site ou aberto para reprodução offline. Isso não é uma conversão dos blocos do Scratch em elementos HTML comuns, como parágrafos e títulos; a lógica dos blocos continua sendo dados interpretados pelo runtime.

Como converter SB3 em HTML

O TurboWarp Packager é a opção mais prática para produzir um arquivo HTML reproduzível em um navegador. A versão online está disponível em packager.turbowarp.org, e a versão para desktop é adequada quando o projeto não deve ser enviado para um serviço de terceiros.

1. Mantenha uma cópia intacta do arquivo .sb3 original.
2. Abra o TurboWarp Packager e selecione a opção para enviar ou escolher um projeto.
3. Selecione o arquivo SB3 no computador.
4. Revise as configurações disponíveis, incluindo o comportamento em tela cheia, os controles, o carregamento do player e se os dados do projeto serão incorporados. Os nomes das configurações variam conforme a versão.
5. Escolha a saída HTML e baixe o arquivo .html gerado.
6. Abra o arquivo em um navegador atual, como Chrome, Firefox, Edge ou Safari, e teste os scripts, sprites, sons, controles do teclado e quaisquer recursos de salvamento.

O packager online é conveniente quando o envio do projeto é aceitável. Use o packager para desktop em projetos privados, grandes ou confidenciais. Sites genéricos de conversão de arquivos geralmente não conseguem realizar essa conversão: eles podem apenas renomear o arquivo ou extrair seu conteúdo ZIP, sem adicionar o runtime necessário para executar os blocos do Scratch.

Limitações de qualidade e compatibilidade

O HTML gerado é um aplicativo empacotado, não um projeto Scratch editável. Mantenha o arquivo SB3 se os blocos, fantasias, sons ou a estrutura do projeto precisarem ser alterados posteriormente; reabra esse arquivo no Scratch ou no TurboWarp.

Teste o projeto empacotado, pois o comportamento pode ser diferente do site do Scratch. Extensões, variáveis de nuvem, serviços online, acesso ao microfone e à câmera, políticas de segurança do navegador e recursos específicos do dispositivo podem exigir acesso à rede, permissão do usuário ou suporte específico do TurboWarp. Variáveis de nuvem e outros recursos de servidor do Scratch podem não funcionar quando o arquivo HTML é aberto localmente.

Um arquivo HTML autocontido pode ser grande, pois inclui o runtime e os recursos do projeto. Se o packager oferecer recursos externos ou um pacote ZIP, use essa opção para distribuição somente quando todos os recursos gerados forem mantidos junto do arquivo HTML; alguns navegadores também restringem o acesso de arquivos locais a recursos externos. O JavaScript deve estar habilitado para que o projeto empacotado seja executado.