3DsWorks 帮助文档
3DsWorks 帮助 › 欢迎使用 3DsWorks

欢迎使用 3DsWorks 9.0

适用版本 9.0 CS 架构 更新于 2026/11/16

3DsWorks 是一款面向非程序人员的交互式 3D 内容制作工具:商务人员可以用它制作 3D 版演示文稿,市场人员可以快速生成营销互动内容,工程师可以把 3D CAD 文件直接变成可交互的数字孪生场景。

产品介绍

3DsWorks 由来自全球 8 个国家及地区的 30 多名开发者历经 6 年打造,目标是创造一个极其简单的 3D 互动内容创作工具,让创作者可以快速开发出满足场景需要的 3D 交互内容,例如元宇宙、数字孪生、大屏展示,甚至是 FakeUI。

3DsWorks 在好莱坞电影特效(FakeUI)、航空航天、轨道交通、数字城市、数字星球以及自动化领域都有丰富的应用案例。

3DsWorks 现阶段为 CS 架构 解决方案,暂不支持 BS 架构。BS 版本的支持计划将在后续版本中提供。

团队与版权

3DsWorks 是一个去中心化的研发团队,项目采用了多个国家的技术,其中既涉及中国技术,也包含美国技术。3DsWorks 团队是虚拟团队,不存在于任何物理世界中的任何国家。

我们在全球各地设有当地经销商,由经销商按照当地法律开展市场活动并开具当地发票,因此 3DsWorks 不受各国高科技出口管制影响。

版权所有 © 2013–2026 3DsWorks。

如何使用本手册

本手册按使用者的工作流程组织,建议按下列顺序阅读:

  1. 入门 —— 熟悉文件导入、资源导入、模型引用与材质编辑等基本操作。
  2. 低代码组件说明 —— 通过内置的低代码交互完成相机、网页、场景的切换。
  3. 组件参考(无代码) —— 按分类查阅 29 个组件的载体、参数与功能说明。
  4. API 参考 —— 前端页面(H5)与孪生端之间的双向通信接口。
  5. 云渲染与配置文件 —— 部署、启动与全局配置。

左侧目录可折叠;顶栏搜索框支持按组件名、函数名、配置项快速定位(快捷键 /)。文中截图可点击放大,按 Esc 关闭。


基本操作

入门 文件导入 · 资源导入 · 材质编辑

文件导入

通过 菜单 › 文件 › 导入 将本地模型文件导入当前工程。

菜单-文件导入
图 1 菜单 › 文件 › 导入

支持的文件类型:Obj、3ds、fbx、stl、gltf、glb、ply、3mf、zip。

资源导入

通过 菜单 › 资源 导入软件内置的资源文件。

菜单-资源导入
图 2 菜单 › 资源 › 导入内置资源

文件引用到场景

导入模型后,需要先制作模型引用库,才能对模型进行材质编辑;否则只能预览模型效果,无法编辑材质。引用库中可以新建文件夹进行归类。

菜单-文件引用到场景
图 3 菜单 › 文件引用到场景

特效资源导入

支持导入火焰、雾气、天气、特效、电、水等资源。

菜单-特效资源导入
图 4 菜单 › 资源 › 特效资源

材质编辑

双击对象可获取材质名称,然后用鼠标选择材质颜色进行编辑,也可以编辑材质的其他参数。

菜单-材质编辑
图 5 材质编辑面板

模型导入说明

入门 支持格式与已知限制

支持的模型格式

格式说明
FBX接受 7.0 以上版本。强烈推荐 FBX,支持得最完善。
OBJ通用静态模型格式。
GLTF 2接受使用实验性功能的 Draco 解压。
STL常用于 3D 打印与 CAD 导出。
PLY多边形网格格式。
3MF3D 制造格式。
ZIP打包的模型资源。

纹理格式

  • BMP
  • GIF
  • JPG
  • PNG
  • PSD
  • TGA
  • HDR(仅用于加载天空盒,不建议作为普通纹理使用)

已知问题 / 局限性

  • FBX 导入器还不能导入多个纹理层。
  • 一些 FBX 文件可能会出现不兼容的情况,例如部分 FBX 多边形可能有镶嵌问题。
  • 目前还不支持 3MF 光束网格格式。
  • 目前还不支持 3MF PBR Specular 材质。
  • 目前还不能导入混合形状的法线和切线。

导入前建议先在建模软件中检查法线朝向与单位比例,可减少 FBX 导入后的镶嵌与材质异常。


低代码组件说明

低代码 无需编写代码的常用交互

低代码组件用于在不编写脚本的情况下完成最常见的交互:切换相机、切换网页、切换场景、对象激活与禁用、关闭软件。下列各节按组件逐一说明操作步骤。

切换相机

低代码交互示例:通过按钮或事件在多个相机视角之间切换。

切换相机 步骤一
图 6 低代码 › 切换相机
切换相机 步骤二
图 7 配置相机组与视角编号
切换相机 步骤三
图 8 绑定触发对象
切换相机 步骤四
图 9 运行时效果
切换相机 步骤五
图 10 切换结果

切换网页

切换网页 入口
图 11 低代码 › 切换网页
切换网页 步骤一
图 12 配置网页地址
切换网页 步骤二
图 13 绑定按钮
切换网页 步骤三
图 14 运行时页面
切换网页 步骤四
图 15 切换后的页面

切换场景

切换场景 入口
图 16 低代码 › 切换场景
切换场景 步骤一
图 17 选择目标场景
切换场景 步骤二
图 18 配置场景路径
切换场景 步骤三
图 19 运行时切换结果

对象激活与禁用

对象激活与禁用 入口
图 20 低代码 › 对象激活与禁用
对象激活与禁用 步骤一
图 21 选择对象组
对象激活与禁用 步骤二
图 22 设置激活 / 禁用动作
对象激活与禁用 步骤三
图 23 运行时效果

关闭软件

关闭软件 配置
图 24 低代码 › 关闭软件
关闭软件 运行时
图 25 运行时关闭确认

组件参考(无代码)

组件 共 29 个组件 · 4 个分类

3DsWorks 的组件以“检视器(Inspector)”中的属性面板形式提供。每个组件都说明了它的载体(可挂载的对象类型)、参数(可在面板中设置的项目)与功能,并给出模糊搜索时使用的关键字。

在检视器中点击“添加组件”,输入组件的中文名或英文类名即可模糊搜索到该组件。同一对象上,对象预警(网页)、对象预警仿真、对象高亮、对象鼠标事件管理 四个组件只能同时存在一个。

组件速查

