跳到主要内容
中文系列课

特性支持（Feature Support）

随着 Rive Editor 持续迭代，某些新特性需要 Runtime 更新才能完整支持，部分场景还会引入新 API 或 API 变更。
建议尽量使用最新 Runtime 版本，以获得更好的兼容性、稳定性与性能。

你可以用本页快速判断：你的 .riv 文件所用特性，是否被目标 Runtime 支持。

警告（Warning）：部分特性需要使用 Rive Renderer（渲染器）。

请先阅读：

当前明确依赖 Rive Renderer 的特性是：

  • Vector Feathering（矢量羽化）

当某项特性涉及 API 迁移时，官方通常会在对应 Runtime 文档中附带迁移说明。

按 Runtime 查看支持​

下方「版本支持矩阵」按 Runtime 分组列出各特性的最低版本：

  • Web：WebGL2（推荐）、Canvas、Canvas Lite
  • React：WebGL2（推荐）、Canvas、Canvas Lite
  • React Native（@rive-app/react-native，基于 Nitro）
  • Flutter、Apple、Android、C++、Unity、Unreal

已弃用的 Legacy Runtime 见文末 Legacy（旧版）。

按特性查看支持​

官方页面使用 ✅ / 🟡 标记：

  • ✅：在所有相关 Runtime 中均支持
  • 🟡：支持因 Runtime / 渲染器 / 平台能力而有差异

差异可能源于：

  • 平台或 SDK 限制，导致某特性无法支持
  • 特性在各 Runtime 间分批发布
  • 为减小包体而有意裁剪部分特性的轻量（Lite）版本

注意（Note）：某特性即使在 Legacy Runtime 中不支持，仍可能被视为完整支持。

主要特性清单​

Semantics（语义/无障碍）​

🟡 参考：/docs/editor/accessibility/semantics

官方已从特性清单中移除 Randomization、Follow Path、Interpolation on States、Joysticks、Solos、Speed on States、Graph Editor、Listeners、Mesh Deformation、Raster Assets 等早已全面支持的旧特性。

选型建议​

  1. Web / React 优先 WebGL2：新特性支持与性能通常更好。
  2. 仅在包体敏感时使用 Lite：先确认目标特性未被裁剪。
  3. 新项目避免 Legacy Runtime：减少迁移成本与潜在兼容风险。
  4. 遇到渲染差异先检查 Renderer 路径：尤其是 Vector Feathering。

相关文档​

版本支持矩阵（Runtime × Feature × 最低版本）​

数据来源：官方 snippets/feature-support.jsx。 说明：✅ x.y.z+ 表示支持且给出最低版本；NA 表示不适用；Coming soon / Not supported / Not yet supported / Deprecated 为官方原文状态。

阅读建议：按需展开分组与 Runtime，避免一次性查看超长表格。

Web（WebGL2 / Canvas / Canvas Lite）
  • WebGL2（@rive-app/webgl2）：大多数 Web 项目的推荐包。使用 Rive Renderer，支持所有 Rive Editor 特性，包括矢量羽化。
  • Canvas（@rive-app/canvas）：使用浏览器的 Canvas2D 渲染器，目前不支持矢量羽化。
  • Canvas Lite（@rive-app/canvas-lite）：API 与 @rive-app/canvas 相同，但裁剪了部分特性以减小包体。

取舍请参阅 Canvas vs WebGL2。

