加载资源

概述

在运行时加载和替换资源是 Rive 的一项重要功能。Rive 文件（.riv）可以包含嵌入资源或引用外部资源。

加载资源的方法

Rive 支持多种资源加载方法：

• 嵌入资源：资源直接打包在 .riv 文件中
• CDN 加载：资源通过 Rive 的 CDN 加载
• 引用资源：资源通过外部 URL 引用

嵌入资源

嵌入资源直接存储在 .riv 文件中，无需额外加载步骤。

通过 CDN 加载

Rive 可以通过其 CDN 自动加载资源。设置 enableRiveAssetCDN 为 true 即可启用。

图片 CDN

对于通过 CDN 托管的图片资源，确保 URL 可公开访问。

引用资源

引用资源是在 .riv 文件中通过 URL 或路径引用的外部资源。

处理资源

示例

• 指定要加载的字体资源
• 本地化 - 根据语言切换字体（TypeScript & i18n）
• 指定要加载的图片资源

使用资源处理 API

使用 useRive Hook 实例化新的 Rive 实例时，在参数列表中添加 assetLoader 回调属性。此回调将在运行时检测到的每个资源（从 .riv 文件加载时）被调用，负责处理运行时资源的加载，或让运行时自行加载。

请注意，assetLoader 回调只能与 useRive 和 useRiveFile Hook 一起使用，不能用于 React 运行时默认导出的 <Rive /> 组件。

assetLoader: (asset: rc.FileAsset, bytes: Uint8Array) => boolean;

更多 API 详情请参见 Web (JS) 示例。