# 3d-tiles-renderer 中文文档 规范地址：https://npmcn.com/package/3d-tiles-renderer/ 版本：0\.5\.4 npm 元数据更新时间：2026-11-03T08:06:10.174Z 中文译文更新时间：2026-11-05T17:14:38.815Z 软件包许可：Apache-2\.0 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/3d-tiles-renderer 原文对照：https://npmcn.com/package/3d-tiles-renderer/?lang=original 项目主页：https://github.com/NASA-AMMOS/3DTilesRendererJS#readme 源码仓库：https://github.com/NASA-AMMOS/3DTilesRendererJS ## 关键信息（来自 npm 元数据） - 包体积（解压后）：3.8 MB，304 个文件 - 模块格式：ES Module - TypeScript 类型：包内自带 - 运行依赖：3 个 - peer 依赖：react ^18\.3\.1 \|\| ^19\.0\.0，three \>=0\.167\.0，react-dom ^18\.3\.1 \|\| ^19\.0\.0，playcanvas \>=2\.23\.0，@babylonjs/core \>=8\.0\.0，@babylonjs/loaders \>=8\.0\.0，@react-three/fiber ^8\.17\.9 \|\| ^9\.0\.0 - 首次发布：2020-06-09T04:50:56.391Z - 最新版本发布：2026-11-03T08:06:09.991Z - 近 30 天下载量：777059（2026-10-04 至 2026-11-02，npm 官方下载统计） - 已发布版本数：102（近 12 个月 16 个） ## 中文简介 [https://github.com/ Analytical Graphics Inc/3d-tiles/tree/master/特写](https://github.com/AnalyticalGraphicsInc/3d-tiles/tree/master/specification) ## 安装 ```sh npm install 3d-tiles-renderer ``` 也可以使用：`pnpm add 3d-tiles-renderer`、`yarn add 3d-tiles-renderer`、`bun add 3d-tiles-renderer` ## README # 3d-平板电脑 [![npm version](https://img.shields.io/npm/v/3d-tiles-renderer.svg?style=flat-square)](https://www.npmjs.com/package/3d-tiles-renderer) [![build](https://img.shields.io/github/actions/workflow/status/NASA-AMMOS/3DTilesRendererJS/node.js.yml?style=flat-square&label=build&branch=master)](https://github.com/NASA-AMMOS/3DTilesRendererJS/actions) ![](https://npmcn.com/package/3d-tiles-renderer/images/header-mars.png) JavaScript 渲染器执行 [三维平面格式](https://github.com/AnalyticalGraphicsInc/3d-tiles/blob/master/specification/) 用于支持 **3个J**, (中文(简体) ), **巴比伦.js** 财务报告和审定财务报表 **播放 Canvas 游戏**。渲染器除了少数例外,还支持了大部分3D平面规格。 关于现有数据集和生成工具的清单,请参见: [3d 平面资源](https://github.com/CesiumGS/3d-tiles/blob/main/RESOURCES.md) 列表中选择一个选项. 如果一个平面或几何图形没有装入或正确渲染,请提出问题! 需要增加和测试特征的示例数据。 见 [特性 完整的里程碑](https://github.com/NASA-AMMOS/3DTilesRendererJS/milestone/1) 关于哪些特性尚未执行的信息. # 开始 ## 安装 ``` npm install 3d-tiles-renderer --save ``` ## API 密码 | 软件包 | 参考文献 | | --- | --- | | `3d-tiles-renderer/core` | [API 参考](https://npmcn.com/package/3d-tiles-renderer/src/core/renderer/API.md) | | `3d-tiles-renderer/three` | [使用指南](https://npmcn.com/package/3d-tiles-renderer/USAGE.md) • 妇女 [API 参考](https://npmcn.com/package/3d-tiles-renderer/src/three/renderer/API.md) | | `3d-tiles-renderer/babylonjs` | [使用指南](https://npmcn.com/package/3d-tiles-renderer/src/babylonjs/renderer/README.md) • 妇女 [API 参考](https://npmcn.com/package/3d-tiles-renderer/src/babylonjs/renderer/API.md) | | `3d-tiles-renderer/playcanvas` | [使用指南](https://npmcn.com/package/3d-tiles-renderer/src/playcanvas/renderer/README.md) • 妇女 [API 参考](https://npmcn.com/package/3d-tiles-renderer/src/playcanvas/renderer/API.md) | | `3d-tiles-renderer/r3f` | [使用指南](https://npmcn.com/package/3d-tiles-renderer/src/r3f/README.md) • 妇女 [API 参考](https://npmcn.com/package/3d-tiles-renderer/src/r3f/API.md) | ## 插件 | 软件包 | 参考文献 | | --- | --- | | `3d-tiles-renderer/three/plugins` | [插件指南](https://npmcn.com/package/3d-tiles-renderer/src/three/plugins/README.md) • 妇女 [API 参考](https://npmcn.com/package/3d-tiles-renderer/src/three/plugins/API.md) | | `3d-tiles-renderer/babylonjs/plugins` | [插件指南](https://npmcn.com/package/3d-tiles-renderer/src/babylonjs/plugins/README.md) | | `3d-tiles-renderer/core/plugins` | [API 参考](https://npmcn.com/package/3d-tiles-renderer/src/core/plugins/API.md) | # 实例 以下实例使用 **3个J**. 巴比伦.js的演示也可用于 [火星](https://nasa-ammos.github.io/3DTilesRendererJS/babylonjs/mars.html) 财务报告和审定财务报表 [Google 照片现实主义平面](https://nasa-ammos.github.io/3DTilesRendererJS/babylonjs/googleMapsAerial.html)演示 [火星](https://nasa-ammos.github.io/3DTilesRendererJS/playcanvas/index.html)。 。 。 . 见 [3.js 使用指南](https://npmcn.com/package/3d-tiles-renderer/USAGE.md), (中文(简体) ), [巴比伦.js 使用指南](https://npmcn.com/package/3d-tiles-renderer/src/babylonjs/renderer/README.md) 或者说 [播放 Canvas 使用指南](https://npmcn.com/package/3d-tiles-renderer/src/playcanvas/renderer/README.md) 每个引擎的设置细节. | 示例 | 说明 | | --- | --- | | **核心** | | | [丁戈差距火星](https://nasa-ammos.github.io/3DTilesRendererJS/three/mars.html) | 多块牌 | | [厨房下沉](https://nasa-ammos.github.io/3DTilesRendererJS/three/index.html) | 所有选项和特征 | | [VR 频率](https://nasa-ammos.github.io/3DTilesRendererJS/three/vr.html) | 在 VR 中渲染 | | **外部平面提供商** 1个 | | | [铯 三维平面](https://nasa-ammos.github.io/3DTilesRendererJS/three/ionExample.html) | 标准铯 离子平面 | | [Ium离子月球](https://nasa-ammos.github.io/3DTilesRendererJS/three/ionLunar.html) | 月球表面瓦片 | | [激光火星](https://nasa-ammos.github.io/3DTilesRendererJS/three/ionLunar.html?mars) | 火星表面瓷砖 | | [谷歌图片现实主义](https://nasa-ammos.github.io/3DTilesRendererJS/three/googleMapsAerial.html) | Google 照片现实主义平面 | | [谷歌环球网](https://nasa-ammos.github.io/3DTilesRendererJS/three/googleMapsExample.html) | 谷歌环球牌 | | [普拉托岛](https://nasa-ammos.github.io/3DTilesRendererJS/three/plateau.html) | PLATEAU世界地平线上的城市数据 | | **自定义** | | | [自定义材料](https://nasa-ammos.github.io/3DTilesRendererJS/three/customMaterial.html) | 使用自定义材料 | | [屏幕外阴影](https://nasa-ammos.github.io/3DTilesRendererJS/three/offscreenShadows.html) | 屏幕外平面的阴影 | | [纹理叠加](https://nasa-ammos.github.io/3DTilesRendererJS/three/landformSiteOverlay.html) | 其它纹理覆盖 | | **插件** | | | [元数据](https://nasa-ammos.github.io/3DTilesRendererJS/three/metadata.html) | 拼接元数据 | | [淡出过渡](https://nasa-ammos.github.io/3DTilesRendererJS/three/fadingTiles.html) | 平板 LoD 淡出转换 | | [深缩放](https://nasa-ammos.github.io/3DTilesRendererJS/three/deepZoom.html) | 深缩放图像格式 | | [宝树](https://nasa-ammos.github.io/3DTilesRendererJS/three/potree.html) | 花点云格式 | | [TMS / XYZ 电话](https://nasa-ammos.github.io/3DTilesRendererJS/three/mapTiles.html) | TMS, XYZ 地图牌 | | [妇女](https://nasa-ammos.github.io/3DTilesRendererJS/three/wmtsTiles.html) | WMTS 地图牌 | | [妇女](https://nasa-ammos.github.io/3DTilesRendererJS/three/wmsTiles.html) | WMS 地图牌 | | [量化网格](https://nasa-ammos.github.io/3DTilesRendererJS/three/quantMeshOverlays.html) | 以覆盖方式定量网格 | | [装入区域](https://nasa-ammos.github.io/3DTilesRendererJS/three/loadRegion.html) | 正在装入区域卷中的瓷砖 | | [地理通讯社](https://nasa-ammos.github.io/3DTilesRendererJS/three/geojson.html) | GeoJSON 覆盖 | | [向量平面](https://nasa-ammos.github.io/3DTilesRendererJS/three/pmtiles.html) | 映射箱矢量平面和 Protomap平面覆盖 | 1 要求a [谷歌平面 API 密钥](https://developers.google.com/maps/documentation/tile/3d-tiles) 或者说 [铯离子 API 密钥](https://cesium.com/platform/cesium-ion/) # 社区资源 以下是现有的3DTILESRenderJS集成: - [三地空间](https://github.com/takram-design-engineering/three-geospatial): Clouds and Assurity 渲染通过3.js地理空间渲染模块,与3DtilesRenderJS并列. - [MapLibre 指南中的 三维平面](https://maplibre.org/maplibre-gl-js/docs/examples/add-3d-tiles-3d-objects-and-models-using-threejs/): 官方实例显示如何使用同步的 三.js 层来制取 3D 瓦片 . - [吉罗3D](https://gitlab.com/giro3d/giro3d):浏览器中可视化地理空间数据并与之互动的框架,2D,2.5D和3D数据. - [iTown 系统](https://github.com/iTowns/itowns/): 为高效可视化,导航,以及网络上2D和3D地理空间数据的互动而设计的框架. - [三管插件](https://threepipe.org/package/plugin-3d-tiles-renderer.html): 三管渲染框架的插件,融合了3DTILESRenderJS. - [3DBAG 查看器](https://github.com/3DBAG/3dbag-viewer):3DBAG数据集的网络取景器,是荷兰全国所有建筑用屋顶建造的3D模型. - [巴比伦.js指南](https://doc.babylonjs.com/features/featuresDeepDive/geospatial/loading3dTiles/):关于将3DTILESRenderJS纳入你的巴比伦.js项目的官方文献. - [社区插件](https://github.com/NASA-AMMOS/3DTilesRendererJS/tree/master/src/three/plugins#community-plugins): 为 3DTILESRenderJS 添加社区维护的三J插件. # 抓到他们了 一些要注意的配置渲染器时的行为: - **缓存限制为硬盖.** 一次没有新瓷砖加载 `LRUCache` 达到 `maxSize` 或者说 `maxBytesSize`。如果当前视图所需的瓦片不合适,则显示相近的瓦片并停止改进。 监视器 `lruCache.cachedBytes` 财务报告和审定财务报表 `lruCache.isFull()` 提高 `maxBytesSize` 或者说 `errorTarget` 当一个视图需要更多细节而不是适合. # 自由主义 软件可在 [Apache V2.0 许可证](https://npmcn.com/package/3d-tiles-renderer/LICENSE)。 。 。 . 版权:"2020 California Institute". 所有权利 保留下来了 美国政府赞助确认. 无论是加州理工学院的名称还是它的运营部门 喷气推进实验室,或其贡献者的姓名可能为: 用于认可或推广来自该软件的产品 未经事先具体书面许可. ## 常见问题 ### 3d-tiles-renderer 是什么？ https://github\.com/ Analytical Graphics Inc/3d-tiles/tree/master/特写 ### 如何安装 3d-tiles-renderer？ 在项目目录运行 npm install 3d-tiles-renderer，或使用 pnpm add / yarn add / bun add。 ### 3d-tiles-renderer 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### 3d-tiles-renderer 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### 3d-tiles-renderer 可以商用吗？ 3d-tiles-renderer 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。 ### 3d-tiles-renderer 的下载量有多少？ 根据 npm 官方下载统计，3d-tiles-renderer 在 2026/10/04 – 2026/11/02 这 30 天内被下载 777,059 次，日均约 25,902 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### 3d-tiles-renderer 还在维护吗？ 最新版本 0\.5\.4 发布于 2026/11/03（2 天前）；至今共发布 102 个版本，其中过去 12 个月发布了 16 个；首次发布于 2020/06/09。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。