组件载体一句话说明
场景必需组件
加载网页主页对象运行时加载指定网页,全局唯一。
相机控制器主相机运行时位移、旋转、缩放相机。
基础功能组件
广告牌任意 3D 对象使对象始终朝向主相机。
加载图片图片组件按 URL 显示图片。
对象高亮带碰撞器的 3D 对象高亮对象外轮廓或整体。
2D 画布画布将 3D 界面转换为 2D 界面。
切换相机位(3D)带碰撞器的 3D 对象点击 3D 对象切换相机视角。
切换相机位(2D)按钮点击按钮切换相机视角。
切换网页(2D 界面)按钮点击按钮切换网页 URL。
切换网页(3D)带碰撞器的 3D 对象点击 3D 对象切换网页 URL。
视频播放器(2D)UI 元素在 2D / 3D 画布下播放视频。
视频播放器(3D)任意 3D 对象在 3D 对象表面播放视频。
视频播放器(融合)任意 3D 对象支持自定义拉伸网格形状的视频播放。
加载场景(3D)带碰撞器的 3D 对象点击 3D 对象加载场景。
加载场景(2D 界面)按钮点击按钮加载场景。
对象预警仿真3D 对象运行时闪烁预警。
对象组激活禁用任意对象激活 / 禁用指定对象组。
相机漫游任意对象(作用于主相机)沿路径漫游并注视目标。
第一人称角色控制器预制件WASD 第一人称行走。
对象鼠标事件管理带碰撞器与网格渲染器的 3D 对象鼠标进入 / 离开 / 单击 / 双击响应。
前端 & 3D 交互组件
对象颜色设置(网页)带网格渲染器的 3D 对象前端调用 changeColor 改色。
对象坐标动画设置(网页)3D 对象前端调用 tweenObj 控制补间动画。
传递数据到网页(网页)带碰撞器的 3D 对象点击对象把数据发给网页。
传递对象屏幕坐标到网页(网页)带碰撞器的 3D 对象鼠标停留时发送屏幕坐标。
对象预警(网页)3D 对象前端调用 objAlarm 开关预警。
电梯管理(网页)UI 元素按楼层实例化电梯并控制去向。
中控组件
一键顺控连接器场景(唯一)连接中控服务器。
一键顺控(3D)带碰撞器的 3D 对象点击对象批量执行指令。
一键顺控(2D)按钮点击按钮批量执行指令。

场景必需组件

以下两个组件在每个场景中有且仅有一个,已存在于现有场景中,通常无需手动添加。

加载网页

LoadWeb
载体主页对象
参数
  • 网页 URL 地址:要加载的页面地址。
  • 网页刷新间隔:单位秒;设置为 0 则不刷新。
功能运行时加载指定网页。全局有且仅能有一个。
URL 类型
  • http:// 或 https:// 开头的远程页面;
  • file:// 开头的本地页面。
加载网页组件参数
检视器中的“加载网页”组件

相机控制器

CameraController
载体主相机
参数位移速度、滚轮缩放速度、缩放最大距离、缩放最小距离、旋转灵敏度(见下图)。
功能运行时操作相机位移、旋转、缩放等基础功能。全局有且仅能有一个。
前端控制可通过 enableCameraController() 激活或禁用相机控制器。
相机控制器组件参数
检视器中的“相机控制器”组件

相机操作

  • 键盘可通过 WASD / QE 移动;
  • Alt + 鼠标左键,或按住鼠标右键,可 360° 查看场景;
  • Alt + 鼠标右键拖动可放大缩小视角;
  • 按住 F 能够聚焦对象;
  • 按住鼠标中键能够上下左右拖拽相机;
  • 滚动鼠标滚轮能够拉近、缩远。

基础功能组件

广告牌

Billboard
载体任意 3D 对象
参数是否翻转 180 度。
功能运行时使对象始终朝向主相机。
检索关键字Billboard 或 广告牌
广告牌组件参数
检视器中的“广告牌”组件

加载图片

LoadImage
载体图片组件
参数图片 URL 地址。
功能运行时根据对应的 URL 显示图片,也可以通过网页交互进行设置。
检索关键字LoadImage 或 加载图片
加载图片组件参数
检视器中的“加载图片”组件

对象高亮

HighLightObj
载体任意带碰撞器的 3D 对象
参数
  • 鼠标事件:需挂载碰撞器。激活后,鼠标移入、移出对象时自动触发高亮;如需通过代码控制,建议禁用此项。
  • 设置外轮廓:是否激活外轮廓高亮,默认激活。
  • 设置整体:是否激活对象整体高亮,默认激活。
  • 外轮廓颜色:“设置外轮廓”禁用时不起作用。
  • 整体颜色:“设置整体”禁用时不起作用。
功能高亮 3D 对象及其所有子对象,可通过鼠标或代码控制。
相关 APIhighlightObjOutlineColor()、highlightObjOverlayColor()、clearObjHighlight()。
检索关键字HighLightObj 或 对象高亮
对象高亮组件参数
检视器中的“对象高亮”组件

highlightObjOutlineColor 的 highQuality 选项:硬件配置较高时开启后高亮效果更好,并可设置透明度,但同时会增加性能开销。硬件配置较低时建议不要开启,否则可能出现高亮显示错乱。

同一个对象上,对象预警(网页)、对象预警仿真、对象高亮、对象鼠标事件管理组件只能同时存在一个。

2D 画布

Canvas2D
载体画布
参数画布层级,默认 3。存在多个 2D 画布时,层级越高渲染越优先。
功能2D 界面必需组件,可使默认的 3D 界面在运行时转化为 2D 界面。
快捷生成工具栏 › 对象 › UI › 2D 画布
检索关键字Canvas2D 或 2D画布
2D 画布组件参数
检视器中的“2D 画布”组件

切换相机位(3D)

CameraMove3DClick
载体任意带碰撞器的 3D 对象
参数相机组名称、相机视角编号。
功能运行时点击 3D 对象,主相机切换到指定视角。
检索关键字CameraMove3DClick 或 切换相机位(3D)
切换相机位(3D)组件参数
检视器中的“切换相机位(3D)”组件

切换相机位(2D)

CameraMove2DClick
载体按钮
参数相机组名称、相机视角编号。
功能运行时点击按钮,主相机切换到指定视角。
快捷生成工具栏 › 对象 › UI › 按钮(切换相机)
检索关键字CameraMove2DClick 或 切换相机位(2D)
切换相机位(2D)组件参数
检视器中的“切换相机位(2D)”组件

切换网页(2D 界面)

SwitchBrowser
载体按钮
参数网页 URL 地址。
功能(2D 界面)运行时点击按钮切换网页 URL。
快捷生成工具栏 › 对象 › UI › 按钮(切换网页)
检索关键字SwitchBrowser 或 切换网页(2D)
切换网页(2D)组件参数
检视器中的“切换网页(2D 界面)”组件

切换网页(3D)

SwitchBrowser3DClick
载体任意带碰撞器的 3D 对象
参数网页 URL 地址。
功能运行时点击 3D 对象切换网页 URL。
检索关键字SwitchBrowser3DClick 或 切换网页(3D)
切换网页(3D)组件参数
检视器中的“切换网页(3D)”组件

视频播放器(2D)

VideoPlayer2D
说明UI 元素,需放置在 2D / 3D 画布下。
参数是否运行时自动播放;视频地址(支持 http、rtsp 格式)。
功能播放视频(运行时自动播放,或注册到按钮事件手动播放 / 停止)。
快捷生成工具栏 › 对象 › UI › 视频播放器(2D)
检索关键字VideoPlayer2D 或 视频播放器(2D)
视频播放器(2D)组件参数
检视器中的“视频播放器(2D)”组件

视频播放器(3D)