特性WebGL2CanvasCanvas Lite
游戏手柄（Gamepad）Coming soonComing soonComing soon
文本输入（Text Input）Coming soonComing soonNA
焦点（Focus）✅ 2.43.1+✅ 2.43.1+✅ 2.43.1+
有状态组件（Stateful Components）✅ 2.33.0+✅ 2.33.0+✅ 2.33.0+
GPU Canvas（GPU Canvas）✅ 2.42.0+NANA
全局视图模型（Global View Models）✅ 2.39.2+✅ 2.39.2+✅ 2.39.2+
数据绑定字体（Data Binding Fonts）✅ 2.39.2+✅ 2.39.2+NA
语义（Semantics）✅ 2.39.0+✅ 2.39.0+✅ 2.39.0+
脚本（Scripting）✅ 2.34.0+✅ 2.34.0+NA
数据绑定列表/图片/画板（Data Binding - Lists, Images, Artboards）✅ 2.30.3+✅ 2.30.3+✅ 2.30.3+
RTL 布局与文本（Right to Left Layouts & Text）✅ 2.26.7+✅ 2.26.7+NA
文本沿路径（Text Follow Path）✅ 2.26.7+✅ 2.26.7+NA
数据绑定（Data Binding）✅ 2.26.6+✅ 2.26.6+✅ 2.26.6+
矢量羽化（Vector Feathering）✅ 2.26.0+NANA
N-Slicing（N-Slicing）✅ 2.23.11+✅ 2.23.11+✅ 2.23.11+
布局（Layouts）✅ 2.23.3+✅ 2.23.3+NA
后备字体（Fallback Fonts）✅ 2.37.1+✅ 2.37.1+NA
音频（Audio）✅ 2.15.6+✅ 2.15.6+NA
带外资源（Out-of-band Assets）✅ 2.11.0+✅ 2.7.0+✅ 2.7.0+
文本（Text）✅ 2.11.0+✅ 2.1.3+NA
缓存 Rive 文件（Caching a Rive File）✅ 2.11.0+✅ Supported✅ Supported
事件（Events，已弃用）✅ 2.11.0+✅ 2.4.3+✅ 2.4.3+
嵌套文本（Nested Text，已弃用）✅ 2.11.0+✅ 2.21.0+NA
React（WebGL2 / Canvas / Canvas Lite）
  • WebGL2（@rive-app/react-webgl2）：大多数 React 项目的推荐包。使用 Rive Renderer，支持所有 Rive Editor 特性，包括矢量羽化。
  • Canvas（@rive-app/react-canvas）：使用浏览器的 Canvas2D 渲染器，目前不支持矢量羽化。
  • Canvas Lite（@rive-app/react-canvas-lite）：API 与 @rive-app/react-canvas 相同，但裁剪了部分特性以减小包体。

取舍请参阅 Canvas vs WebGL2。

特性WebGL2CanvasCanvas Lite
游戏手柄（Gamepad）Coming soonComing soonComing soon
文本输入（Text Input）Coming soonComing soonNA
焦点（Focus）✅ 4.35.0+✅ 4.35.0+✅ 4.35.0+
有状态组件（Stateful Components）✅ 4.25.0+✅ 4.25.0+✅ 4.25.0+
GPU Canvas（GPU Canvas）✅ 4.34.0+NANA
全局视图模型（Global View Models）✅ 4.31.0+✅ 4.31.0+✅ 4.31.0+
数据绑定字体（Data Binding Fonts）✅ 4.31.0+✅ 4.31.0+NA
语义（Semantics）✅ 4.30.0+✅ 4.30.0+✅ 4.30.0+
脚本（Scripting）✅ 4.26.0+✅ 4.26.0+NA
数据绑定列表/图片/画板（Data Binding - Lists, Images, Artboards）✅ 4.22.0+✅ 4.22.0+✅ 4.22.0+
RTL 布局与文本（Right to Left Layouts & Text）✅ 4.18.6+✅ 4.18.6+NA
文本沿路径（Text Follow Path）✅ 4.18.6+✅ 4.18.6+NA
数据绑定（Data Binding）✅ 4.20.0+✅ 4.20.0+✅ 4.20.0+
矢量羽化（Vector Feathering）✅ 4.18.0+NANA
N-Slicing（N-Slicing）✅ 4.16.7+✅ 4.16.7+✅ 4.16.7+
布局（Layouts）✅ 4.16.0+✅ 4.16.0+NA
后备字体（Fallback Fonts）✅ 4.28.0+✅ 4.28.0+NA
音频（Audio）✅ 4.9.5+✅ 4.9.5+NA
带外资源（Out-of-band Assets）✅ 4.5.0+✅ 4.5.0+✅ 4.5.0+
文本（Text）✅ 4.1.3+✅ 4.1.3+NA
缓存 Rive 文件（Caching a Rive File）✅ Supported✅ Supported✅ Supported
事件（Events，已弃用）✅ 4.3.3+✅ 4.3.3+✅ 4.3.3+
嵌套文本（Nested Text，已弃用）✅ 4.14.0+✅ 4.14.0+NA
React Native

