# 3d-force-graph-ar 中文文档

规范地址：https://npmcn.com/package/3d-force-graph-ar/

版本：1\.10\.0
npm 元数据更新时间：2025-07-02T23:26:53.734Z
中文译文更新时间：2026-11-05T18:25:23.958Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/3d-force-graph-ar
原文对照：https://npmcn.com/package/3d-force-graph-ar/?lang=original
项目主页：https://github.com/vasturiano/3d-force-graph-ar
源码仓库：https://github.com/vasturiano/3d-force-graph-ar

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

- 包体积（解压后）：1 MB，8 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=12
- 运行依赖：2 个
- 首次发布：2019-11-20T14:21:27.779Z
- 最新版本发布：2025-07-02T23:26:53.536Z
- 近 30 天下载量：74536（2026-10-04 至 2026-11-02，npm 官方下载统计）
- 已发布版本数：49（近 12 个月 0 个）

## 中文简介

AR 中三维力导图的 UI 组件

## 安装

```sh
npm install 3d-force-graph-ar
```

也可以使用：`pnpm add 3d-force-graph-ar`、`yarn add 3d-force-graph-ar`、`bun add 3d-force-graph-ar`

## README

# AR 中3D 强制定向图

[![NPM package](https://img.shields.io/npm/v/3d-force-graph-ar)](https://npmjs.org/package/3d-force-graph-ar) [![Build Size](https://img.shields.io/bundlephobia/minzip/3d-force-graph-ar)](https://bundlephobia.com/result?p=3d-force-graph-ar) [![NPM Downloads](https://img.shields.io/npm/dt/3d-force-graph-ar)](https://www.npmtrends.com/3d-force-graph-ar)

[![](https://vasturiano.github.io/3d-force-graph-ar/example/async-load/preview.jpg)](https://vasturiano.github.io/3d-force-graph-ar/example/async-load/)

使用由力导的迭代布局,在增强现实中代表图表数据结构的网络组件. 用途 [经常预算.js](https://github.com/AR-js-org/AR.js) 与 [A - Frame (英语)](https://aframe.io/) 用于渲染和 [d3-兵力-3d](https://github.com/vasturiano/d3-force-3d) 用于布局物理引擎.

另见 [VR 版本](https://github.com/vasturiano/3d-force-graph-vr), (中文(简体) ), [WebGL 三维版本](https://github.com/vasturiano/3d-force-graph),则 [A-Frame 组件版本(框架-forcegraph-组件)](https://github.com/vasturiano/aframe-forcegraph-component)。 。 。 .

看看这个 [反应绑定](https://github.com/vasturiano/react-force-graph)。 。 。 .

装入以下示例:

-   打开这个 [hiro 标记图像](https://ar-js-org.github.io/AR.js/data/images/HIRO.jpg) 在您的桌面浏览器中.
-   在您的手机浏览器上打开示例,并将其指向桌面屏幕.

请检查date=中的日期值 (帮助) 示例:

-   [基础](https://vasturiano.github.io/3d-force-graph-ar/example/basic/) (单位:千美元)[来源](https://github.com/vasturiano/3d-force-graph-ar/blob/master/example/basic/index.html)(中文(简体) )
-   [同步负载](https://vasturiano.github.io/3d-force-graph-ar/example/async-load/) (单位:千美元)[来源](https://github.com/vasturiano/3d-force-graph-ar/blob/master/example/async-load/index.html)(中文(简体) )
-   [更大的图 (~4k 元素)](https://vasturiano.github.io/3d-force-graph-ar/example/large-graph/) (单位:千美元)[来源](https://github.com/vasturiano/3d-force-graph-ar/blob/master/example/large-graph/index.html)(中文(简体) )
-   [方向箭头](https://vasturiano.github.io/3d-force-graph-ar/example/directional-links-arrows/) (单位:千美元)[来源](https://github.com/vasturiano/3d-force-graph-ar/blob/master/example/directional-links-arrows/index.html)(中文(简体) )
-   [方向移动粒子](https://vasturiano.github.io/3d-force-graph-ar/example/directional-links-particles/) (单位:千美元)[来源](https://github.com/vasturiano/3d-force-graph-ar/blob/master/example/directional-links-particles/index.html)(中文(简体) )
-   [曲线行和自链接](https://vasturiano.github.io/3d-force-graph-ar/example/curved-links/) (单位:千美元)[来源](https://github.com/vasturiano/3d-force-graph-ar/blob/master/example/curved-links/index.html)(中文(简体) )
-   [自动有色节点/链接](https://vasturiano.github.io/3d-force-graph-ar/example/auto-colored/) (单位:千美元)[来源](https://github.com/vasturiano/3d-force-graph-ar/blob/master/example/auto-colored/index.html)(中文(简体) )
-   [文本作为节点](https://vasturiano.github.io/3d-force-graph-ar/example/text-nodes/) (单位:千美元)[来源](https://github.com/vasturiano/3d-force-graph-ar/blob/master/example/text-nodes/index.html)(中文(简体) )
-   [作为节点的图像](https://vasturiano.github.io/3d-force-graph-ar/example/img-nodes/) (单位:千美元)[来源](https://github.com/vasturiano/3d-force-graph-ar/blob/master/example/img-nodes/index.html)(中文(简体) )
-   [自定义节点几何](https://vasturiano.github.io/3d-force-graph-ar/example/custom-node-geometry/) (单位:千美元)[来源](https://github.com/vasturiano/3d-force-graph-ar/blob/master/example/custom-node-geometry/index.html)(中文(简体) )
-   [链接中的案文](https://vasturiano.github.io/3d-force-graph-ar/example/text-links/) (单位:千美元)[来源](https://github.com/vasturiano/3d-force-graph-ar/blob/master/example/text-links/index.html)(中文(简体) )
-   [动态数据变化](https://vasturiano.github.io/3d-force-graph-ar/example/updating/) (单位:千美元)[来源](https://github.com/vasturiano/3d-force-graph-ar/blob/master/example/updating/index.html)(中文(简体) )
-   [节点相撞探测](https://vasturiano.github.io/3d-force-graph-ar/example/collision-detection/) (单位:千美元)[来源](https://github.com/vasturiano/3d-force-graph-ar/blob/master/example/collision-detection/index.html)(中文(简体) )
-   [按需将颗粒连接起来](https://vasturiano.github.io/3d-force-graph-ar/example/emit-particles/) (单位:千美元)[来源](https://github.com/vasturiano/3d-force-graph-ar/blob/master/example/emit-particles/index.html)(中文(简体) )

## 支持此项目

如果您认为此模块有用并愿意支持其开发, 您可以 [给我买个](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=L398E7PKP47E8&currency_code=USD&source=url)您的贡献有助于保持开源的可持续性 ! [![paypal](https://www.paypalobjects.com/en_US/i/btn/btn_donate_SM.gif)](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=L398E7PKP47E8&currency_code=USD&source=url)

## 快开始

```js
import ForceGraphAR from '3d-force-graph-ar';
```

或使用 _脚本_ 标签

```html
<script src="//cdn.jsdelivr.net/npm/3d-force-graph-ar"></script>
```

接下来

```js
const myGraph = new ForceGraphAR(<myDOMElement>)
    .graphData(<myData>);
```

请在您的应用程序中装入所需的这两个脚本标记 `AR.js` + 键 `A-frame` 要正常运行 :

```html
<script src="//cdn.jsdelivr.net/npm/aframe"></script>
<script src="//cdn.jsdelivr.net/npm/@ar-js-org/ar.js"></script>
```

## API 参考

### 初始化

```js
new ForceGraphAR(<domElement>, { configOptions })
```

| 配置选项 | 说明 | 默认 |
| --- | --- | :-: |
| **标记**数字 : _对象_ | 一组属性,根据 [a 标记规格](https://ar-js-org.github.io/AR.js-Docs/marker-based/)。 。 。 . | `{ preset: 'hiro' }` |

### 数据输入

| 方法 | 说明 | 默认 |
| --- | --- | :-: |
| **图表数据**(\[_数据_) | Getter/stetter用于图表数据结构(见下文语法细节). | `{ nodes: [], links: [] }` |
| **日出尔**(\[_url 密码_) | 直接从 JSON 文件装入图表数据的 URL, 作为指定选项 _图表数据_ 直接说. |  |
| **节点**(\[_字符串_) | 唯一节点id的节点对象访问器属性(用于链接对象源/目标). | `id` |
| **链接来源**(\[_字符串_) | 链接对象访问器属性,指源节点的ID. | `source` |
| **链接目标**(\[_字符串_) | 链接对象存取器属性,指目标节点的id. | `target` |

### 集装箱布局

| 方法 | 说明 | 默认 |
| --- | --- | :-: |
| **yOffset 组合**(\[_编号_) | 将中心坐标放置在标记上方的相抵距离取出 `<0,0,0>` (原始内容存档于2018-09-21). Introduction of the Force direct graph. 以标记宽度单位计量. | 1\. 5个 |
| **缩略图**(\[_编号_) | 在真实世界相距和WebGL单位之间的翻译比例尺的Getter/stetter,决定了图表的整体大小. 以多少个GL单位适合一个完整的标记宽度来定义. | 200个 |
| **宽度**(\[_ưμ㼯a_) | 获取/改进取景口画布宽度 . | _< 窗口宽度 >_ |
| **高度**(\[_ưμ㼯a_) | 获取/改进取景口画布高度 . | _< 窗口高度 >_ |

### 节点样式

| 方法 | 说明 | 默认 |
| --- | --- | :-: |
| **节点RelSize**(\[_数字_) | 每个值单位的节点球体体积(cubic px)之比的获取器/改进器. | 页:1 |
| **节点Val**(\[_数字_, (中文(简体) ), _字符串_ 或者说 _fn 时_) | 节点对象存取器函数,属性或节点数字值的数值常数(影响球体体积). | `val` |
| **节点可见度**(\[_布尔_, (中文(简体) ), _字符串_ 或者说 _fn 时_) | 用于是否显示节点的节点对象访问器函数,属性或布尔常数. | `true` |
| **节点颜色**(\[_字符串_ 或者说 _fn 时_) | 节点对象访问器对节点颜色的功能或属性(影响球体颜色). | `color` |
| **节点自动颜色By**(\[_字符串_ 或者说 _fn 时_) | 节点对象访问器功能( E)`fn(node)`)或属性(例如. `'type'`)自动组合颜色。 只影响没有颜色属性的节点. |  |
| **节点距离**(\[_数字_) | 节点球体不透明度的取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取. | 0.75 (简体中文) |
| **节点解析**(\[_数字_) | 每个节点几何分辨率的取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取 更高的数值产生更平滑的球体. | 第8条 |
| **节点三对象**(\[_对象3d_, (中文(简体) ), _字符串_ 或者说 _fn 时_) | 用于生成自定义 3d 对象的节点对象访问器功能或属性以渲染为图节点. 应返回实例 [3JS 对象3d](https://threejs.org/docs/index.html#api/core/Object3D)如为 _叶子_ 值返回时,该节点将使用默认的3d对象类型. | _默认节点对象是一个球体,大小按照 `val` 并按 `color`。 。 。 ._ |
| **节点三对象外出**(\[_嘘_, (中文(简体) ), _字符串_ 或者说 _fn 时_) | 在使用自定义时是否替换默认节点的节点对象访问器函数、属性或布尔值 `nodeThreeObject` (单位:千美元)`false`或予以延长(`true`) (中文(简体) ). | `false` |

### 链接样式

| 方法 | 说明 | 默认 |
| --- | --- | :-: |
| **链接可视性**(\[_布尔_, (中文(简体) ), _字符串_ 或者说 _fn 时_) | 链接对象访问器函数,属性或布尔常数,用于是否显示链接行. 价值为 `false` 保持连接力而不渲染. | `true` |
| **链接颜色**(\[_字符串_ 或者说 _fn 时_) | 链接对象访问器功能或属性为行色. | `color` |
| **链接自动颜色By**(\[_字符串_ 或者说 _fn 时_) | 链接对象访问器功能( L)`fn(link)`)或属性(例如. `'type'`)自动组合颜色。 只影响没有色彩属性的链接. |  |
| **链接**(\[_数字_) | 连接线不透明取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取. | 0.2 (韩语) |
| **链接窗口**(\[_数字_, (中文(简体) ), _字符串_ 或者说 _fn 时_) | 链接对象访问器功能,属性或链接行宽的数值常数. 值为 0 的值将变成 [三JS线](https://threejs.org/docs/#api/objects/Line) 宽度不变的(`1px`无论距离如何。 值被四舍五入到最近的小数,以进行索引. | 0 个 |
| **链接决议**(\[_数字_) | 每个链接的几何分辨率的取出器/取出器,用多少光圈分出圆柱来表示. 较高的数值产生更平滑的圆柱. 仅适用于正宽度的链接. | 6个 |
| **链接**(\[_数字_, (中文(简体) ), _字符串_ 或者说 _fn 时_) | 链接对象存取器的功能,属性或链接线曲率半径的数值常数. 曲线以3D贝塞尔曲线表示,任何数值都接受. 价值为 `0` 使直线. `1` 表示半径等于线长的一半,使曲线近似于半圆. 自我参考链接`source` 等于 `target`)曲线作为环绕节点的回路来表示,长度与曲率值成正比. 行为正值的顺时针曲线,为负值的逆时针. 注意渲染曲线线条纯粹是一种视觉效果,并不影响基础力的行为. | 0 个 |
| **链接浏览旋转**(\[_数字_, (中文(简体) ), _字符串_ 或者说 _fn 时_) | 链接对象存取器函数,属性或数值常数,用于沿行轴旋转来应用到曲线上. 对直线没有影响 时 `0` 旋转,曲线方向为相交点的方向 `XY` 飞机 旋转角(以弧度表示)会从这个参考方向绕出"从起到去"的轴来顺时针旋转曲线行走. | 0 个 |
| **链接元件**(\[_材料_, (中文(简体) ), _字符串_ 或者说 _fn 时_) | 链接对象访问器功能或属性,用于指定自定义的材料来给图形链接样式. 应返回实例 [三个JS材料](https://threejs.org/docs/#api/materials/Material)如为 _叶子_ 值将返回,默认材料将用于此链接. | _默认链接材料是 [梅斯兰伯特材料公司](https://threejs.org/docs/#api/materials/MeshLambertMaterial) 样式按照 `color` 财务报告和审定财务报表 `opacity`。 。 。 ._ |
| **链接三对象**(\[_对象3d_, (中文(简体) ), _字符串_ 或者说 _fn 时_) | 链接对象存取器功能或属性,用于生成自定义的 3d 对象来渲染为图链接. 应返回实例 [3JS 对象3d](https://threejs.org/docs/index.html#api/core/Object3D)如为 _叶子_ 值返回时,该链接将使用默认的 3d 对象类型. | _默认链接对象是一个行或圆柱形,大小按照 `width` 并按 `material`。 。 。 ._ |
| **链接三对象扩展**(\[_嘘_, (中文(简体) ), _字符串_ 或者说 _fn 时_) | 链接对象访问器函数、属性或布尔值,用于在使用自定义时是否替换默认链接 `linkThreeObject` (单位:千美元)`false`或予以延长(`true`) (中文(简体) ). | `false` |
| **链接选项更新**(\[_fn(link Object, { start, end}, link) 主题主题 主题 主题 主题_) | 自定义函数需要更新链接在每次转换时的位置。 它收到相应的链接 `ThreeJS Object3d`,则 `start` 财务报告和审定财务报表 `end` 坐标:`{x,y,z}` 和链接的 `data`。如果函数返回一个真实值,则正则位置更新函数将不会运行于该链接. |  |
| **链接方向箭头Length**(\[_数字_, (中文(简体) ), _字符串_ 或者说 _fn 时_) | 链接对象访问器函数,属性或表示链接方向性的箭头长度的数值常数. 箭头直接显示在链接线上,指向方向 `source` > 翻译: `target`。数值为 `0` 藏出箭来. | 0 个 |
| **链接方向箭头颜色**(\[_字符串_ 或者说 _fn 时_) | 为箭头的颜色链接对象访问器功能或属性. | `color` |
| **链接方向箭头RelPos**(\[_数字_, (中文(简体) ), _字符串_ 或者说 _fn 时_) | 链接对象存取器函数、属性或箭头沿链接线纵向位置的数值常数,以比例表示 `0` 财务报告和审定财务报表 `1`时 `0` 表示紧接 `source` 节点, `1` 旁边 `target` 节点,和 `0.5` 就在中间. | 0.5 (韩语) |
| **链接方向箭头分辨率**(\[_数字_) | 箭头几何分辨率取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取 更高的值产生更平滑的箭头. | 第8条 |
| **链接方向 文章**(\[_数字_, (中文(简体) ), _字符串_ 或者说 _fn 时_) | 链接对象存取器函数,属性或数常数,用于在链接行上显示的粒子数(小球). 颗粒沿线分布等距,行走方向 `source` > 翻译: `target`,并可用于表示链接方向性. | 0 个 |
| **线性粒子**(\[_数字_, (中文(简体) ), _字符串_ 或者说 _fn 时_) | 链接对象访问器的函数,属性或方向粒子速度的数值常数,以每个帧的链接长度与行程之比来表示. 以上数值 `0.5` 被劝阻. | 0.01 (简体中文) |
| **链接直线粒子集**(\[_数字_, (中文(简体) ), _字符串_ 或者说 _fn 时_) | 链接对象存取器函数,属性或一个数值常数来抵消方向粒子初始位置,相对于一个完整的位置周期,表示为0到1之间的值. | 0 个 |
| **链接直线粒子Width**(\[_数字_, (中文(简体) ), _字符串_ 或者说 _fn 时_) | 链接对象存取器的功能,属性或方向粒子宽度的数值常数. 值被四舍五入到最近的小数,以进行索引. | 0.5 (韩语) |
| **线性粒子颜色**(\[_字符串_ 或者说 _fn 时_) | 将对象存取器功能或属性连接到方向粒子颜色. | `color` |
| **链接直线粒子解析**(\[_数字_) | 每个方向粒子的几何分辨率取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取的取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取 更高的值产生更平滑的粒子. | 页:1 |
| **链接直线粒子三对象**(\[_对象3d_, (中文(简体) ), _字符串_ 或者说 _fn 时_) | 链接对象存取器功能或属性,用于自定义的3d对象,用于方向粒子. 应返回实例 [3JS 对象3d](https://threejs.org/docs/index.html#api/core/Object3D)。激活此选项将忽略粒子宽度、颜色和分辨率的设定值. |  |
| **发射粒子**(单位:千美元)_链接_(中文(简体) ) | 一种生成粒子的替代机制,这种方法释放出一个特定环节内的非周期性单粒子. 所排放的粒子共享正则粒子道具的造型(速度,宽度,颜色). 一个有效的 `link` 包含在 `graphData` 应作为单一参数来通过. |  |

### 互动

| 方法 | 说明 | 默认 |
| --- | --- | :-: |
| **在节点Hover上**(\[_fn 时_) | 节点悬浮事件召回函数 。 节点对象(或 `null` 如果直接在指向视线下有节点)作为第一个参数包含,而上一个节点对象(或 `null`作为第二个论据. | \- 说吧 |
| **在 LinkHover 时**(\[_fn 时_) | 链接徘徊事件的召回功能 。 链接对象(或 `null` 如果直接在指向视线下没有链接)作为第一个参数列入,而上一个链接对象(或 `null`作为第二个论据. | \- 说吧 |
| **在节点上**(\[_fn 时_) | 节点点击事件召回函数 。 将节点对象列为唯一参数. | \- 说吧 |
| **在 LinkClick 上 (英语)**(\[_fn 时_) | 链接点击事件召回功能 。 链接对象列为唯一参数. | \- 说吧 |

### 强制引擎配置

| 方法 | 说明 | 默认 |
| --- | --- | :-: |
| **强制引擎**(\[_字符串_) | 用于强模拟发动机的取取器/取取取器([_(单位:千美元)_](https://github.com/vasturiano/d3-force-3d) 或者说 [_图形_](https://github.com/anvaka/ngraph.forcelayout)) (中文(简体) ). | `d3` |
| **数字**(\[_单位_) | 以1、2 或 3 进行力模拟的维数获得/改进器. | 3个 |
| **数字模式**(\[_字符串_) | 根据图表方向性应用布局约束. 只为正确工作 [数据](https://en.wikipedia.org/wiki/Directed_acyclic_graph) 图表结构(没有周期)。 选择 `td` (自上而下), `bu` (自下而上), `lr` (从左到右), `rl` (从右到左), `zout` (相近相接相接相接相接), `zin` (远至相近), `radialout` (辐射外)或 `radialin` (入而为通. |  |
| **数字等级差异**(\[_数字_) | 若为 `dagMode` 中,此选项指定不同图表深度之间的距离. | _自动取自节点数_ |
| **dag 节点过滤器**(\[_fn 时_) | 节点访问器功能可以指定节点,以便在DAG布局处理过程中忽略. 此访问器方法接收到一个节点对象,并应返回 a `boolean` 值表示是否要包含节点。 被排除在外的节点将不受限制,并可自由向任何方向移动. | `node => true` |
| **默认错误**(\[_fn 时_) | 如果在 DAG 版式处理数据结构时遇到周期, 请调用 。 图表的回路段作为节点代号的阵列包含在其中以供参考. 默认情况下, 每当遇到循环时都会丢出一个例外 。 您可以将这种方法覆盖到外部处理此案件, 并允许图表继续 DAG 处理 。 如果遇到回路,严格地图的方向性得不到保证,结果就是建立分级制度的最佳努力. | _丢弃例外_ |
| **d3 阿尔法明**(\[_数字_) | 获取/获取 [模拟阿尔法分](https://github.com/vasturiano/d3-force-3d#simulation_alphaMin) 参数,仅在使用d3模拟引擎时适用. | `0` |
| **d3 阿尔法德克**(\[_数字_) | 获取/获取 [模拟强度衰减](https://github.com/vasturiano/d3-force-3d#simulation_alphaDecay) 参数,仅在使用d3模拟引擎时适用. | `0.0228` |
| **d3 速度减速**(\[_数字_) | 节点的取取器/取取取器 [速度衰减](https://github.com/vasturiano/d3-force-3d#simulation_velocityDecay) 模拟介质电阻,只有在使用d3模拟引擎时才适用. | `0.4` |
| **d3 部队**(单位:千美元)_字符串_, \[_fn 时_) | 用于控制d3模拟引擎的内部力量的Getter/Setter. 跟随相同的接口 `d3-force-3d`是因为 [模拟](https://github.com/vasturiano/d3-force-3d#simulation_force)默认情况下包含三种力量: `'link'` (基于 [强制链接](https://github.com/vasturiano/d3-force-3d#forceLink), (中文(简体) ), `'charge'` (基于 [强力MnyBody](https://github.com/vasturiano/d3-force-3d#forceManyBody)和 `'center'` (基于 [强制中心](https://github.com/vasturiano/d3-force-3d#forceCenter)) (中文(简体) ). 这些部队中的每一支都可以被重新配置,或者在系统中加入新的部队. 这种方法只有在使用d3模拟引擎时才适用. |  |
| **d3再热模拟**(a) 与《公约》有关的其他事项 | 通过设置 `alpha` 值为 `1`。只有在使用 d3 模拟引擎时才适用. |  |
| **绘图物理**(\[_对象_) | 根据 ngraph 的自定义物理配置 [配置对象](https://github.com/anvaka/ngraph.forcelayout#configuring-physics) 语法. 这种方法只有在使用ngraph模拟引擎时才适用. | _负图默认_ |
| **热身图**(\[_单位_) | 在开始渲染前, 点火时, 要将排版引擎周期数调取为干燥运行 . | 0 个 |
| **冷却图**(\[_单位_) | 在停止并冻结布局引擎之前, 需要配置多少个内置框架 . | 无穷 |
| **冷却时间**(\[_数字_) | 在停止并冻结布局引擎之前, 需要多久( ms) 才能完成 . | 15000个 |
| **引擎类型**(单位:千美元)_fn 时_(中文(简体) ) | 在模拟引擎的每一个勾选时引用回调函数 . | \- 说吧 |
| **引擎停止**(单位:千美元)_fn 时_(中文(简体) ) | 当模拟引擎停止并被冻结布局时,引用回调函数. | \- 说吧 |
| **刷新**(a) 与《公约》有关的其他事项 | 重新绘制所有节点/链接. |  |

### 工具

| 方法 | 说明 |
| --- | --- |
| **获取图形框**(\[_节点FilterFn_) | 返回图表中节点的当前边框,格式化为 `{ x: [<num>, <num>], y: [<num>, <num>], z: [<num>, <num>] }`。如果找到节点,返回 `null`。接受定义自定义节点过滤器的可选参数 : `node => <boolean>`,如果要包含节点,则该节点应当返回真实值。 这可用于计算图中一部分的边框. |

### 输入 JSON 语法

```json
{
    "nodes": [ 
        { 
          "id": "id1",
          "name": "name1",
          "val": 1 
        },
        { 
          "id": "id2",
          "name": "name2",
          "val": 10 
        },
        ...
    ],
    "links": [
        {
            "source": "id1",
            "target": "id2"
        },
        ...
    ]
}
```

## 常见问题

### 3d-force-graph-ar 是什么？

AR 中三维力导图的 UI 组件

### 如何安装 3d-force-graph-ar？

在项目目录运行 npm install 3d-force-graph-ar，或使用 pnpm add / yarn add / bun add。

### 3d-force-graph-ar 支持 TypeScript 吗？

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

### 3d-force-graph-ar 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### 3d-force-graph-ar 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=12。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### 3d-force-graph-ar 可以商用吗？

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

### 3d-force-graph-ar 的下载量有多少？

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

### 3d-force-graph-ar 还在维护吗？

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