VideoPlayer3D
载体任意 3D 对象
参数
  • 运行时播放:运行时是否自动播放。如通过按钮注册事件函数,需取消此选项。
  • 视频地址:支持 http、rtsp 格式。
  • 是否循环:选择是则循环播放,对象永远不会被禁用,“禁用延迟时间”将不再起作用。
  • 是否静音。
  • 运行时激活:运行一开始是否激活组件对象;如勾选了“运行时播放”,此属性不起作用。
  • 延迟时间(秒):延迟多少秒后开始激活对象并播放视频。
  • 禁用延迟时间(秒):默认 0,即视频播放完成后自动禁用;大于 0 时播放 N 秒后自动禁用对象;循环播放时此属性不起作用。
功能3D 对象视频播放。
按钮函数Play() 播放;Pause() 暂停;Stop() 中止。
快捷生成工具栏 › 对象 › 3D 对象 › 视频播放器(3D)
检索关键字VideoPlayer3D 或 视频播放器(3D)
视频播放器(3D)组件参数
检视器中的“视频播放器(3D)”组件

视频播放器(融合)

VideoPlayerFusion
载体任意 3D 对象
参数 与“视频播放器(3D)”相同,另有:
  • 播放 / 停止(编辑器):在编辑器环境下预览播放 / 停止。
  • 打开自定义建模工具:快捷打开自定义建模工具,也可通过“窗口 › 自定义建模工具”打开。
功能派生自视频播放器(3D),在 3D 对象上播放视频,同时支持自定义拉伸网格形状,需配合自定义建模工具使用。
按钮函数Play() 播放;Pause() 暂停;Stop() 中止。
快捷生成工具栏 › 对象 › 3D 对象 › 视频播放器(融合)
检索关键字VideoPlayerFusion 或 视频播放器(融合)
视频播放器(融合)组件参数
检视器中的“视频播放器(融合)”组件

加载场景(3D)

LoadScene3DClick
载体任意带碰撞器的 3D 对象
参数场景路径。
功能运行时点击 3D 对象加载指定场景。
路径说明需提供工程目录中的完整路径,以 Asset 文件夹为根目录;也可在磁盘目录中查找(推荐),详见 关于场景路径。
检索关键字LoadScene3DClick 或 加载场景(3D)
加载场景(3D)组件参数
检视器中的“加载场景(3D)”组件

加载场景(2D 界面)

LoadScene
载体按钮
参数场景路径。
功能(2D 界面)运行时点击按钮加载指定场景。
快捷生成工具栏 › 对象 › UI › 按钮(加载场景)
检索关键字LoadScene 或 加载场景(2D)
加载场景(2D)组件参数
检视器中的“加载场景(2D 界面)”组件

对象预警仿真

ObjAlarmSimulation
载体3D 对象
参数
  • 仿真持续时间(秒,0 代表无限时长);
  • 延迟时间(秒):延迟多少秒后开始仿真;
  • 预警时对象显示的颜色;
  • 预警时对象闪烁速度:值越大闪烁频率越快。
功能运行时对对象进行仿真预警。
检索关键字ObjAlarmSimulation 或 对象预警仿真
对象预警仿真组件参数
检视器中的“对象预警仿真”组件

同一个对象上,对象预警(网页)、对象预警仿真、对象高亮、对象鼠标事件管理组件只能同时存在一个。

对象组激活禁用

ObjsAbleCtrl
载体任意对象
参数
  • 运行时自动执行:选择是则运行时自动激活 / 禁用指定对象组;如通过按钮注册事件,必须取消此选项。
  • 延迟时间(秒):延迟多少秒后开始执行。
  • 需激活的对象组。
  • 需禁用的对象组。
功能运行时激活 / 禁用指定的对象组。
快捷生成工具栏 › 对象 › UI › 按钮(对象组激活禁用)
检索关键字ObjsAbleCtrl 或 对象组激活禁用
对象组激活禁用组件参数
检视器中的“对象组激活禁用”组件

相机漫游

CameraAutoRoaming
载体可挂载于任意对象,但实际指向的是主相机对象。
参数
  • 路径组:相机漫游时经过的路径数组。
  • 观察中心:漫游过程中始终注视的位置。如为空,则始终注视路径点的正前方。
  • 持续总时长(秒):漫游的总时长。
  • 延迟时间(秒):延迟多少秒后开始漫游。
  • 循环次数:设置为 -1 代表无限循环。
  • 运行时自动漫游:如勾选则运行时自动开始;如通过按钮注册事件函数,必须取消此选项。
按钮函数Play() 播放;Pause() 暂停;Stop() 中止并回到第一个路径点;Restart() 重新播放。
检索关键字CameraAutoRoaming 或 相机漫游
相机漫游组件参数
检视器中的“相机漫游”组件

漫游过程中如进行相机控制器的移动、旋转、拖动、拉近缩远、放大缩小视角等操作,会立即中止漫游并回到第一个路径点。

第一人称角色控制器

FirstPersonController
载体预制件
参数
  • 步行速度:WASD 移动;
  • 奔跑速度:Shift + WASD 奔跑;
  • 视角旋转速度:长按鼠标右键旋转;
  • 跳跃高度:Space 跳跃。
生成方式工具栏 › 对象 › 3D 对象 › 第一人称控制器预制件。单独添加此组件会报错、不起作用。
功能第一人称角色控制器。
第一人称角色控制器
第一人称角色控制器预制件

运行时使用第一人称控制器时,以下受主相机影响的功能将失效:相机控制器、切换相机位(3D)、切换相机位(2D)、相机漫游,以及 3DsWorks.js 中的 enableCameraController() 与 cameraMove()。删除或禁用第一人称控制器后恢复。

对象鼠标事件管理

ObjMouseEventMgr
载体任意带碰撞器、网格渲染器的 3D 对象
参数
  • 鼠标进入放大比例:指针进入对象时的放大比例;
  • 鼠标进入高亮颜色:指针进入对象时的边框高亮颜色;
  • 鼠标进入消息:指针进入对象时发送给网页的消息(建议粘贴 JSON);
  • 鼠标离开消息:指针离开对象时发送给网页的消息;
  • 鼠标单击高亮颜色 / 鼠标单击消息;
  • 鼠标双击高亮颜色 / 鼠标双击消息。
检索关键字ObjMouseEventMgr 或 对象鼠标事件管理
对象鼠标事件管理组件参数
检视器中的“对象鼠标事件管理”组件

同一个对象上,对象预警(网页)、对象预警仿真、对象高亮、对象鼠标事件管理组件只能同时存在一个。消息内容推荐使用 JSON 字符串,便于网页端解析。

前端 & 3D 交互组件

这一组组件不直接响应鼠标,而是为网页(H5)提供操作 3D 场景的接口。配合 JavaScript API 使用。

对象颜色设置(网页)

ObjChangeColorLabel
载体任意带网格渲染器的 3D 对象
功能前端通过 changeColor 方法改变 3D 场景中的对象颜色。
检索关键字ObjChangeColorLabel 或 对象颜色设置(网页)
对象颜色设置组件参数
检视器中的“对象颜色设置(网页)”组件

对象坐标动画设置(网页)

TransformTweenLabel
载体3D 对象
功能前端通过 tweenObj 方法控制 3D 对象的位移、旋转、缩放动画。
检索关键字TransformTweenLabel 或 对象坐标动画设置(网页)
对象坐标动画设置组件参数
检视器中的“对象坐标动画设置(网页)”组件

传递数据到网页(网页)