版本号指 @rive-app/react-native 包（基于 Nitro 构建）。

GPU Canvas 在 iOS 与 Android 上自 0.5.3 起支持，默认关闭。请在加载任何 Rive 文件之前启用：

import { RiveRuntime } from '@rive-app/react-native';

RiveRuntime.setGPUCanvasEnabled(true);

该设置作用于应用内所有 Rive 文件；文件开始加载后再修改会被忽略。如果你覆盖了原生 SDK 版本，GPU Canvas 需要 Rive iOS 6.25.0 及以上、Rive Android 11.12.0 及以上。

语义（Semantics）在 iOS 上自 0.5.0 起支持。从 @rive-app/react-native 导入 Semantics，并在 RiveView 上设置 semantics={Semantics.Automatic}，即可在 VoiceOver 运行时启用无障碍。

注意（Note）：自 0.5.0 起，已弃用的事件与 text run 方法不再可用。请改用数据绑定监听 Trigger 并更新文本。

特性支持状态 / 最低版本
游戏手柄（Gamepad）Coming soon
文本输入（Text Input）Coming soon
焦点（Focus）Coming soon
有状态组件（Stateful Components）✅ 0.3.1+
GPU Canvas（GPU Canvas）✅ 0.5.3+
全局视图模型（Global View Models）Coming soon
数据绑定字体（Data Binding Fonts）Coming soon
语义（Semantics）✅ 0.5.0+ (仅 iOS)
脚本（Scripting）✅ 0.1.5+
数据绑定列表/图片/画板（Data Binding - Lists, Images, Artboards）✅ 0.1.4+
RTL 布局与文本（Right to Left Layouts & Text）✅ 0.1.4+
文本沿路径（Text Follow Path）✅ 0.1.4+
数据绑定（Data Binding）✅ 0.1.4+
矢量羽化（Vector Feathering）✅ 0.1.4+
N-Slicing（N-Slicing）✅ 0.1.4+
布局（Layouts）✅ 0.1.4+
后备字体（Fallback Fonts）✅ 0.2.7+
音频（Audio）✅ 0.1.4+
带外资源（Out-of-band Assets）✅ 0.1.4+
文本（Text）✅ 0.1.4+
缓存 Rive 文件（Caching a Rive File）✅ 0.1.4+
事件（Events，已弃用）0.1.4–0.4.x 支持；0.5.0+ 已移除
嵌套文本（Nested Text，已弃用）0.1.4–0.4.x 支持；0.5.0+ 已移除
Flutter（Flutter）
特性支持状态 / 最低版本
游戏手柄（Gamepad）Coming soon
文本输入（Text Input）Coming soon
焦点（Focus）Coming soon
有状态组件（Stateful Components）✅ 0.14.1+
GPU Canvas（GPU Canvas）✅ 0.15.0-dev.1+
全局视图模型（Global View Models）Coming soon
数据绑定字体（Data Binding Fonts）Coming soon
语义（Semantics）✅ 0.15.0+
脚本（Scripting）✅ 0.14.1+
数据绑定列表/图片/画板（Data Binding - Lists, Images, Artboards）✅ 0.14.0-dev.1+
RTL 布局与文本（Right to Left Layouts & Text）✅ 0.14.0-dev.1+
文本沿路径（Text Follow Path）✅ 0.14.0-dev.1+
数据绑定（Data Binding）✅ 0.14.0-dev.1+
矢量羽化（Vector Feathering）✅ 0.14.0-dev.1+
N-Slicing（N-Slicing）✅ 0.14.0-dev.1+
布局（Layouts）✅ 0.14.0-dev.1+
后备字体（Fallback Fonts）Not yet supported
音频（Audio）✅ 0.13.4+
带外资源（Out-of-band Assets）✅ 0.12.0+
文本（Text）✅ 0.11.14+
缓存 Rive 文件（Caching a Rive File）✅ Supported
事件（Events，已弃用）✅ 0.11.17+
嵌套文本（Nested Text，已弃用）✅ 0.13.7+
Apple（Apple）
特性支持状态 / 最低版本
游戏手柄（Gamepad）Coming soon
文本输入（Text Input）Coming soon
焦点（Focus）Coming soon
有状态组件（Stateful Components）✅ 6.16.0+
GPU Canvas（GPU Canvas）✅ 6.25.0+
全局视图模型（Global View Models）✅ 6.28.0+
数据绑定字体（Data Binding Fonts）✅ 6.28.0+
语义（Semantics）✅ 6.21.0+
脚本（Scripting）✅ 6.13.0+
数据绑定列表/图片/画板（Data Binding - Lists, Images, Artboards）✅ 6.11.0+
RTL 布局与文本（Right to Left Layouts & Text）✅ 6.7.4+
文本沿路径（Text Follow Path）✅ 6.7.4+
数据绑定（Data Binding）✅ 6.8.0+
矢量羽化（Vector Feathering）✅ 6.6.0+
N-Slicing（N-Slicing）✅ 6.4.0+
布局（Layouts）✅ 6.3.0+
后备字体（Fallback Fonts）✅ 6.1.0+
音频（Audio）✅ 5.11.5+
带外资源（Out-of-band Assets）✅ 5.7.0+
文本（Text）✅ 5.1.5+
缓存 Rive 文件（Caching a Rive File）✅ Supported
事件（Events，已弃用）✅ 5.3.1+
嵌套文本（Nested Text，已弃用）✅ 6.1.0+
Android（Android）
特性支持状态 / 最低版本
游戏手柄（Gamepad）Coming soon
文本输入（Text Input）Coming soon
焦点（Focus）Coming soon
有状态组件（Stateful Components）✅ 11.2.0+
GPU Canvas（GPU Canvas）Coming soon
全局视图模型（Global View Models）✅ 11.11.0+
数据绑定字体（Data Binding Fonts）Coming soon
语义（Semantics）✅ 11.10.0+
脚本（Scripting）✅ 11.1.0+
数据绑定列表/图片/画板（Data Binding - Lists, Images, Artboards）✅ 10.4.0+
RTL 布局与文本（Right to Left Layouts & Text）✅ 10.0.4+
文本沿路径（Text Follow Path）✅ 10.0.4+
数据绑定（Data Binding）✅ 10.1.0+
矢量羽化（Vector Feathering）✅ 10.0.0+
N-Slicing（N-Slicing）✅ 9.12.0+
布局（Layouts）✅ 9.10.0+
后备字体（Fallback Fonts）✅ 9.7.0+
音频（Audio）✅ 9.3.5+
带外资源（Out-of-band Assets）✅ 8.6.1+
文本（Text）✅ 8.1.3+
缓存 Rive 文件（Caching a Rive File）✅ Supported
事件（Events，已弃用）Deprecated and will be removed in future versions
嵌套文本（Nested Text，已弃用）✅ 9.8.0+
C++（C++）
特性支持状态 / 最低版本
游戏手柄（Gamepad）✅ Supported
文本输入（Text Input）Coming soon
焦点（Focus）✅ Supported
有状态组件（Stateful Components）✅ Supported
GPU Canvas（GPU Canvas）✅ Supported
全局视图模型（Global View Models）✅ Supported
数据绑定字体（Data Binding Fonts）✅ Supported
语义（Semantics）✅ Supported
脚本（Scripting）✅ Supported
数据绑定列表/图片/画板（Data Binding - Lists, Images, Artboards）✅ Supported
RTL 布局与文本（Right to Left Layouts & Text）✅ Supported
文本沿路径（Text Follow Path）✅ Supported
数据绑定（Data Binding）✅ Supported
矢量羽化（Vector Feathering）✅ Supported
N-Slicing（N-Slicing）✅ Supported
布局（Layouts）✅ Supported
后备字体（Fallback Fonts）✅ Supported
音频（Audio）✅ Supported
带外资源（Out-of-band Assets）✅ Supported
文本（Text）✅ Supported
缓存 Rive 文件（Caching a Rive File）✅ Supported
事件（Events，已弃用）✅ Supported
嵌套文本（Nested Text，已弃用）✅ Supported
Unity（Unity）
特性支持状态 / 最低版本
游戏手柄（Gamepad）Coming soon
文本输入（Text Input）Coming soon
焦点（Focus）Coming soon
有状态组件（Stateful Components）✅ 0.4.5+
GPU Canvas（GPU Canvas）Coming soon
全局视图模型（Global View Models）✅ 0.4.5-canary.34+
数据绑定字体（Data Binding Fonts）✅ 0.4.5-canary.36+
语义（Semantics）Not yet supported
脚本（Scripting）✅ 0.4.1-canary.33+
数据绑定列表/图片/画板（Data Binding - Lists, Images, Artboards）✅ 0.3.7-canary.142+
RTL 布局与文本（Right to Left Layouts & Text）✅ 0.3.5+
文本沿路径（Text Follow Path）✅ 0.3.5+
数据绑定（Data Binding）✅ 0.3.6-canary.27+
矢量羽化（Vector Feathering）✅ 0.3.3-canary.72+
N-Slicing（N-Slicing）✅ 0.2.2-canary.22+
布局（Layouts）✅ 0.2.1+
后备字体（Fallback Fonts）Not supported
音频（Audio）✅ Supported
带外资源（Out-of-band Assets）✅ Supported
文本（Text）✅ Supported
缓存 Rive 文件（Caching a Rive File）✅ Supported
事件（Events，已弃用）✅ Supported
嵌套文本（Nested Text，已弃用）✅ Supported
Unreal（Unreal）
特性支持状态 / 最低版本
游戏手柄（Gamepad）Coming soon
文本输入（Text Input）Coming soon
焦点（Focus）Coming soon
有状态组件（Stateful Components）✅ 0.4.25+
GPU Canvas（GPU Canvas）✅ 0.4.26+
全局视图模型（Global View Models）Coming soon
数据绑定字体（Data Binding Fonts）Coming soon
语义（Semantics）Not yet supported
脚本（Scripting）✅ 0.4.20+
数据绑定列表/图片/画板（Data Binding - Lists, Images, Artboards）✅ Supported
RTL 布局与文本（Right to Left Layouts & Text）✅ 0.3.0a-gh+
文本沿路径（Text Follow Path）✅ 0.3.0a-gh+
数据绑定（Data Binding）✅ 0.3.0a-gh+
矢量羽化（Vector Feathering）✅ 0.3.0a-gh+
N-Slicing（N-Slicing）✅ 0.2.2+
布局（Layouts）✅ 0.2.1+
后备字体（Fallback Fonts）Not Supported
音频（Audio）✅ Supported
带外资源（Out-of-band Assets）Not yet supported
文本（Text）✅ Supported
缓存 Rive 文件（Caching a Rive File）Not yet supported
事件（Events，已弃用）✅ Supported
嵌套文本（Nested Text，已弃用）✅ 0.1.14+

