GPU Canvas

GPU Canvas 用于在 React Native 运行时中启用 3D 内容。它是进程级设置：会应用于应用加载的每一个 Rive 文件，以及渲染这些文件的每一个 RiveView。

渲染 3D 内容必须启用 GPU Canvas。需要 @rive-app/react-native 0.5.3 或更高版本。

启用 GPU Canvas（Enabling GPU Canvas）

在加载任何 Rive 文件之前调用 RiveRuntime.setGPUCanvasEnabled(true)，例如在应用启动时：

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

RiveRuntime.setGPUCanvasEnabled(true);

该设置在第一个 Rive 文件加载后即固定。之后的调用会被忽略并记录一条警告。

RiveView 无需额外配置。

检查设置（Checking the setting）

使用 RiveRuntime.isGPUCanvasEnabled() 检查 GPU Canvas 是否已生效：

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

if (!RiveRuntime.isGPUCanvasEnabled()) {
  console.warn('GPU Canvas is not available; 3D content will not render.');
}

在第一个文件加载之前，它返回所请求的设置。第一个文件加载之后，它返回实际正在使用的设置；如果本地 SDK 无法提供 GPU Canvas，则返回 false。

本地 SDK 要求（Native SDK requirements）

GPU Canvas 使用 Apple 和 Android 运行时的 GPU Canvas 支持。@rive-app/react-native 捆绑的默认本地 SDK 版本已支持该功能。如果你覆盖本地 SDK 版本：

• iOS 需要 Rive iOS 6.25.0 或更高版本。更旧的版本会编译失败。
• Android 需要 Rive Android 11.12.0 或更高版本。使用更旧的版本时，文件会在没有 GPU Canvas 的情况下加载，并记录一条警告，且 isGPUCanvasEnabled() 返回 false。

默认行为（Default behavior）

GPU Canvas 默认关闭。如果你的内容不需要它，请不要调用 setGPUCanvasEnabled。

完整设置示例请参见示例应用中的 GPU Canvas 示例。