SendInfoToH5
载体任意带碰撞器的 3D 对象
功能运行时点击 3D 对象,把此对象的数据(名称、世界坐标、视口坐标)发送给网页;网页通过 sendObjInfo 类型接收。具体说明参考 3DsWorks.js。
检索关键字SendInfoToH5 或 传递数据到网页(网页)
传递数据到网页组件参数
检视器中的“传递数据到网页(网页)”组件

传递对象屏幕坐标到网页(网页)

MouseStaySendObjScreenCoord
载体任意带碰撞器的 3D 对象
功能运行时鼠标停留在 3D 对象上,把此对象的屏幕坐标数据发送给网页;网页通过 sendObjScreenCoord_MouseStay 类型接收。
检索关键字MouseStaySendObjScreenCoord 或 传递对象屏幕坐标到网页(网页)
传递对象屏幕坐标组件参数
检视器中的“传递对象屏幕坐标到网页(网页)”组件

对象预警(网页)

AlarmObj
载体3D 对象
参数预警时对象显示的颜色;闪烁速度(值越大闪烁频率越快)。
功能前端通过 objAlarm 方法控制指定对象的高亮预警开启 / 关闭效果。
检索关键字AlarmObj 或 对象预警(网页)
对象预警(网页)组件参数
检视器中的“对象预警(网页)”组件

同一个对象上,对象预警(网页)、对象预警仿真、对象高亮、对象鼠标事件管理组件只能同时存在一个。

电梯管理(网页)

Elevator
说明UI 元素,需放置在 2D / 3D 画布下。
参数电梯最低楼层、最高楼层。
功能运行时根据参数实例化成相应楼层的电梯实例;网页通过 goToFloor() 控制前往电梯的楼层数。
快捷生成工具栏 › 对象 › UI › 电梯
电梯管理组件参数
检视器中的“电梯管理(网页)”组件

中控组件

中控组件用于与中控服务器通信,按指令集批量控制设备。

一键顺控连接器

ReverseCtrlConnector
参数IP、端口。
功能
  • 使用中控组件必须持有的基本组件,每个场景有且仅有一个;
  • 运行前必须连接好设备,才能进行一键顺控对设备发指令操作;
  • 如需连接其他服务器,点击“断开”后输入其他 IP、端口,再点击“连接”。
生成方式工具栏 › 工具 › 物联 › 创建一键顺控连接器。不建议通过添加组件的方式创建。
一键顺控连接器组件参数
检视器中的“一键顺控连接器”组件

每次加载场景时,一键顺控连接器会自动初始化为断开状态。

一键顺控(3D)

DeviceReverseCtrl3D
载体任意带碰撞器的 3D 对象
参数指令集。
功能运行时点击 3D 对象,批量执行指令集中的指令(需一键顺控连接器已连接)。
检索关键字DeviceReverseCtrl3D 或 一键顺控(3D)
一键顺控(3D)组件参数
检视器中的“一键顺控(3D)”组件

一键顺控(2D)

DeviceReverseCtrl2D
载体按钮
参数指令集。
功能按钮需注册组件中的 Execute 方法,在运行时点击按钮批量执行指令集中的指令。
快捷生成工具栏 › 对象 › UI › 按钮(一键顺控)
检索关键字DeviceReverseCtrl2D 或 一键顺控(2D)
一键顺控(2D)组件参数
检视器中的“一键顺控(2D)”组件

关于场景路径

场景路径需提供在工程目录中的完整路径,以 Asset 文件夹为根目录;也可以在磁盘目录中查找(推荐),以 \3DsWorks_Data\StreamingAssets\DefaultProject\Assets 为根目录。场景文件为 .rtscene 后缀,取场景名称即可。

示例 1

场景路径示例一
场景文件位于 Assets 根目录

场景路径则为:test1

示例 2

场景路径示例二
场景文件位于 Scenes 目录

场景路径则为:Scenes/test2

示例 3

场景路径示例三
场景文件位于多级子目录

场景路径则为:Scenes/Main/test3


API 调用示例

API HTML 页面调用 3DsWorks 接口

下表演示了在网页(H5)中通过按钮调用 3DsWorks API 的写法,以及对应的工具侧组件配置。所有函数都需要在 3DsWorks 内嵌浏览器中运行。

API 功能调用代码工具配置
相机切换
<button onclick="cameraMove('相机组1',1)">相机组1-视角1</button>
相机切换配置
修改物体颜色
<button onclick="changeColor('方块1',0,255,0,255)">方块1绿色化</button>
<button onclick="changeColor('方块1',255,255,0,125)">方块1黄色透明化</button>
修改物体颜色配置
3D 标签
<button onclick="handle3DLabel('3D标签1','value1','http:\\browser9.qhimg.com/bdm/640_395_0/t01164a798a68fbf958.jpg')">3D标签设置</button>
<button onclick="handle3DTextLabel('3D文本标签1','value2')">3D文本标签设置</button>
<button onclick="handle3DImageLabel('3D图片标签1','http:\\browser9.qhimg.com/bdm/640_395_0/t019fd908f724f51900.jpg')">3D图片标签设置</button>
—
加载场景
<button onclick="loadScene('Scenes/test1')">加载test1场景</button>
—
物体动画
<button onclick="tweenObj('Meta','位置',0,0,-5,2)">Meta在2秒内移动到(0,0,-5)处</button>
<button onclick="tweenObj('Meta','旋转',0,180,0,1)">Meta在1秒内旋转180度</button>
<button onclick="tweenObj('Meta','比例',2,2,2,3)">Meta在3秒内比例变为2</button>
—
物体预警
<button onclick="objAlarm('Meta',true)">Meta开启对象高亮预警</button>
<button onclick="objAlarm('Meta',false)">Meta关闭对象高亮预警</button>
物体预警配置
对象显示隐藏
<button onclick="objActiveCtrl('Fire01',true)">激活火焰Fire01</button>
<button onclick="objActiveCtrl('Fire01',false)">关闭火焰Fire01</button>
<button onclick="objActiveCtrl('Meta',true)">激活Meta</button>
<button onclick="objActiveCtrl('Meta',false)">关闭Meta</button>
—
电梯
<button onclick="goToFloor('电梯1',2)">去往电梯1的2楼</button>
<button onclick="goToFloor('电梯1',5)">去往电梯1的5楼</button>
—

示例中的对象名称(如 Meta、方块1、电梯1)需与场景层次结构中的名称一致。


3DsWorks.js JavaScript API 参考

API H5 ↔ 孪生端 双向通信

3DsWorks.js 提供了前端页面(H5)与孪生端之间双向通信的能力,分为两个方向:

  • H5 → 孪生端:通过 H5ToTwin 对象调用,向后端发送指令;
  • 孪生端 → H5:通过 TwinToH5 注册消息监听器,接收孪生端推送的数据。

H5 页面需运行在 3DsWorks 内嵌的浏览器组件中。页面加载完成后请先调用 TwinToH5.addMessageListener() 注册监听,再调用 H5ToTwin 的相关方法。

H5 → 孪生端(H5ToTwin)

方法一览:

