虚幻引擎(Unreal Engine)
Rive Unreal Runtime 让你在 Unreal Engine 内原生渲染并控制 Rive 动画,适用于实时场景。
支持版本
- Unreal Engine 5.7.3 及以上
支持平台
- Windows
- macOS
警告:移动平台支持已规划,但暂未提供。
渲染后端
根据平台与引擎配置,当前主要为:
- DirectX(Windows)
- Metal(macOS)
Runtime 通过 Unreal 的 RHI 与 Rive Native Renderer 协同。
特性支持
| 特性 | 状态 |
|---|---|
| Animation Playback | ✅ |
| State Machines | ✅ |
| ViewModels(Data Binding) | ✅ |
| Property Observation | ✅ |
| Text Rendering | ✅ |
| Image Assets | ✅ |
| Multiple Artboards | ✅ |
| Scripting | ✅ |
| Legacy State Machine Events | Deprecated |
| Legacy Direct Inputs | Deprecated |
提示:新集成请统一走 ViewModel(输入与输出都通过 ViewModel)。
架构概览
核心对象:
- Rive File(导入后的 Unreal 资产)
- Artboard(运行时实例)
- ViewModel(Unreal 与 Rive 的类型化数据边界)
典型数据流:
Unreal → ViewModel → State Machine → ViewModel → Unreal