📄️ 入门指南
⚠️ 注意:某些 Rive 功能可能尚未被特定运行时支持,或者需要使用 Rive 渲染器。详情请参考功能支持和选择渲染器页面。
📄️ 动画播放
⚠️ 弃用通知: 本页文档记录了旧的动画播放系统。对于新项目:请改用状态机。对于现有项目:计划尽快从直接动画控制迁移到状态机。此内容仅供旧版支持参考。
📄️ 画板
有关在 Rive 编辑器中创建画板的更多信息,请参考画板。
📄️ 状态机播放
有关在 Rive 编辑器中设计和构建状态机的更多信息,请参考状态机概述。
📄️ 数据绑定
在使用运行时数据绑定 API 之前,请先熟悉概述中介绍的核心概念。
📄️ 布局
适配模式
📄️ 缓存 Rive 文件
在大多数情况下,.riv 文件应该可以快速加载,手动管理 RiveFile 并非必要。但如果你打算在应用的多个部分中使用同一 .riv 文件,甚至在同一屏幕上使用,将文件加载一次并保留在内存中可能会更有优势。
📄️ 加载资源
如果你想动态替换图像,请使用图像数据绑定。
📄️ 播放音频
要了解如何向 Rive 文件添加音频的更多信息,请参见音频事件。
📄️ 字体
运行时替换字体
📄️ 输入
⚠️ 弃用通知: 本页文档记录了旧的输入系统。对于新项目:请改用数据绑定。对于现有项目:计划尽快从输入迁移到数据绑定。此内容仅供旧版支持参考。
📄️ Rive 事件
⚠️ 弃用通知: 本页文档记录了旧的事件系统。对于新项目:请改用数据绑定。对于现有项目:计划尽快从事件迁移到数据绑定。此内容仅供旧版支持参考。
📄️ 文本
⚠️ 已弃用:推荐使用数据绑定(Data Binding)替代直接操作文本运行。
📄️ Rive 参数
本页是高级 Rive 类的构造函数选项、类型和实例方法的参考文档,以及若干其他导出类。
📄️ Canvas vs WebGL2
选择运行时
📄️ 预加载 WASM
渲染 Rive 实例时,你的浏览器会发出网络请求到 https://unpkg.com/@rive-app/[email protected]/rive.wasm,该请求会获取一个 Web Assembly (WASM) 文件,其中包含用于构建渲染循环的 Rive 特定 API。unkpg 是一个全球 CDN,可以快速加载 NPM 包,在此情况下包括 WASM 文件。这使得在引入 Rive 基于 JS 的运行时时包体积更小,而只有在创建 Rive 实例时才加载 WASM。
📄️ 低级 API 用法
背景
📄️ 迁移指南
从 @rive-app/webgl 迁移到 @rive-app/webgl2
📄️ 常见问题
关注点