基础（Fundamentals）

添加 Rive 资源

把 .riv 文件拖进 Unity Project 窗口后，会自动生成 Rive Asset。

随后可通过：

• Rive Panel
• Rive Widget

完成显示。

File

Rive.File 包含：

• Artboards
• State Machines
• Animations

使用组件工作流时，Rive Widget 会自动从 Asset 加载底层 File。仅在你要手动管理生命周期或从外部源加载（如 CDN）时，才需要直接用 Rive.File。

载入方式

1. 从 Rive.Asset
2. 从 TextAsset
3. 从 byte[]

若文件已在内存，运行时可返回缓存版本减少重复加载。

Artboards

• 可按索引或名称获取
• 组件模式下可在 Inspector 直接选

相关编辑器概念：

• /docs/editor/fundamentals/artboards

State Machines

• 从 Artboard 获取 default / by index / by name
• 在 legacy 低层流程中，通常需要每帧 Advance(Time.deltaTime) 推进

相关：

• /docs/game-runtimes/unity/state-machines

渲染（Rendering）

Unity 下 Rive 通常渲染到 RenderTexture，再通过 UI 或材质显示。

组件模式（推荐）

• Rive Panel 负责把 Widget 画到 Render Texture
• Rive Canvas Renderer 用于 uGUI
• Rive Texture Renderer 用于 Mesh

低层 API（遗留/高级）

可手动控制 Renderer.Align()、Draw()、CommandBuffer、输入坐标换算等。

如果你需要这条路径，建议直接参考官方示例工程实现。