BIM-API 准备

场景回调监听 V2.3+

{
   "command": "event",
   "func_name": "DCPAPIAlready",
   "args": {
      "DCPAPIAlready":"1 或者 0"
   }
}

说明

• 类似于SuperAPI的APIAlready。在没有收到 DCPAPIAlready 回调之前执行 BIM API 功能，无法保证正确响应。
• DCPAPIAlready:
  • 1 表示成功
  • 0 表示失败

调用顺序

为了保证功能正常使用，必须严格按照流程图顺序使用 BIM API 接口

初始化 V2.1+

设置 BIM 功能的模型默认原点

参数说明

1. OriginLocation: 原点位置(一切后续模型加载，如果没有额外设置模型坐标，都会以此坐标为基准点)
   • UE坐标传入的参数为场景绝对坐标——X、Y、Z 轴坐标点。默认单位: 厘米
   • GIS坐标传入参数分别为——经度、纬度、高度。高度默认单位: 米
2. UseGis: 是否使用GIS坐标, 详细说明见 使用须知#常见参数
3. SeverIP: DCP服务的地址V2.3.1+

let jsonData = {
    "OriginLocation":"100,-100,100",
    "UseGis":"0",
    "SeverIP": ""
}

cloudRender.SuperAPI("BIM51API_InitBIM", jsonData)

注意

必须调用。

开关BIM模式

开启

cloudRender.SuperAPI("OpenBimMode")

注意

• 初次进入 BIM 功能页面必须执行
• 执行后会自动开启所有的自带UI面板，需要手动关闭不需要显示的UI面板

关闭

cloudRender.SuperAPI("CloseBimMode")

注意

• 退出 BIM 功能页面必须执行
• 为了保证下次进入正常调用相关功能，需要先执行“取消激活”模型API

自带UI面板显隐

通过参数驱动自带UI面板的显示和隐藏

通用参数

// 1:开启; 0:关闭
let jsonData = {
    "bOpen":"0"
}

全部面板 V2.5+

提示

进行BS版本开发时，建议先调用该方法关闭全部面板，需要哪个再进行开启

cloudRender.SuperAPI("BIM51API_OpenClose_Total", jsonData)

基础工具栏侧边按钮 V2.5+

cloudRender.SuperAPI("BIM51API_OpenClose_BaseToolBar", jsonData)

高级工具栏侧边按钮 V2.5+

cloudRender.SuperAPI("BIM51API_OpenClose_AdvToolBar", jsonData)

功能分页工具栏 V3.1+

cloudRender.SuperAPI("BIM51API_OpenClose_ModelTypeBar", jsonData)

底部工具栏 V3.1+

cloudRender.SuperAPI("BIM51API_OpenClose_BottomToolBar", jsonData)

瓦片服务高级工具栏侧边按钮 V3.1+

cloudRender.SuperAPI("BIM51API_OpenClose_AdvToolBar_3dtile", jsonData)

资产库高级工具栏侧边按钮 V3.1+

cloudRender.SuperAPI("BIM51API_OpenClose_AdvToolBar_Asset", jsonData)

文件浏览器

注意

必须调用

cloudRender.SuperAPI("BIM51API_OpenClose_FileViewer", jsonData)

构件树

cloudRender.SuperAPI("BIM51API_OpenClose_ElementTreeView", jsonData)

构件属性

cloudRender.SuperAPI("BIM51API_OpenClose_ElementProperty", jsonData)

调用BIM-API

根据业务需求调用相关的 BIM API 或者标准的 SuperAPI 来完成页面的功能和场景的交互

退出页面

注意

必须执行，为了保证下次打开或者进入功能页面不出错

// 取消激活模型
cloudRender.SuperAPI("BIM51API_DeactiveModel")

// 关闭 BIM 模式
cloudRender.SuperAPI("CloseBimMode")

删除save文件

注意

彻底删除所有DCP相关save文件，执行后通常需要重新启动项目

cloudRender.SuperAPI("BIM51API_DeleteTotalSaveInfo")