Rive Web Runtime 技能用于在网页上嵌入并控制 Rive 动画,使用 JavaScript/TypeScript 调用 @rive-app/canvas 或 @rive-app/webgl 包。
安装: npm install @rive-app/canvas(Canvas 渲染器,体积更小,适合多数场景) npm install @rive-app/webgl(WebGL 渲染器,适合复杂动画)
基本用法(Quick Start):通过 new Rive({ src, canvas, autoplay, onLoad }) 创建实例,src 指定 .riv 文件路径或 URL,canvas 传入 canvas 元素,autoplay 控制自动播放,onLoad 在加载完成后回调。
关键概念:Rive 实例是动画主控制器;状态机是在 Rive 编辑器中构建的交互逻辑;输入是控制状态机的变量(布尔、数值、触发器);事件是状态机发出的信号;画板是动画内容的容器。
常用模式:加载动画时可指定 stateMachines(编辑器中的名称)、onLoad、onStateChange 回调。控制输入时用 rive.stateMachineInputs('State Machine') 获取输入,按名称查找后设置 value 或调用 fire() 触发触发器。监听事件使用 rive.on('riveevent', ...),可通过 event.data.name 和 event.data.properties 读取事件信息。使用完毕后应调用 rive.cleanup() 清理资源。
适用场景:需要在网页中呈现可交互 Rive 动画的前端项目,包括状态切换、进度控制、点击触发等。
限制:资料仅覆盖以上安装、加载、状态机输入与事件处理、清理等能力;涉及性能优化、框架封装、收费与授权、浏览器兼容细节、错误处理等暂未提供。