初始化
# 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
功能的模型默认原点
参数说明
- OriginLocation: 原点位置(一切后续模型加载,如果没有额外设置模型坐标,都会以此坐标为基准点)
- UE坐标传入的参数为场景绝对坐标——
X
、Y
、Z
轴坐标点。默认单位: 厘米 - GIS坐标传入参数分别为——经度、纬度、高度。高度默认单位: 米
- UE坐标传入的参数为场景绝对坐标——
- UseGis: 是否使用GIS坐标, 详细说明见 使用须知#常见参数
- 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")
上次更新: 2023/02/17, 14:36:11