函数参数说明
enableCameraController(enable)Boolean enable:是否激活是否激活相机控制器(第一人称控制器启用时无效)。
block3DRayCaster(block)Boolean block:是否阻塞是否阻塞 3D 对象射线。默认 false,射线会穿透 2D 和 3D,两者都可交互;设置为 true 将屏蔽 3D 对象交互、保留 2D 交互。此函数仅控制 2D 与 3D 的射线是否穿透,相机控制器不受影响;如需屏蔽相机交互,请调用 enableCameraController。
openURL(url)String url:目标网址调用浏览器打开目标网址(适用于打开外部链接、下载文件)。
cameraMove(name, num, duration)String name:相机组名称;Number num:视角编号;Number duration:可选,动画时间,默认 0.5s切换相机组视角(第一人称控制器启用时无效)。推荐使用默认动画时间。
changeColor(name, r, g, b, a)String name:对象名称;Number r/g/b/a:0–255设置 3D 对象材质颜色(目前只支持标准材质)。
highlightObjOutlineColor(name, r, g, b, width)String name:对象名称;Number r/g/b:0–255;Number width:外轮廓宽度,默认 0.5高亮目标 3D 对象并设置其外轮廓(边框)颜色。注:1、需挂载“对象高亮”组件,确保激活“设置外轮廓”字段、禁用“鼠标事件”字段;2、仅高亮设备外边框,如需高亮对象整体,请使用 highlightObjOverlayColor()。
highlightObjOverlayColor(name, r, g, b, isFlashing)String name:对象名称;Number r/g/b:0–255;Boolean isFlashing:是否闪烁,默认 true高亮目标 3D 对象并设置其整体颜色。注:需挂载“对象高亮”组件,确保激活“设置整体”字段、禁用“鼠标事件”字段;仅高亮设备整体,如需高亮外轮廓(边框),请使用 highlightObjOutlineColor()。
clearObjHighlight(name)String name:对象名称清除目标 3D 对象高亮状态。需挂载“对象高亮”组件,确保禁用“鼠标事件”字段。
handle3DLabel(name, title, url)String name:标签名称;String title:标题;String url:图片地址操作 3D 标签。
handle3DTextLabel(name, title)String name:3D 文本标签名称;String title:标题操作 3D 文本标签。
handle3DImageLabel(name, url)String name:3D 图片标签名称;String url:图片地址操作 3D 图片标签。
tweenObj(name, animationType, x, y, z, duration)String name:对象名称;String animationType:位置、旋转、比例;Number x/y/z:目标值;Number duration:持续时长控制 3D 对象坐标动画,支持位置、旋转、比例三种补间动画,x/y/z 对应所选类型的对象位置/旋转/比例目标值。
loadScene(path)String path:场景路径加载 3D 场景。场景路径写法参考“加载场景(3D)”组件说明。
objAlarm(name, isAlarm)String name:对象名称;Boolean isAlarm:是否预警对象预警(高亮闪烁),控制 3D 对象开启/关闭预警。
objActiveCtrl(name, isOpen)String name:对象名称;Boolean isOpen:true 开启,false 关闭对象显示/隐藏控制(适用于 3D 对象、粒子、水等)。
goToFloor(name, targetFloor)String name:电梯对象名称;Number targetFloor:目标楼层控制电梯楼层。注意不能小于最低楼层、不能大于最高楼层。
getPostProcessProfiles()无获取后期预设列表。通过 sendPostProcessProfiles 监听结果。
getSkyBoxs()无获取天空盒列表。通过 sendSkyBoxs 监听结果。
setPostProcessProfile(name)String name:后期预设名称设置指定后期预设。名称可通过“顶部工具栏 › 编辑 › 设置”或 getPostProcessProfiles() 获取。
setSkyBox(name)String name:天空盒名称设置指定天空盒。名称可通过“顶部工具栏 › 编辑 › 设置”或 getSkyBoxs() 获取。
resetFirstCharacterTransform()无重置第一人称角色控制器到初始位置。注:1、如未找到第一人称角色控制器则无效果;2、初始位置为编辑器中指定的最后位置。

孪生端 → H5(TwinToH5)

API 消息监听

孪生端主动推送给网页的消息通过 type 字段区分,网页在 handleMessage 中按 type 处理。目前已支持的消息类型如下:

type 类型说明
sendObjInfo点击对象后返回该对象的数据(名称、世界坐标、视口坐标),由“传递数据到网页(网页)”组件触发。
sendPostProcessProfiles返回后期预设列表,由 getPostProcessProfiles() 触发。
sendSkyBoxs返回天空盒列表,由 getSkyBoxs() 触发。
sendObjScreenCoord_MouseStay返回鼠标停留对象的屏幕坐标数据,由“传递对象屏幕坐标到网页(网页)”组件触发。

监听器的注册与移除:TwinToH5.addMessageListener() / TwinToH5.removeMessageListener()。收到的事件数据为字符串,需先用 JSON.parse 解析。


完整源码与调用示例

API 可直接复制到项目中使用

将下列两段源码保存为 3DsWorks.js 并在页面中引入,即可使用 H5ToTwin 与 TwinToH5。

