跳到主要内容

基础（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 直接选

相关编辑器概念：

State Machines​

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

相关：

渲染（Rendering）​

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

组件模式（推荐）​

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

低层 API（遗留/高级）​

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

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