Documentação Técnica – Leitura de Arquivos .RIV no Painel de Controle
🧪 Versão atual do painel: BETA
📌 Objetivo
Esta documentação explica o que o painel de controle da nossa plataforma consegue interpretar e controlar a partir dos arquivos .riv produzidos no Rive App.
✅ Funcionalidades atualmente compatíveis
Nosso painel já oferece suporte a diversos recursos essenciais para controle dinâmico e interativo de animações. A leitura é baseada em data bindings definidos no Rive App.
📥 Bindings suportados (inputs da State Machine)
Tipo
Suporte
Descrição
✅ Trigger
✅ Boolean
✅ Number
✅ Color
✅ String
✅ Enum
Total
Total
Total
Total
Total
Total
Dispara ações ou transições
Liga/desliga estados
Controla propriedades como posição
Permite alteração de cores em tempo real
Exibe textos dinâmicos
Alterna entre estados fixos
Esses tipos de input são exibidos no painel de controles interativos apropriados (botões, campos de texto, seletores, etc.), permitindo total integração em suas lives ou sistemas externos.
❌ Funcionalidades ainda não suportadas
(em desenvolvimento)
Estamos constantemente expandindo o suporte o nosso painel, Abaixo estão os itens que ainda não são compatíveis, mas que estão no nosso roadmap de implementação:
🔒 Data bindings ainda não lidos:
Tipo
Situação
Observações
⛔ Image
⛔ List
⛔ List Attributes
Não suportado
Não suportado
Não suportado
Não é possível alterar imagens via painel ainda
Não há suporte para listas de valores ou elementos
A leitura de atributos dentro de listas ainda não está disponível
⚙️ Funcionalidades estruturais não lidas:
Item
Situação
Observações
⛔ Múltiplas State Machines
⛔ Eventos (Events)
⛔ Pointer Interactions
⛔ Artboards
⛔ Controle de Timeline fora da State Machine
⛔ Bindings condicionais ou lógicos
⛔ Integração com dados externos em tempo real
Não suportado
Não suportado
Não suportado
Não suportado
Não suportado
Não suportado
Não suportado
Apenas a primeira máquina de estado é lida atualmente
Eventos customizados definidos no Rive não são disparados
Interações como clique ou arrastar ainda não são reconhecidas
O painel reconhece apenas o artboard principal
Não há controle direto da timeline se não estiver ligada a uma máquina de estado
Lógicas internas ainda não são interpretadas
Futuramente será possível integrar com dados como placares, chats, APIs, etc.
📁 Requisitos para o arquivo .RIV
Para garantir a compatibilidade e o funcionamento adequado do seu arquivo .RIV, siga estas diretrizes:
- Utilize apenas uma máquina de estado por arquivo (por enquanto).
- Nomeie os inputs de forma clara e objetiva (ex:
showScore,bgColor,teamName). - Evite listas e imagens com bindings, até que o suporte seja implementado.
- Otimize o tamanho do arquivo .riv, evitando sobrecarga no carregamento em tempo real.
💡 Boas práticas e recomendações
Siga estas boas práticas para garantir a melhor experiência possível ao trabalhar com arquivos .RIV:
- Teste seu arquivo
.rivdiretamente no Rive App antes de subir na plataforma. - Use apenas os tipos de bindings atualmente suportados para garantir total funcionalidade.
- Em caso de falhas, envie o arquivo para nossa equipe técnica revisar.
- Acompanhe nossas atualizações – novas funções estão sendo liberadas constantemente.