Legacy（旧版）​

Legacy Runtime（已弃用）​

警告（Warning）：

  • @rive-app/webgl 自 v2.37.0 起弃用。请使用 @rive-app/webgl2（适合大多数内容），若你的 Rive 图形不需要矢量羽化，也可使用 @rive-app/canvas。
  • @rive-app/react-webgl 自 v4.30.0 起弃用。请使用 @rive-app/react-webgl2（适合大多数内容），若不需要矢量羽化，也可使用 @rive-app/react-canvas。
  • rive-react-native 已弃用。为获得更好的性能和最新特性，请使用 rive-nitro-react-native（@rive-app/react-native）。参见迁移指南。
Web - WebGL（Legacy）
特性支持状态 / 最低版本
游戏手柄（Gamepad）Coming soon
文本输入（Text Input）Coming soon
焦点（Focus）Not supported
有状态组件（Stateful Components）✅ 2.33.0+
GPU Canvas（GPU Canvas）Not supported
全局视图模型（Global View Models）Not supported
数据绑定字体（Data Binding Fonts）Not supported
语义（Semantics）Not supported
脚本（Scripting）✅ 2.34.0+
数据绑定列表/图片/画板（Data Binding - Lists, Images, Artboards）✅ 2.30.3+
RTL 布局与文本（Right to Left Layouts & Text）✅ 2.26.7+
文本沿路径（Text Follow Path）✅ 2.26.7+
数据绑定（Data Binding）✅ 2.26.6+
矢量羽化（Vector Feathering）Not supported
N-Slicing（N-Slicing）✅ 2.23.11+
布局（Layouts）✅ 2.23.3+
后备字体（Fallback Fonts）Not supported
音频（Audio）✅ 2.15.6+
带外资源（Out-of-band Assets）✅ 2.7.0+
文本（Text）✅ 2.1.3+
缓存 Rive 文件（Caching a Rive File）✅ Supported
事件（Events，已弃用）✅ 2.4.3+
嵌套文本（Nested Text，已弃用）✅ 2.21.0+
React - WebGL（Legacy）
特性支持状态 / 最低版本
游戏手柄（Gamepad）Coming soon
文本输入（Text Input）Coming soon
焦点（Focus）Not supported
有状态组件（Stateful Components）✅ 4.25.0+
GPU Canvas（GPU Canvas）Not supported
全局视图模型（Global View Models）Not supported
数据绑定字体（Data Binding Fonts）Not supported
语义（Semantics）Not supported
脚本（Scripting）✅ 4.26.0+
数据绑定列表/图片/画板（Data Binding - Lists, Images, Artboards）✅ 4.22.0+
RTL 布局与文本（Right to Left Layouts & Text）✅ 4.18.6+
文本沿路径（Text Follow Path）✅ 4.18.6+
数据绑定（Data Binding）✅ 4.20.0+
矢量羽化（Vector Feathering）Not supported
N-Slicing（N-Slicing）✅ 4.16.7+
布局（Layouts）✅ 4.16.0+
后备字体（Fallback Fonts）Not supported
音频（Audio）✅ 4.9.5+
带外资源（Out-of-band Assets）✅ 4.5.0+
文本（Text）✅ 4.1.3+
缓存 Rive 文件（Caching a Rive File）✅ Supported
事件（Events，已弃用）✅ 4.3.3+
嵌套文本（Nested Text，已弃用）✅ 4.14.0+
React Native（Legacy）
特性支持状态 / 最低版本
游戏手柄（Gamepad）Coming soon
文本输入（Text Input）Coming soon
焦点（Focus）Coming soon
有状态组件（Stateful Components）Not supported
GPU Canvas（GPU Canvas）Not supported
全局视图模型（Global View Models）Not supported
数据绑定字体（Data Binding Fonts）Not supported
语义（Semantics）Not supported
脚本（Scripting）✅ 9.8.0+
数据绑定列表/图片/画板（Data Binding - Lists, Images, Artboards）Not supported
RTL 布局与文本（Right to Left Layouts & Text）✅ 9.2.1+
文本沿路径（Text Follow Path）✅ 9.2.1+
数据绑定（Data Binding）✅ 9.3.0+
矢量羽化（Vector Feathering）✅ 9.0.0+
N-Slicing（N-Slicing）✅ 8.2.0+
布局（Layouts）✅ 8.1.0+
后备字体（Fallback Fonts）Not supported
音频（Audio）✅ 7.0.3+
带外资源（Out-of-band Assets）✅ 8.4.0+
文本（Text）✅ 6.0.3+
缓存 Rive 文件（Caching a Rive File）Not supported
事件（Events，已弃用）✅ 6.1.0+
嵌套文本（Nested Text，已弃用）✅ 5.8.2+

已弃用特性（Deprecated features）​

  • 🟡 Events（事件）
    • 运行时监听 Rive Events 已进入弃用路径。
    • 建议改用 Data Binding 监听 Trigger 或属性变化。
  • 🟡 Nested Text（嵌套文本运行时赋值）
    • 旧版 text run 直接改值能力处于弃用路径。
    • 建议改用 Data Binding 的 string 属性绑定文本。
看完还有疑问？进群交流下！
与众多 Rive 创作者、开发者一起交流探讨与答疑解惑。
加入交流群
看文档卡住了？看视频实操课更直观！
国内首个 Rive 零基础中文系列课
( Rive CEO 点赞转发 👍 )
48+章节
4大核心模块
15+实战案例