H5ToTwin 完整源码
<!-- H5 -> 孪生端 -->
var H5ToTwin = (function () {

    /**
     * 是否激活相机控制器
     *(第一人称控制器启用时无效)
     * @param {Boolean} enable   是否激活
     * @return {void}
     */
    function enableCameraController(enable) {
        window.vuplex.postMessage({type: 'enableCameraController', enable: enable});
    }

    /**
     * 是否阻塞 3D 对象射线。
     * 注:
     * 1、默认 false,射线会穿透 2D 和 3D,两者都可交互。如设置为 true,将屏蔽 3D 对象交互,保留 2D 交互;
     * 2、此函数仅控制 2D 和 3D 的射线是否穿透,相机控制器不受影响。如需屏蔽相机交互,调用 enableCameraController
     * @param {Boolean} block   是否阻塞
     * @return {void}
     */
    function block3DRayCaster(block) {
        window.vuplex.postMessage({type: 'block3DRayCaster', block: block});
    }

    /**
     * 调用浏览器打开目标网址(适用于打开外部链接,下载文件)
     * @param {String} url   目标网址
     * @return {void}
     */
    function openURL(url) {
        window.vuplex.postMessage({type: 'openURL', url: url});
    }

    /**
     * 切换相机组视角
     *(第一人称控制器启用时无效)
     * @param {String} name   相机组名称
     * @param {Number} num   相机视角编号
     * @param {Number} duration   可选。动画时间,默认0.5s。推荐使用默认时间。
     * @return {void}
     */
    function cameraMove(name, num, duration) {
        if (!duration) {
            duration = 0.5;
        }
        window.vuplex.postMessage({type: 'cameraMove', name: name, num: num, duration: duration});
    }

    /**
     * 设置 3D 对象材质颜色(目前只支持标准材质)
     * @param {String} name   对象名称
     * @param {Number} r Red 0-255
     * @param {Number} g Green 0-255
     * @param {Number} b Blue 0-255
     * @param {Number} a Alpha 0-255
     * @return {void}
     */
    function changeColor(name, r, g, b, a) {
        window.vuplex.postMessage({type: 'changeColor', name: name, r: r, g: g, b: b, a: a});
    }

    /**
     * 高亮目标 3D 对象并设置其外轮廓(边框)颜色。
     * 注:
     * 1、需挂载“对象高亮”组件,确保激活“设置外轮廓”字段,禁用“鼠标事件”字段
     * 2、仅高亮设备外边框,如需高亮对象整体,使用 highlightObjOverlayColor()
     * @param {String} name   对象名称
     * @param {Number} r Red 0-255
     * @param {Number} g Green 0-255
     * @param {Number} b Blue 0-255
     * @param {Number} width 外轮廓宽度,默认 0.5
     * @return {void}
     */
    function highlightObjOutlineColor(name, r, g, b, width) {
        if (!width) {
            width = 0.5;
        }
        window.vuplex.postMessage({ type: 'highlightObjOutlineColor', name: name, r:r ,g:g, b:b, width:width});
    }

    /**
     * 高亮目标3D对象并设置其整体颜色。
     * 注:
     * 1、需挂载“对象高亮”组件,确保激活“设置整体”字段,禁用“鼠标事件”字段
     * 2、仅高亮设备整体,如需高亮设备外轮廓(边框),使用 highlightObjOutlineColor()。
     * @param {String} name 对象名称
     * @param {Number} r Red 0-255
     * @param {Number} g Green 0-255
     * @param {Number} b Blue 0-255
     * @param {Boolean} isFlashing  是否闪烁,默认是
     * @return {void}
     */
    function highlightObjOverlayColor(name, r, g, b, isFlashing = true) {
        window.vuplex.postMessage({ type: 'highlightObjOverlayColor', name: name, r:r ,g:g, b:b, isFlashing:isFlashing});
    }

    /**
     * 清除目标 3D 对象高亮状态。
     * 注:
     * 1、需挂载“对象高亮”组件,确保禁用“鼠标事件”字段
     * @param {String} name  对象名称
     * @return {void}
     */
    function clearObjHighlight(name) {
        window.vuplex.postMessage({ type: 'clearObjHighlight', name: name});
    }

    /**
     * 操作 3D 标签
     * @param {String} name 3D标签名称
     * @param {String} title 标题
     * @param {String} url  图片 url 地址
     * @return {void}
     */
    function handle3DLabel(name, title, url) {
        window.vuplex.postMessage({type: 'handle3DLabel', name: name, title: title, url: url});
    }

    /**
     * 操作 3D 文本标签
     * @param {String} name 3D 文本标签名称
     * @param {String} title  标题
     * @return {void}
     */
    function handle3DTextLabel(name, title) {
        window.vuplex.postMessage({type: 'handle3DTextLabel', name: name, title: title});
    }

    /**
     * 操作 3D 图片标签
     * @param {String} name 3D 图片标签名称
     * @param {String} url  图片 url 地址
     * @return {void}
     */
    function handle3DImageLabel(name, url) {
        window.vuplex.postMessage({type: 'handle3DImageLabel', name: name, url: url});
    }

    /**
     * 控制 3D 对象坐标动画
     * 支持三种补间动画:位置,旋转,比例
     * @param {String} name 3D 对象名称
     * @param {String} animationType   动画类型:位置,旋转,比例
     * @param {Number} x
     * @param {Number} y
     * @param {Number} z 根据设置不同的动画类型对应3D对象位置/旋转/比例的x,y,z目标值
     * @param {Number} duration 动画持续时长
     * @return {void}
     */
    function tweenObj(name, animationType, x, y, z, duration) {
        window.vuplex.postMessage({
            type: 'tweenObj',
            name: name,
            animationType: animationType,
            x: x,
            y: y,
            z: z,
            duration: duration
        });
    }

    /**
     * 加载 3D 场景
     * @param {String} path 场景路径
     * @return {void}
     */
    function loadScene(path) {
        window.vuplex.postMessage({type: 'loadScene', path: path});
    }

    /**
     * 对象预警(高亮闪烁),控制 3D 对象开启/关闭预警
     * @param {String} name 3D 对象名称
     * @param {Boolean} isAlarm 是否对象预警
     * @return {void}
     */
    function objAlarm(name, isAlarm) {
        window.vuplex.postMessage({type: 'objAlarm', name: name, isAlarm: isAlarm});
    }

    /**
     * 对象显示/隐藏控制(适用于 3D 对象,粒子,水等等)
     * @param {String} name 对象名称
     * @param {Boolean} isOpen   true:开启,false:关闭
     * @return {void}
     */
    function objActiveCtrl(name, isOpen) {
        window.vuplex.postMessage({type: 'objActiveCtrl', name: name, isOpen: isOpen});
    }

    /**
     * 控制电梯楼层
     * @param {String} name 电梯对象名称
     * @param {Number} targetFloor 要去的目标楼层,注意不能小于最低楼层,不能大于最高楼层
     * @return {void}
     */
    function goToFloor(name, targetFloor) {
        window.vuplex.postMessage({type: 'goToFloor', name: name, targetFloor: targetFloor});
    }

    /**
     * 获取后期预设列表。通过 sendPostProcessProfiles 监听。
     * @return {void}
     */
    function getPostProcessProfiles() {
        window.vuplex.postMessage({type: 'getPostProcessProfiles'});
    }

    /**
     * 获取天空盒列表。通过 sendSkyBoxs 监听。
     * @return {void}
     */
    function getSkyBoxs() {
        window.vuplex.postMessage({type: 'getSkyBoxs'});
    }

    /**
     * 设置指定后期预设
     * @param {String} name 后期预设名称,可通过顶部工具栏 -> 编辑 -> 设置,或者 getPostProcessProfiles() 获取。
     * @return {void}
     */
    function setPostProcessProfile(name) {
        window.vuplex.postMessage({type: 'setPostProcessProfile', name: name});
    }

    /**
     * 设置指定天空盒
     * @param {String} name 天空盒名称,可通过顶部工具栏 -> 编辑 -> 设置,或者 getSkyBoxs() 获取。
     * @return {void}
     */
    function setSkyBox(name) {
        window.vuplex.postMessage({type: 'setSkyBox', name: name});
    }

    /**
     * 重置第一人称角色控制器到初始位置
     * 注:
     * 1、如未找到第一人称角色控制器,则无效果。
     * 2、初始位置:在编辑器中指定的最后位置。
     * @return {void}
     */
    function resetFirstCharacterTransform(){
        window.vuplex.postMessage({type: 'resetFirstCharacterTransform'});
    }

    return {
        enableCameraController: enableCameraController,
        block3DRayCaster:block3DRayCaster,
        openURL: openURL,
        cameraMove: cameraMove,
        changeColor: changeColor,
        highlightObjOutlineColor: highlightObjOutlineColor,
        highlightObjOverlayColor: highlightObjOverlayColor,
        clearObjHighlight: clearObjHighlight,
        handle3DLabel: handle3DLabel,
        handle3DTextLabel: handle3DTextLabel,
        handle3DImageLabel: handle3DImageLabel,
        tweenObj: tweenObj,
        loadScene: loadScene,
        objAlarm: objAlarm,
        objActiveCtrl: objActiveCtrl,
        goToFloor: goToFloor,
        getPostProcessProfiles: getPostProcessProfiles,
        getSkyBoxs: getSkyBoxs,
        setPostProcessProfile: setPostProcessProfile,
        setSkyBox: setSkyBox,
        resetFirstCharacterTransform: resetFirstCharacterTransform
    };
})();
TwinToH5 完整源码
var TwinToH5 = (function () {

    // 添加监听器
    function addMessageListener() {
        if (window.vuplex) {
            addBaseMessageListener();
        } else {
            window.addEventListener('vuplexready', addBaseMessageListener);
        }
    }

    // 移除监听器
    function removeMessageListener() {
        window.vuplex.removeEventListener('message', handleMessage);
        //TODO Test
        document.getElementById("label").innerHTML = '';
    }

    function addBaseMessageListener() {
        window.vuplex.addEventListener('message', handleMessage);
    }

    function handleMessage(event) {
        //TODO,处理 3D 发送过来的数据
        // 注意:此数据是 string 类型,需先转化成 json
        let json;
        try {
            json = JSON.parse(event.data);
        } catch (error) {
            console.error('Failed to parse JSON:', error);
            return;
        }
        switch (json.type) {
            case 'sendObjInfo':
                document.getElementById("label").innerHTML = '当前对象的数据 : ' + event.data;
                //...
                break;
            case 'sendPostProcessProfiles':
                document.getElementById("label").innerHTML = '后期预设列表: ' + event.data;
                //...
                break;
            case 'sendSkyBoxs':
                document.getElementById("label").innerHTML = '天空盒列表: ' + event.data;
                //...
                break;
            case 'sendObjScreenCoord_MouseStay':
                document.getElementById("label").innerHTML = '对象屏幕坐标: ' + event.data;
                //...
                break;
        }
    }

    return {
        addMessageListener: addMessageListener,
        removeMessageListener: removeMessageListener
    };
})();

