# @amaspace-editor/editor-3d 中文文档

规范地址：https://npmcn.com/package/%40amaspace-editor/editor-3d/

版本：0\.2\.23
npm 元数据更新时间：2026-11-03T16:48:32.930Z
中文译文更新时间：2026-11-06T02:07:48.183Z
软件包许可：ISC

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40amaspace-editor/editor-3d
原文对照：https://npmcn.com/package/%40amaspace-editor/editor-3d/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：5.9 MB，666 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：33 个
- peer 依赖：react ^18\.2\.0
- 首次发布：2022-11-13T18:53:46.794Z
- 最新版本发布：2026-11-03T16:48:32.727Z
- 近 30 天下载量：6692（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：534（近 12 个月 18 个）

## 中文简介

Amaspace 3D编辑器 SDK – React + react- 三纤维组件用于3D产品可视化,定制和AR.

## 安装

```sh
npm install @amaspace-editor/editor-3d
```

也可以使用：`pnpm add @amaspace-editor/editor-3d`、`yarn add @amaspace-editor/editor-3d`、`bun add @amaspace-editor/editor-3d`

## README

# `@amaspace-editor/editor-3d`

Amaspace 三维编辑器 SDK — 三维产品的反应+反应- 三纤维组件 视觉、定制和AR.

## 安装

```sh
npm i @amaspace-editor/editor-3d
```

要求数 **反应 18** (同类依赖). SDK号飞船自有3.js/ @ react-3/fiber 8 sack 作为硬依赖性——主机在React 19/R3F 9上 无法与它共享反应树, 并且应该在单独的运行时间嵌入它 (参见龙卷风-定制器中的部件模式).

## 使用量

```tsx
import { AMAMode, EditorConstructor } from '@amaspace-editor/editor-3d'
import '@amaspace-editor/editor-3d/dist/style.css'

<EditorConstructor
    type="scene"
    assetId={productId}
    apiKey={AMASPACE_API_KEY}
    presetConfig={{
        mode: AMAMode.VIEWER,
        applyProductRules: true,
        grid: false,
        startAnimation: false,
        baseURL: AMASPACE_BASE_URL,
        // Opt-in demand rendering (>=0.2.16): renders only when the scene
        // changes instead of continuously.
        frameloop: 'demand',
    }}
/>
```

`AMAMode.VIEWER` 使只读配置符; `AMAMode.EDITOR` 启用 完全编辑 UI. 除了构造器外, 软件包还输出场景 库存(`useSelectorsStore`、.)、钩子、动作和功用——见 `lib/editor-3d.ts` 为整个地表.

## 发展

```sh
npm run build   # vite build --config vite-config.js → dist/
```

## 常见问题

### @amaspace-editor/editor-3d 是什么？

Amaspace 3D编辑器 SDK – React \+ react- 三纤维组件用于3D产品可视化,定制和AR\.

### 如何安装 @amaspace-editor/editor-3d？

在项目目录运行 npm install @amaspace-editor/editor-3d，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^18\.2\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @amaspace-editor/editor-3d 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @amaspace-editor/editor-3d 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @amaspace-editor/editor-3d 可以商用吗？

@amaspace-editor/editor-3d 使用 ISC 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @amaspace-editor/editor-3d 的下载量有多少？

根据 npm 官方下载统计，@amaspace-editor/editor-3d 在 2026/10/06 – 2026/11/04 这 30 天内被下载 6,692 次，日均约 223 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @amaspace-editor/editor-3d 还在维护吗？

最新版本 0\.2\.23 发布于 2026/11/04（2 天前）；至今共发布 534 个版本，其中过去 12 个月发布了 18 个；首次发布于 2022/11/14。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。