Galacean Effects 技术文档

安装指南

要使用 Galacean Effects，您可以通过以下两种主流包管理器进行安装：

使用 npm

在命令行中输入以下命令：

npm install @galacean/effects

使用 pnpm

如果您更倾向于使用 pnpm，可以执行：

pnpm add @galacean/effects

这两种方法都会将 Galacean Effects 库添加到您的项目依赖中。

项目的使用说明

在您的 HTML 文件中准备一个容器用于播放动画效果：

<div id="J-Container"></div>

接着，在相应的 TypeScript 或 JavaScript 文件里，按照以下步骤来实例化并播放动画：

import { Player } from '@galacean/effects';

// 实例化播放器
const player = new Player({
  container: document.getElementById('J-Container'), // 指定动画渲染的DOM元素
});

// 加载并播放动画场景文件
player.loadScene('./demo.json'); 

// 注意：'./demo.json' 是通过 Galacean Effects 编辑器创建的动画数据文件。

项目API使用文档

Galacean Effects 提供了一套丰富的API来支持复杂的动画控制。虽然具体的API文档位于其官方网站上，这里简要提及关键点：

• Player 类：是核心类，负责加载和播放动画场景。
  • new Player(options) 初始化播放器，需要传入包含容器（DOM元素）的对象。
  • loadScene(path: string) 方法用于加载动画资源文件。

更多详细的API说明，如事件监听、动画状态控制等，请参考官方文档的API 文档部分。

项目安装补充

确保在安装和使用 Galacean Effects 之前，您的开发环境已配置了 Node.js，并且理解基本的前端包管理工具操作。此外，为了自定义和扩展动画效果，开发者应当熟悉 TypeScript 或 JavaScript，并且建议了解 WebGL 的基础概念，尽管这不是直接操作的必要条件。

通过上述指导，您可以开始集成 Galacean Effects 到您的项目中，创造令人瞩目的动画体验。详细的功能探索和高级用法推荐访问项目的官网和官方文档获取最新信息。