调用示例

<button onclick="H5ToTwin.cameraMove('相机组1', 1)">相机组1-视角1</button>
<button onclick="H5ToTwin.changeColor('方块1', 0, 255, 0, 255)">方块1绿色化</button>
<button onclick="H5ToTwin.objActiveCtrl('Fire01', true)">激活火焰Fire01</button>
<button onclick="H5ToTwin.goToFloor('电梯1', 2)">去往电梯1的2楼</button>

云渲染:一键启动

云渲染 v9.0 新增

3DsWorks 9.0 提供 Web 云推流解决方案,可以让用户在浏览器中使用 3DsWorks。按下列步骤启动云渲染服务:

步骤 1 打开 webserver 文件夹

webserver 文件夹
在安装目录中找到 webserver 文件夹

步骤 2 进入 webserver 目录

进入 webserver 目录
webserver 目录内容

步骤 3 双击“一键启动”

一键启动
双击启动脚本

步骤 4 在浏览器中打开播放页

在浏览器中输入 127.0.0.1:8586(也可以输入本机实际的 IP 地址),点击 Web 页面播放器上的播放按钮。

浏览器播放页面
Web 播放器页面

步骤 5 查看运行效果

云渲染运行效果
点击播放后的运行界面

云渲染属于授权模块:学习版、教育版可试用,商业版 Plus 可永久使用。具体使用方法参考安装目录下的 WebServer 目录。


配置文件 config.xml

配置 全局项设置

配置文件 config.xml 用于对软件的一些全局项进行配置,路径位于 \3DsWorks_Data\StreamingAssets\config.xml。

每次设置完成后必须重启软件才会生效。

目前有以下三种配置项:

1、password

作用:发布模式下进入编辑器环境的管理员密码,默认 000000。

<!--发布模式下进入编辑器环境的管理员密码(可通过编辑器中不同的播放模式设置是否需要密码)-->
<password>000000</password>

可通过在编辑器中点击不同的播放模式,设置每次进入编辑器是否需要密码:

播放模式设置
播放模式与密码设置

如设置了 releaseScenePath,并且 showEditorBtn 为 1,则进入编辑器时默认需要密码。

2、releaseScenePath

作用:第一次打开软件时默认加载的场景路径,例如 Scenes/test1。如为空则加载默认示例场景,默认为空。

<!--第一次打开软件时默认加载的场景路径,例如Scenes/test1。如为空则加载默认示例场景-->
<releaseScenePath></releaseScenePath>

目前场景路径仅支持单工程。

工程存档保存在软件的相对路径中,比较方便的方法是在磁盘上查找:以 \3DsWorks_Data\StreamingAssets\DefaultProject\Assets 为根目录,场景文件为 .rtscene 后缀,取场景名称即可。

示例 1

配置场景路径示例一
场景文件位于 Scenes 目录

场景路径则为:Scenes/test1

示例 2

配置场景路径示例二
场景文件位于多级子目录

场景路径则为:Scenes/test/hehe

3、showEditorBtn

作用:设置发布时右上角编辑器按钮是否显示。

  • 1:显示编辑器按钮,可进入编辑器环境(默认)。
  • 0:隐藏编辑器按钮,无法进入编辑器环境。
<!--设置发布时右上角编辑器按钮是否显示
“1”:显示编辑器按钮,可进入编辑器环境(默认)。
“0”:隐藏编辑器按钮,无法进入编辑器环境。
-->
<showEditorBtn>1</showEditorBtn>

更新日志

版本历史 最新版本 9.0(2023/12/07)

以下按版本倒序列出各版本的新增、修改与修复内容。

Version 9.02023/12/07

新增

  • Web 云推流解决方案;
  • 一键云渲染功能,可以让用户在浏览器中使用 3DsWorks。

Version 6.12023/04/28

新增

  • 环境设置中新增了一些天空盒预设;
  • 环境设置中新增“环境光强度倍数”参数。

修复

  • 修复了切换场景时,目标场景的天空盒偶尔会被上一个场景全局覆盖掉的问题。

Version 6.02023/04/19

新增

  • 新增云渲染模块(学习版、教育版可试用,商业版 Plus 可永久使用),具体使用方法参考 WebServer 目录。

Version 5.62023/04/11

新增

  • 环境设置中新增了一些滤镜和天空盒预设。

Version 5.52023/03/10

新增

  • 网页组件默认启用摄像头和麦克风的访问权限。

Version 5.42023/03/06

新增

  • H5 与 3D 交互 Demo 新增 enableCameraController 函数,可通过前端手动激活或禁用相机控制器。具体说明参考 \3DsWorks_Data\StreamingAssets\LocalPages\demo.html。

Version 5.32023/02/24

修改

  • 地形组件编辑器描述修改为中文。

修复

  • 修复了地形组件 - 涂绘树功能中创建多个树模板时只能选择第一个树模板、无法选择后面创建的树模板的问题;
  • 修复了地形组件 - 涂绘树功能中更改树模板预制件时提示主键冲突,导致无法选择模板对象的问题。

Version 5.22023/02/11

新增

  • 软件开机 Logo 新增自定义设置(仅限商业 / 个人注册版),具体参考 \3DsWorks_Data\StreamingAssets\Logo;
  • 场景环境设置中后期预设新增了几个滤镜,并对已有某些滤镜进行了效果优化。

修复

  • 修复了主页组件在新建场景后无法键盘输入的问题;
  • 修复了画质设置从“极致”切换到其他选项时会一直卡在“非常低”、无法再次切换的问题。

Version 5.12023/02/01

新增

  • 配置文件 config.xml 新增“首次打开软件时默认加载的场景”和“是否显示打开编辑器按钮”两个选项,具体参考 配置文件 config.xml。

Version 5.02023/01/31

新增

  • H5 与 3D 交互 Demo 新增 openURL 函数,用来处理网页中无法下载文件的问题。具体说明参考 \3DsWorks_Data\StreamingAssets\LocalPages\demo.html。

Version 4.92023/01/12

修改

  • 导入图片功能的打开对话框界面更换,与导入模型保持一致,选择图片更方便。

