.riv फ़ाइल को ऑनलाइन प्रीव्यू कैसे करें और उसकी state machines कैसे टेस्ट करें
Por equipe Charmotion · Atualizado em · Como escrevemos os guias

Para visualizar um arquivo .riv online, solte-o em um visualizador baseado no runtime web do Rive, como o nosso Rive File Inspector gratuito, ou abra o arquivo-fonte no editor do Rive e aperte play acima do grafo da state machine. A antiga página de arrastar e soltar do Rive em rive.app/preview não carrega mais, e os links de embed compartilháveis exigem um plano Voyager ou Enterprise.
Principais pontos
- A antiga página de arrastar e soltar rive.app/preview do Rive retornou um 404 quando verificamos em novembro de 2026.
- No editor do Rive, o botão play acima do grafo executa uma state machine para você testá-la, mas você precisa do arquivo-fonte e de uma conta.
- As URLs de embed compartilham com uma equipe um instantâneo de um artboard e de uma state machine; elas exigem um plano Voyager ou Enterprise.
- Os inspetores no navegador leem um .riv localmente e permitem disparar triggers, alternar booleanos e definir propriedades de view model.
- A maioria das visualizações em branco vem de um nome de state machine ausente, artboard errado, dimensionamento do canvas, CORS ou assets que o arquivo espera que você forneça.
O Rive tem uma ferramenta oficial de visualização de .riv?
Não mais uma independente. Anos atrás, um criador do Rive disse aos usuários do Product Hunt para "arrastar e soltar seu arquivo .riv ... em nossa ferramenta de visualização" em rive.app/preview. Esse endereço retornou um 404 quando verificamos em novembro de 2026. O que o Rive oferece hoje (em novembro de 2026):
| Opção | O que você precisa | Dá para testar a state machine? | Ideal para |
|---|---|---|---|
| Editor do Rive, botão play acima do grafo | O arquivo editável e uma conta Rive | Sim, de forma interativa | O designer, durante a criação |
| Página de arquivo do Marketplace, "Preview in Rive" | Um arquivo que alguém publicou no Marketplace | Abre no Rive | Experimentar arquivos da comunidade |
| URL de embed (link hospedado, link de embed ou código de iframe) | Plano Voyager ou Enterprise | Reproduz o único artboard e a state machine escolhidos quando o link foi criado | Compartilhar um instantâneo com uma equipe ou cliente |
| Janela de visualização da CLI do Rive | Um projeto que o seu agente de código cria a partir do Rive Markup Language | Mostra o projeto conforme ele é construído | Fluxos de trabalho com agentes, não para abrir um .riv existente |
Dois limites importam para uma "visualização de Rive para a equipe". A documentação do Rive diz que uma URL de embed "é um instantâneo do seu arquivo no momento em que é gerada", então edições posteriores exigem um novo link, e que os embeds "usam iframes e não dão acesso às APIs de runtime do Rive". Quem visualiza não pode trocar de artboard nem controlar valores por código. Se um desenvolvedor tem apenas o .riv exportado e nenhum acesso ao editor, um visualizador baseado em runtime é a escolha prática.
Como visualizo um arquivo .riv no navegador de graça?
Use um visualizador que carregue o arquivo com o runtime web de código aberto do Rive. O nosso Rive File Inspector gratuito faz isso inteiramente no seu navegador: o arquivo nunca é enviado. Solte um .riv (até 25 MB) e ele:
- Lista o conteúdo: cada artboard com suas timelines e state machines, os inputs de cada state machine com o tipo (number, boolean, trigger), cada view model com suas propriedades, tipos e instâncias, e os enums do arquivo.
- Reproduz ao vivo: escolha um artboard e depois uma state machine ou uma única timeline, e ela é reproduzida em um canvas de visualização.
- Oferece controles: inputs do tipo trigger viram botões, booleanos viram caixas de seleção e números viram campos. Se o arquivo tem um view model, a instância padrão é vinculada e suas propriedades number, boolean, trigger e string também ganham controles.
- Faz uma verificação de integração: informa se o arquivo tem uma state machine, se tem view models de Data Binding, quantos inputs legados ele usa, e sinaliza arquivos acima de 512 KB, que normalmente embutem imagens raster.
- Exporta um relatório: "Copy report as JSON" entrega a um desenvolvedor os nomes exatos de artboard, state machine e propriedades.
Os limites, para você não ter surpresas: a visualização usa o runtime de canvas leve do Rive, então não desenha Rive Text nem reproduz áudio (o relatório ainda lista o conteúdo desses arquivos), não busca Hosted assets da CDN do Rive e rejeita backups .rev porque eles não têm a assinatura RIVE com que um arquivo de runtime começa.
Existem outros visualizadores gratuitos. O Rive Playground é de código aberto, com controles ao vivo de boolean, number e trigger, edição de view model e um log de eventos. O Preview Rive (rive.rip) permite arrastar um arquivo, alternar entre animações e state machines e mudar o ajuste, o alinhamento e o fundo. A lista awesome-rive do Rive tem mais links.
Aviso: o Charmotion é nosso produto. Nós o listamos onde ele se encaixa e dizemos onde outras ferramentas são melhores; todos os outros fatos têm link para a fonte.
Os dois arquivos de exemplo do inspetor, Kiko e Gummo, são resultados reais do Charmotion: um .riv de personagem gerado a partir de uma imagem. Se você precisa de um arquivo assim para o seu próprio personagem, veja PNG para Rive.
Como testo inputs, triggers e view models de uma state machine?
Uma state machine conecta timelines com lógica. Cada artboard pode ter várias state machines, e uma camada "reproduz um estado de cada vez", então um personagem costuma ter uma camada de corpo e uma de piscar lado a lado. O runtime escolhe qual state machine executar; seu código, ou um visualizador, altera então os valores que as transições monitoram. Mais contexto em State machines do Rive explicadas.
Há dois tipos de valores para testar:
- Inputs de state machine (arquivos mais antigos): number, boolean e trigger. A documentação web do Rive agora marca os inputs como obsoletos, mas o guia de migração diz "Você não precisa atualizar arquivos existentes. Inputs e eventos continuarão funcionando."
- Propriedades de view model (Data Binding, recomendado para trabalhos novos): números, booleanos, triggers, strings, enums, cores, listas, imagens e mais. Com
autoBind: true, o runtime vincula a instância padrão do view model.
Uma rodada rápida de testes:
- Anote qual estado é reproduzido ao carregar. É isso que os usuários veem antes de qualquer código rodar.
- Dispare cada trigger e confirme que uma reação é reproduzida e volta para onde deveria.
- Ligue e desligue cada boolean e percorra cada number pelos valores que o designer previu (por exemplo 0, 1, 2, 3 para um humor).
- Defina valores que não deveriam fazer nada, como um número fora do intervalo, e confira se o arquivo continua em um estado sensato.
- Repita para cada artboard e state machine que o seu app vai carregar.
Como visualizo um .riv na minha própria página web?
Um arquivo HTML simples basta, e esse também é o jeito mais simples de compartilhar uma visualização com uma equipe: hospede uma página e envie o link. Sirva-a a partir de um servidor local em vez de abri-la direto do disco, para que o navegador consiga buscar o .riv.
<canvas id="c" width="500" height="500"></canvas>
<script src="https://unpkg.com/@rive-app/canvas"></script>
<script>
const r = new rive.Rive({
src: "character.riv",
canvas: document.getElementById("c"),
stateMachine: "State Machine 1", // the exact name from the file
autoplay: true,
autoBind: true,
onLoad: () => r.resizeDrawingSurfaceToCanvas(),
});
</script>
- Informe o nome da state machine. Segundo a documentação do Rive, sem
stateMachineo runtime web "atualmente reproduzirá a primeira animação linear que encontrar no artboard", então nada reage a inputs.stateMachine(singular) chegou na v2.41.0 e substitui ostateMachines, que está obsoleto. - Artboard: adicione
artboard: "Name"para escolher um; caso contrário, o artboard padrão do arquivo é reproduzido. - Pacote: o Rive recomenda o
@rive-app/webgl2, que oferece suporte a todos os recursos do editor. O@rive-app/canvasnão tem alguns recursos de renderização, como Layer Masks, e o@rive-app/canvas-liteé menor e serve para arquivos sem Rive Text, áudio, layouts ou scripting.
Para React e Next.js, veja Rive em React e Next.js.
Por que o meu arquivo .riv aparece em branco ou não anima?
Siga esta lista de cima para baixo; o inspetor responde aos dois primeiros itens em segundos porque mostra os nomes reais dentro do arquivo.
- Nenhuma state machine informada, ou nome errado. O runtime recorre à primeira timeline, que pode ser uma pose parada. O FAQ do Rive: confirme que você especificou a propriedade
stateMachinee definiuautoplay: true. - Artboard errado. Se você omitir
artboard, o padrão é reproduzido, e ele pode ser um artboard vazio ou de teste. - Tamanho do canvas. Sem os atributos width e height, o desenho fica minúsculo ou borrado. Chame
resizeDrawingSurfaceToCanvas()ao carregar e mantenha os atributos pelo menos tão grandes quanto o tamanho em CSS. - CORS. Um .riv em uma CDN ou no S3 precisa de cabeçalhos CORS, ou o navegador bloqueia a requisição.
- Content Security Policy. Uma CSP rígida pode impedir o carregamento do WebAssembly; o Rive aponta para a configuração
wasm-unsafe-eval. - Assets ausentes. Imagens e fontes marcadas como Referenced não estão dentro do .riv, então o seu app precisa carregá-las com um asset loader; os Hosted assets vêm da CDN do Rive.
- Pacote ou versão do runtime. As versões canvas e lite deixam alguns recursos de fora. O Rive diz que um arquivo mais novo ainda carrega em um runtime mais antigo, mas um recurso adicionado depois "pode ser ignorado", então atualize o runtime.
- É um .rev, não um .riv. Um .rev é um backup do editor. Exporte pelo editor com Export, For Runtime (ou Publish, To .riv).
Não está em branco, mas pode surpreender: no plano Free do Rive, os arquivos exportados exibem uma splash screen do Rive; os planos pagos exportam sem ela.
Visualize um arquivo .riv e teste suas state machines
- Confirme que você tem um .riv. Arquivos de runtime terminam em .riv. Um .rev é um backup do editor e precisa ser importado no editor do Rive e exportado como For Runtime antes.
- Abra em um visualizador no navegador. Solte o arquivo em um visualizador baseado em runtime, como o Rive File Inspector. Ele é lido localmente e não é enviado.
- Leia os nomes. Anote os artboards, state machines, inputs e propriedades de view model. Essas são as strings exatas de que o seu código vai precisar.
- Escolha o artboard e a state machine. Escolha o par que o seu app vai carregar e observe qual estado é reproduzido primeiro.
- Controle todos os valores. Dispare cada trigger, alterne cada boolean, percorra cada number e edite as propriedades de view model, conferindo se cada reação volta ao idle.
- Reproduza na sua página. Carregue o arquivo com o runtime web, defina os mesmos nomes de artboard e stateMachine e chame resizeDrawingSurfaceToCanvas ao carregar.
Perguntas frequentes
Posso visualizar um arquivo .riv sem uma conta Rive?
Sim. Visualizadores baseados em runtime, como o Rive File Inspector, o Rive Playground ou uma pequena página HTML com o runtime web, reproduzem um .riv sem conta. O editor do Rive exige uma conta, e os links de embed exigem um plano Voyager ou Enterprise.
O que é um arquivo .riv?
É a exportação de runtime de um arquivo Rive. O Rive a chama de versão pronta para produção: artboards, animações, state machines, data binding e scripts rodam exatamente como foram criados, e o mesmo .riv funciona nos runtimes web, mobile e de engines de jogos do Rive. Ele não pode ser editado como o arquivo-fonte.
Como compartilho uma visualização do Rive com a minha equipe?
No Voyager ou no Enterprise, gere uma URL de embed e envie o link hospedado, lembrando que é um instantâneo. Em qualquer plano, envie o .riv e deixe os colegas abri-lo em um visualizador no navegador, ou hospede uma página HTML de visualização.
Por que os meus inputs mostram um aviso de obsolescência?
O Rive agora recomenda view models de Data Binding em vez de inputs de state machine. Os arquivos existentes com inputs continuam funcionando na web, mas os novos arquivos devem expor propriedades de view model, que o inspetor também lista e permite editar.
Respostas rápidas deste guia
Fontes
- State Machine Overview, Rive
- Embed URLs, Rive
- Exporting for Runtime, Rive
- Web (JS) runtime, Rive
- Rive Parameters, Rive
- Web runtime: State Machine Playback, Rive
- Web runtime: Inputs (deprecated), Rive
- Web runtime: Data Binding, Rive
- Data Binding Migration Guide, Rive
- Web runtime FAQ, Rive
- Feature Support, Rive
- Web runtime: Loading Assets, Rive
- Rive, Rive
- Rive on Product Hunt (maker comment on the preview tool), Product Hunt
- Snake Game (Marketplace file by TeamRive), Rive Marketplace
- Rive Playground, nano-step (GitHub)
- Preview Rive, rive.rip
- awesome-rive, Rive (GitHub)