跳到主要内容
中文系列课

Unreal Engine

Rive 的 Unreal 运行时允许你在 Unreal Engine 中原生渲染和控制 Rive 动画。它直接集成到 Unreal 的对象系统和渲染管线中，并专为实时使用场景而设计。

支持的 Unreal 版本​

  • Unreal Engine 5.7.3 及以上版本

支持的平台​

  • Microsoft DirectX 11
  • Microsoft DirectX 12
  • PC Vulkan
  • macOS
  • visionOS（实验性）
  • PlayStation 5
  • Nintendo Switch
  • Nintendo Switch 2
  • Xbox Series X
  • Steam Deck - Proton D3D11
⚠️

移动平台支持已在计划中，但目前尚不可用。

渲染后端​

根据平台和引擎配置，支持的后端包括：

  • DirectX（Windows）
  • Metal（macOS）

Unreal 运行时使用 RHI 进行渲染后端集成。

渲染由 Rive 的原生渲染器处理，并与 Unreal 的渲染线程协调执行。

功能支持​

功能支持情况
动画播放✅
State machines✅
ViewModels（数据绑定）✅
属性观察✅
文本渲染✅
图像资源✅
每个文件多个 Artboards✅
脚本✅
旧版状态机事件已弃用
旧版直接输入已弃用
⚠️

旧版状态机事件和输入已弃用。
新集成应使用 ViewModels 进行输入和输出。

架构概览​

Unreal 运行时围绕三个核心运行时对象构建：

  • Rive File — 包含已导入 Rive 数据的 Unreal 资源
  • Artboard — 负责求值和渲染的运行时实例
  • ViewModel — Unreal 与 Rive 逻辑之间的类型化数据边界

典型的数据流如下：

Unreal → ViewModel → State Machine → ViewModel → Unreal

状态机会消费并修改 ViewModel 属性。Unreal 会观察这些更改。

支持与社区​

如果你需要帮助：