Version 4.82023/01/11

新增

  • 新增地形组件,通过“对象 › 3D 对象 › 地形”创建。

Version 4.72023/01/09

修改

  • 内置浏览器模块重构。

Version 4.62022/12/28

新增

  • 资源库 - 树。

Version 4.52022/11/22

新增

  • “传递数据到网页(网页)”组件新增返回数据:当前对象视口坐标,具体说明参考 demo.html。

修改

  • 修改了不同授权的一些文字描述。

Version 4.42022/10/26

新增

  • 新增视频播放器(3D)组件;
  • 新增视频播放器(3D)预制件,通过“工具栏 › 对象 › 3D 对象 › 视频播放器(3D)”生成。

修改

  • 原视频播放器组件 / 预制件改名为视频播放器(2D),与视频播放器(3D)区分。

Version 4.32022/10/21

新增

  • 新增相机漫游组件;
  • 对象组激活禁用组件新增延迟时间属性。

Version 4.22022/09/26

修改

  • 图标修改。

Version 4.12022/09/19

修改

  • 编辑器界面播放按钮更改为两个,点击运行后分别对应“需再次输入密码”和“不需要输入密码”。

Version 4.02022/09/05

新增

  • 打开编辑器新增密码验证环节。密码存储在本地,目录为 \3DsWorks_Data\StreamingAssets\config.xml。

Version 3.92022/08/30

修改

  • 自定义脚本界面宽高增加;
  • 顶部工具栏自适应不同分辨率。

Version 3.82022/08/26

新增

  • 新增自定义脚本功能。

Version 3.72022/08/25

修改

  • 授权验证功能取消。

Version 3.62022/08/25

新增

  • 新增对象组激活禁用组件;
  • 新增按钮(对象组激活禁用)预制件,通过“工具栏 › 对象 › UI › 按钮(对象组激活禁用)”生成。

修复

  • 修复了切换场景时被禁用物体在层次结构窗口中显示状态错乱的问题;
  • 修复了前端 & 3D 交互组件重命名时,层次结构窗口和检视器窗口不一致的问题。

Version 3.52022/08/24

修改

  • 画质设置界面优化;
  • 打开编辑器、加载场景过渡界面字体优化。

修复

  • 修复了对象预警仿真组件如设置了延迟,进入编辑器时到达延迟时间依然会预警的问题;
  • 修复了切换场景后画质设置界面无法打开的问题。

Version 3.42022/04/26

新增

  • 编辑器右上角新增画质设置按钮,可自定义分辨率、窗口全屏模式、画质模式等功能。

修改

  • 个人版授权成功后使用时间由 4 小时改为无限制。

Version 3.32022/04/25

修改

  • Logo、名称修改。

修复

  • 修复了切换场景后组件功能不起作用的问题。

Version 3.22022/04/23

新增

  • 新增加载场景(2D)、加载场景(3D)、对象预警仿真组件;
  • 新增按钮(加载场景)预制件,通过“工具栏 › 对象 › UI › 按钮(加载场景)”生成。

修复

  • 修复了主页 URL 地址为空的情况下,切换网页(2D 界面)和切换网页(3D)组件失效的问题。

Version 3.12022/04/21

修改

  • 导入模型功能移动到文件菜单列表;
  • 导入模型进度条交互禁用。

Version 3.02022/03/22

修改

  • 替换 Demo 模型及描述;
  • 替换 Logo;
  • 修改了进入编辑器按钮的层级,使其不会被 2D UI 遮挡。

Version 2.92015/09/26

修改

  • 修改关于菜单文本描述。

Version 2.82015/09/26

新增

  • 新增自定义授权信息配置文件。

Version 2.72015/09/26

修复

  • 修复了未保存场景时编辑物体材质,天空盒和相机滤镜会重置成默认的问题;
  • 修复了个人版授权界面多次点击“以后再说”按钮进入编辑器时崩溃的问题。

Version 2.62015/09/26

新增

  • 重构了中控组件相关部分,新增一键顺控连接器组件、一键顺控连接器预制件、按钮(一键顺控)预制件。

修改

  • 增加了一键顺控(2D)和一键顺控(3D)组件相关逻辑及参数,具体说明参考组件介绍文档。

Version 2.52015/09/25

新增

  • 新增一键顺控(2D)和一键顺控(3D)组件,具体说明参考组件介绍文档。

Version 2.42015/09/24

修复

  • 修复了导入模型功能打开对话框、不选择模型点击取消按钮时,进度条依然会出现的问题。

Version 2.32015/09/23

新增

  • 导入模型过程新增进度条提示。

Version 2.22015/09/22

修改

  • 替换 Demo 模型。

Version 2.12015/09/21

新增

  • 新增视频播放器预制件和组件,预制件可通过“工具栏 › 对象 › UI › 视频播放器”生成。

修改

  • 增加了 StringEditor 的高度,可容纳 3 行字符串,使一些组件较长的 URL 更清晰直观。

修复

  • 修复了 UI 元素实例化时没有汉化的问题。

Version 2.02015/09/20

新增

  • 编辑器新增最小化功能。

修复

  • 修复了文件导入第一次无操作、第二次打开编辑器无法导入文件的问题。

Version 1.92015/09/12

新增

  • 新增切换相机位(2D)组件;
  • 新增电梯预制件和电梯管理(网页)组件,预制件可通过“工具栏 › 对象 › UI › 电梯”生成;网页部分可通过 JS 控制前往电梯的楼层数,详见 demo.html;
  • 新增学习版、个人版、商业版授权验证。

修改

  • 修改了部分文本的描述。

Version 1.82015/08/27

新增

  • 网页部分新增 3D 对象激活关闭交互功能,详见 demo.html。

Version 1.72015/08/26

修改

  • 重构了部分组件及名称,具体详见组件介绍文档。

修复

  • 修复了网页点击切换场景后无法打开编辑器的问题。

Version 1.62015/08/22

新增

  • 对象预警组件。

修改

  • 对象高亮组件颜色属性显示效果修改。

修复

  • 修复了网页刷新后 JS 事件丢失的问题。

Version 1.52015/08/12

修改

  • 材质搜索功能优化。

Version 1.42015/07/20

新增

  • 工具面板新增资源库 - 水;
  • 新增了一些内置的材质资源库。

修改

  • 发布后打开编辑器按钮体验优化:发布后自动隐藏按钮,移到右上角指定位置时出现。

Version 1.32015/07/17

新增

  • 新增对象高亮组件;
  • 文件下拉列表新增退出按钮;
  • 新增动画功能,可自定义录制帧动画。

Version 1.22015/06/12

修改

  • 修复了切换网页(3D)组件无法保存的问题。

Version 1.12015/02/29

新增

  • 加载网页组件新增刷新间隔,可自定义网页的刷新时间。

Version 1.02014/03/18

初版


关于

3DsWorks 9.0 www.3dsworks.com

版权声明

3DsWorks 版权所有。本手册中的文字、界面截图与示例代码仅用于说明 3DsWorks 软件的使用方法,未经许可不得用于其他用途。

Copyright © 2013–2026 3DsWorks. All rights reserved.

技术支持

官方网站http://www.3DsWorks.com
适用版本3DsWorks 9.0(CS 架构)
文档版本2026/11/16
预览
点击任意处或按 Esc 关闭