Ir al contenido
Tiempo limitadoStarter ahora cuesta 9 US$ al mes en lugar de 20 US$.Ver planes
charmotion

Cómo previsualizar un archivo .riv en línea y probar sus máquinas de estados

Por el equipo de Charmotion · Actualizado el · Cómo escribimos las guías

Ilustración de portada de la guía: Cómo previsualizar un archivo .riv en línea y probar sus máquinas de estados, con personajes de demostración de Charmotion

Para previsualizar un archivo .riv en línea, suéltalo en un visor basado en el runtime web de Rive, como nuestro Rive File Inspector gratuito, o abre el archivo fuente en el editor de Rive y presiona play sobre el grafo de la máquina de estados. La antigua página de arrastrar y soltar de Rive en rive.app/preview ya no carga, y sus enlaces de embed compartibles requieren un plan Voyager o Enterprise.

Puntos clave

  • La antigua página de arrastrar y soltar de Rive en rive.app/preview devolvía un 404 cuando la revisamos en noviembre de 2026.
  • En el editor de Rive, el botón de play sobre el grafo ejecuta una máquina de estados para que la pruebes, pero necesitas el archivo fuente y una cuenta.
  • Las URL de embed comparten con un equipo una instantánea de un artboard y una máquina de estados; requieren un plan Voyager o Enterprise.
  • Los inspectores en el navegador leen un .riv de forma local y te permiten disparar triggers, cambiar booleanos y definir propiedades de view models.
  • La mayoría de las vistas previas en blanco se deben a un nombre de máquina de estados faltante, un artboard incorrecto, el tamaño del canvas, CORS o assets que el archivo espera que tú proporciones.

¿Rive tiene una herramienta oficial para previsualizar .riv?

Ya no como herramienta independiente. Hace años, alguien de Rive les dijo a los usuarios de Product Hunt que "drag and drop your .riv file ... into our preview tool" en rive.app/preview. Esa dirección devolvía un 404 cuando la revisamos en noviembre de 2026. Esto es lo que ofrece Rive ahora (a noviembre de 2026):

OpciónQué necesitas¿Puedes probar la máquina de estados?Ideal para
Editor de Rive, botón de play sobre el grafoEl archivo editable y una cuenta de RiveSí, de forma interactivaEl diseñador, mientras construye
Página de archivo del Marketplace, "Preview in Rive"Un archivo que alguien publicó en el MarketplaceLo abre en RiveProbar archivos de la comunidad
URL de embed (enlace alojado, enlace de embed o código iframe)Plan Voyager o EnterpriseReproduce el único artboard y la máquina de estados elegidos al crear el enlaceCompartir una instantánea con un equipo o cliente
Ventana de vista previa de la CLI de RiveUn proyecto que tu agente de código construye a partir de Rive Markup LanguageMuestra el proyecto a medida que se construyeFlujos con agentes, no para abrir un .riv existente

Dos límites importan para una "vista previa de Rive para el equipo". Los docs de Rive dicen que una URL de embed "is a snapshot of your file at the moment it's generated", por lo que las ediciones posteriores requieren un enlace nuevo, y que los embeds "use iframes and don't provide access to Rive's runtime APIs." Quienes lo ven no pueden cambiar de artboard ni manejar valores desde código. Si un desarrollador solo tiene el .riv exportado y no tiene acceso al editor, un visor basado en el runtime es la opción práctica.

¿Cómo previsualizo un archivo .riv gratis en el navegador?

Usa un visor que cargue el archivo con el runtime web de código abierto de Rive. Nuestro Rive File Inspector gratuito lo hace por completo en tu navegador: el archivo nunca se sube. Suelta un .riv (hasta 25 MB) y:

  • Lista el contenido: cada artboard con sus timelines y máquinas de estados, los inputs de cada máquina de estados con su tipo (number, boolean, trigger), cada view model con sus propiedades, tipos e instancias, y los enums del archivo.
  • Lo reproduce en vivo: eliges un artboard, luego una máquina de estados o un solo timeline, y se reproduce en un canvas de vista previa.
  • Te da controles: los inputs de tipo trigger se convierten en botones, los booleanos en casillas y los números en campos. Si el archivo tiene un view model, se enlaza la instancia por defecto y sus propiedades number, boolean, trigger y string también tienen controles.
  • Ejecuta una revisión de integración: indica si el archivo tiene una máquina de estados, si tiene view models de Data Binding, cuántos inputs legacy usa, y marca los archivos de más de 512 KB, que normalmente incluyen imágenes raster.
  • Exporta un reporte: "Copy report as JSON" le da a un desarrollador los nombres exactos de artboards, máquinas de estados y propiedades.

