# @8thwall/engine-binary 中文文档

规范地址：https://npmcn.com/package/%408thwall/engine-binary/

版本：1\.0\.0
npm 元数据更新时间：2026-04-07T22:49:12.485Z
中文译文更新时间：2026-11-05T22:31:39.323Z
软件包许可：See LICENSE

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

原始 npm 页面：https://www.npmjs.com/package/%408thwall/engine-binary
原文对照：https://npmcn.com/package/%408thwall/engine-binary/?lang=original
项目主页：https://8thwall.org/
源码仓库：https://github.com/8thwall/engine

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

- 包体积（解压后）：31 MB，17 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2026-04-02T18:08:30.499Z
- 最新版本发布：2026-04-03T23:53:34.189Z
- 近 30 天下载量：11931（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：4（近 12 个月 4 个）

## 中文简介

跨平台框架, 基于浏览器的 AR

## 安装

```sh
npm install @8thwall/engine-binary
```

也可以使用：`pnpm add @8thwall/engine-binary`、`yarn add @8thwall/engine-binary`、`bun add @8thwall/engine-binary`

## README

# 8号墙引擎

> \[大 这不是麻省理工学院许可的开源 第8Wall引擎. 这是在一个单独的存储器中,可以找到 [这里](https://github.com/8thwall/8thwall/blob/main/packages/engine/README.md)。 。 。 .

## 使用量

见 [https://8thwall.org/docs/engine/overview (中文(简体) )](https://8thwall.org/docs/engine/overview) 更详尽的指南.

### 备选案文1:脚本标签

```html
<script src="https://cdn.jsdelivr.net/npm/@8thwall/engine-binary@1/dist/xr.js" async crossorigin="anonymous" data-preload-chunks="slam"></script>
```

### 备选案文2:npm

```
npm install @8thwall/engine-binary
```

您需要将包含的文物复制到您的 dist 文件夹中, 例如在 Webpack 中 :

```js
new CopyWebpackPlugin({
  patterns: [
    {
      from: 'node_modules/@8thwall/engine-binary/dist',
      to: 'external/xr',
    }
  ]
})
```

然后可以通过在index.html中添加以下内容来加载 SDK :

```html
<script src="./external/xr/xr.js" async data-preload-chunks="slam"></script>
```

导入软件包时, 一旦装入, 您将获得访问 XR8 的简单帮助 。 此承诺只有在脚本标记包含在 HTML 中时才会解决.

```js
import {XR8Promise} from '@8thwall/engine-binary'

XR8Promise.then((XR8) => XR8.XrController.configure({}))
```

## 概览

8th Wall引擎二进制包含能使8th Wall体验的核心AR能力,包括:

-   世界影响
-   面部效果
-   图像目标
-   天空效应
-   绝对缩放

八壁引擎二进制不包括:

-   源代码访问
-   修改或再编译引擎的能力
-   VPS, Lightship Maps等长相空间产品或地理空间浏览器
-   手迹追踪

## 可接受使用和许可证

分配引擎二进制通过有限使用许可证提供,该许可证对如何使用加以限制。 许可证全文是: [这里](https://github.com/8thwall/engine/blob/main/LICENSE)请参看 [允许使用 FAQ](https://8thwall.org/docs/migration/faq#distributed-engine-binary-license-and-permitted-use) 财务报告和审定财务报表 [分配准则](https://8thwall.org/docs/open-source) 更多信息.

## 常见问题

### @8thwall/engine-binary 是什么？

跨平台框架, 基于浏览器的 AR

### 如何安装 @8thwall/engine-binary？

在项目目录运行 npm install @8thwall/engine-binary，或使用 pnpm add / yarn add / bun add。

### @8thwall/engine-binary 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/8thwall\_\_engine-binary 是否存在。

### @8thwall/engine-binary 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @8thwall/engine-binary 可以商用吗？

@8thwall/engine-binary 使用 See LICENSE 许可。声明的许可为 See LICENSE，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。

### @8thwall/engine-binary 的下载量有多少？

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

### @8thwall/engine-binary 还在维护吗？

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