Límites, para que no te sorprendas: la vista previa usa el runtime de canvas ligero de Rive, por lo que no dibuja Rive Text ni reproduce audio (el reporte igualmente lista el contenido de esos archivos), no descarga los Hosted assets desde el CDN de Rive y rechaza los respaldos .rev porque les falta la firma RIVE con la que empieza un archivo de runtime.

Existen otros visores gratuitos. Rive Playground es de código abierto, con controles en vivo de boolean, number y trigger, edición de view models y un registro de eventos. Preview Rive (rive.rip) te deja arrastrar un archivo, cambiar entre animaciones y máquinas de estados, y ajustar el encaje, la alineación y el fondo. La lista awesome-rive de Rive enlaza más.

Aviso: Charmotion es nuestro producto. Lo incluimos donde encaja y decimos dónde otras herramientas son mejores; todos los demás datos enlazan a su fuente.

Los dos archivos de ejemplo del inspector, Kiko y Gummo, son resultados reales de Charmotion: un .riv de personaje generado a partir de una imagen. Si necesitas un archivo así para tu propio personaje, mira PNG a Rive.

¿Cómo pruebo los inputs, triggers y view models de una máquina de estados?

Una máquina de estados conecta timelines con lógica. Cada artboard puede contener varias máquinas de estados, y una capa "plays one state at a time", así que un personaje suele ejecutar una capa de cuerpo y una capa de parpadeo en paralelo. El runtime elige qué máquina de estados ejecutar; luego tu código, o un visor, cambia los valores que escuchan las transiciones. Hay más contexto en Máquinas de estados de Rive explicadas.

Hay dos tipos de valores que probar:

  • Inputs de la máquina de estados (archivos antiguos): number, boolean y trigger. Los docs web de Rive ahora marcan los inputs como obsoletos, pero su guía de migración dice "You do not need to update existing files. Inputs and events will continue to work."
  • Propiedades de view model (Data Binding, recomendado para trabajo nuevo): números, booleanos, triggers, strings, enums, colores, listas, imágenes y más. Con autoBind: true, el runtime enlaza la instancia de view model por defecto.

Una pasada rápida de pruebas:

  1. Anota qué estado se reproduce al cargar. Eso es lo que ven los usuarios antes de que se ejecute cualquier código.
  2. Dispara cada trigger y confirma que se reproduce una reacción y que vuelve a donde debe.
  3. Activa y desactiva cada booleano, y recorre cada número por los valores que el diseñador previó (por ejemplo 0, 1, 2, 3 para un mood).
  4. Define valores que no deberían hacer nada, como un número fuera de rango, y comprueba que el archivo se mantenga en un estado razonable.
  5. Repite el proceso para cada artboard y máquina de estados que tu app vaya a cargar.

¿Cómo previsualizo un .riv en mi propia página web?

Basta con un archivo HTML simple, que además es la forma más sencilla de compartir una vista previa con un equipo: aloja una página y envía el enlace. Sírvelo desde un servidor local en lugar de abrirlo desde el disco, para que el navegador pueda obtener el .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>
  • Indica la máquina de estados. Según los docs de Rive, sin stateMachine el runtime web "will currently play the first linear animation it finds on the artboard", así que nada reacciona a los inputs. stateMachine (singular) llegó en la v2.41.0 y reemplaza a stateMachines, que quedó obsoleto.
  • Artboard: agrega artboard: "Name" para elegir uno; de lo contrario se reproduce el artboard por defecto del archivo.
  • Paquete: Rive recomienda @rive-app/webgl2, que admite todas las funciones del editor. @rive-app/canvas carece de algunas funciones de renderizado como las Layer Masks, y @rive-app/canvas-lite es más pequeño y sirve para archivos sin Rive Text, audio, layouts ni scripting.

Para React y Next.js, mira Rive en React y Next.js.

¿Por qué mi archivo .riv se ve en blanco o no se anima?

Revisa esta lista de arriba abajo; el inspector responde los dos primeros puntos en segundos porque muestra los nombres reales dentro del archivo.

  • No indicaste una máquina de estados, o el nombre es incorrecto. El runtime recurre al primer timeline, que puede ser una pose estática. Las preguntas frecuentes de Rive: asegúrate de haber especificado la propiedad stateMachine y de haber definido autoplay: true.
  • Artboard incorrecto. Si omites artboard, se reproduce el artboard por defecto, que puede ser uno vacío o de prueba.
  • Tamaño del canvas. Sin los atributos width y height, el dibujo se ve diminuto o borroso. Llama a resizeDrawingSurfaceToCanvas() al cargar y mantén los atributos al menos tan grandes como el tamaño en CSS.
  • CORS. Un .riv en un CDN o en S3 necesita encabezados CORS, o el navegador bloquea la descarga.
  • Content Security Policy. Una CSP estricta puede impedir que se cargue WebAssembly; Rive remite a la configuración wasm-unsafe-eval.
  • Assets faltantes. Las imágenes y fuentes marcadas como Referenced no están dentro del .riv, así que tu app debe cargarlas con un asset loader; los Hosted assets vienen del CDN de Rive.
  • Paquete o versión del runtime. Las versiones canvas y lite omiten algunas funciones. Rive dice que un archivo más nuevo todavía carga en un runtime más antiguo, pero una función agregada después "may be skipped", así que actualiza el runtime.
  • Es un .rev, no un .riv. Un .rev es un respaldo del editor. Exporta desde el editor con Export, For Runtime (o Publish, To .riv).

No está en blanco, pero puede sorprender: en el plan Free de Rive, los archivos exportados reproducen una splash screen de Rive; los planes de pago exportan sin ella.

Previsualiza un archivo .riv y prueba sus máquinas de estados

  1. Comprueba que tienes un .riv. Los archivos de runtime terminan en .riv. Un .rev es un respaldo del editor y primero debe importarse al editor de Rive y exportarse con For Runtime.
  2. Ábrelo en un visor del navegador. Suelta el archivo en un visor basado en el runtime, como el Rive File Inspector. Se lee de forma local y no se sube.
  3. Lee los nombres. Anota los artboards, máquinas de estados, inputs y propiedades de view model. Son las cadenas exactas que necesitará tu código.
  4. Elige el artboard y la máquina de estados. Elige el par que cargará tu app y observa qué estado se reproduce primero.
  5. Maneja cada valor. Dispara cada trigger, cambia cada booleano, recorre cada número y edita las propiedades del view model, comprobando que cada reacción vuelva a idle.
  6. Reprodúcelo en tu página. Carga el archivo con el runtime web, define los mismos nombres de artboard y stateMachine, y llama a resizeDrawingSurfaceToCanvas al cargar.

Preguntas frecuentes

¿Puedo previsualizar un archivo .riv sin una cuenta de Rive?

Sí. Los visores basados en el runtime, como el Rive File Inspector, Rive Playground o una pequeña página HTML con el runtime web, reproducen un .riv sin cuenta. El editor de Rive necesita una cuenta, y los enlaces de embed requieren un plan Voyager o Enterprise.

¿Qué es un archivo .riv?

Es la exportación de runtime de un archivo de Rive. Rive la llama la versión lista para producción: artboards, animaciones, máquinas de estados, data binding y scripts se ejecutan exactamente como se construyeron, y el mismo .riv funciona en los runtimes web, móviles y de motores de juego de Rive. No se puede editar como el archivo fuente.

¿Cómo comparto una vista previa de Rive con mi equipo?

En Voyager o Enterprise, genera una URL de embed y envía el enlace alojado, recordando que es una instantánea. En cualquier plan, envía el .riv y deja que tus compañeros lo abran en un visor del navegador, o aloja una vista previa en una página HTML simple.

¿Por qué mis inputs muestran una advertencia de obsolescencia?

Rive ahora recomienda los view models de Data Binding en lugar de los inputs de máquinas de estados. Los archivos existentes con inputs siguen funcionando en la web, pero los archivos nuevos deberían exponer propiedades de view model, que el inspector también lista y te permite editar.

Respuestas rápidas de esta guía

Fuentes

Guías relacionadas