数字孪生WebAPI二次开发技巧

最新推荐文章于 2025-07-04 20:01:15 发布

原创最新推荐文章于 2025-07-04 20:01:15 发布 · 1.2k 阅读

13 ·

CC 4.0 BY-SA版权

文章标签：

#javascript

近年来，数字孪生技术的应用场景不断扩展，核心业务的可视化展现与创新的三维交互需求愈发多元。

CIMPro孪大师提供的数字孪生WebAPI是一套基于JavaScript语言开发的二次开发接口，面向Web前端开发人员使用，通过调用相关API接口与云渲染的三维场景进行便捷交互，CIMProAPI兼容当前主流前端框架，如Vue、React、Angular。

通过CIMProAPI，可以在网页上创建HTML5 UI元素, 并使其与云端渲染的3D场景进行双向交互。

CIMProAPI简化了开发3D交互应用的难度, 便于开发者轻松构建网页3D交互体验。

CIMPro孪大师V6.3聚焦新能源、智能制造、航天军工、基础设施、产教融合等行业领域的数字孪生/虚拟仿真开发需求，新增10项常用交互API，提升用户数字孪生开发体验。

[camera.CameraSpeed 相机-缩放速度](#cameracameraspeed)

输入


{

    CameraSpeed: 4.0 //相机速率

}

2. [object.playScatterSetAnimation 对象-播放阵列动画](#objectplayscattersetanimation)

输入


```javascript  
{  
    "objectId": "", // 阵列对象ID
    "animationParamter": "0/0" // 两级阵列播放序列
}  
```

调用

piclient.emit("object.playScatterSetAnimation",{
    "objectId": "", // 阵列对象ID
    "animationParamter": "0/0" // 两级阵列播放序列
})

3. [object.resetScatterSetWithId 对象-重置阵列对象](#objectresetscattersetwithid)

输入

```javascript  
{  
    "objectId": "", // 阵列对象ID
}  
```

调用

piclient.emit("object.resetScatterSetWithId",{
    "objectId": "", // 阵列对象ID
})

4. [object.setWaterMaterialProperty 对象-修改水材质属性](#objectsetwatermaterialproperty)

输入

{
    target: "", //对象 
    PropertyFractionIn: "",         //材质透明浑浊度
    PropertyWaterRoughness: "",     //反射强度
    PropertyWaterSpecular: "",      //高光度
    PropertycColor: "",             //水面颜色
    PropertyDirection_Offset: "",   //水流方向
    PropertyFoamOffset: "",         //泡沫流动方向
    PropertyGlobalSpeed: "",        //泡沫流动速率
    PropertySize: "",               //波浪大小
    PropertyWavelength: "",         //波浪强度
}

调用

piclient.emit("object.setWaterMaterialProperty",{
    target: "", //对象 
    PropertyFractionIn: "",         //材质透明浑浊度
    PropertyWaterRoughness: "",     //反射强度
    PropertyWaterSpecular: "",      //高光度
    PropertycColor: "",             //水面颜色
    PropertyDirection_Offset: "",   //水流方向
    PropertyFoamOffset: "",         //泡沫流动方向
    PropertyGlobalSpeed: "",        //泡沫流动速率
    PropertySize: "",               //波浪大小
    PropertyWavelength: "",         //波浪强度
})

5. [object.blur 对象-虚化](#objectblur)

输入


{
    target: "",   //对象Id
    bBlur: "true" //true是开启虚化，false是关闭虚化
}

调用


piclient.emit("object.blur",{
    target: "",   //对象Id
    bBlur: "" //
})

6. [object.opacity 对象-透明度](#objectopacity)


{
    target: "",   //对象Id
    Opacity: "" //
}

7. [object.GetInfo 对象-信息](#objectgetinfo)

输入


{
    target: ""   //对象Id
}

输出


{
    targetId:  "",
    DisplayName: "",
    class: "",
    Geo: "",
    Pos:  ""
}

调用


piclient.emit("object.GetInfo",{
    targetId:  "",
    DisplayName: "",
    class: "",
    Geo: "",
    Pos:  ""
})

8. [object.GetScreenInfo 对象-屏幕信息](#objectgetscreeninfo)

输入


{
    target: ""  , //对象Id
    selectionIndex: ""
}

输出


{
    targetId:  "",
    projectId: "",
    SrceenObjects: []
}

9. [object.StopScreenInfo 对象-停止屏幕信息](#objectstopscreeninfo)

输入


{
    target: "",   //对象Id
    selectionIndex: "",
    isAll: ""
}

12月19日16：30，漂视资深研发危明将详细介绍CIMPro孪大师数字孪生API以及开发逻辑，届时也会回答开发者们在数字孪生项目开发过程中遇到的所有交互问题，欢迎来 #视频号：孪大师CIMPro直播间与我们交流互动。

开发数字孪生！就用CIMPro孪大师！

CIMPro的业务起点发生在建模完成后，聚焦于模型的渲染、仿真、动画、数据驱动，旨在帮助用户发挥模型的应用价值。

作为漂视自主研发的数字孪生3D可视化开发软件。软件将设计创造性、交互逻辑、三维动画、数据接入等多类前沿技术，集成在一个具备强大实时渲染功能的三维环境里。利用强大而灵活的低代码开发方式，帮助全国数百家国央企数科公司、研发中心、研究院、科研院所拓展数字孪生业务，通过数字孪生新质生产力工具，彰显企业数字化实力。

零代码一站式

从模型场景、UI图表、3D交互到数据对接全流程零代码/低代码配置交付。

地理信息支持

支持WGS84坐标系，通过卫星影像、数字高程图等图层数据的叠加渲染，真实还原复杂地形，实现不同阶段项目的全局总览。支持集成3DTiles、SHP文件、瓦片数据、倾斜摄影OSGB模型。

三维仿真引擎

通过关键帧动画、物理模拟、粒子系统等技术，为建筑和设备三维可视化提供逼真动态效果。

多源数据融合

支持工业模型（solidworks、UG、catia等）、BIM（Revit、Navisworks、Bentley、SU）、倾斜摄影(OSGB、大疆智图、ContextCapture)、手工模型（3ds Max、Maya）、游戏引擎、全球卫星影像、矢量数据（shp文件、GeoJSON）、3DTiles。

孪生体

可由内部或外部导入的模型制作孪生体，为静态模型附加运动逻辑和动态效果，支持实时数据驱动，孪生体也可以保存为资源，进行重复利用。

行业应用

航天军工

面向航天军工领域，利用数字孪生技术和图形处理技术，对军事行动和战场环境进行态势模拟，实现军事、航空、航天的视景仿真呈现，辅助用户进行设计规划、预测行动结果、优化战略决定。

智能制造

为工业客户提供全面的数字化解决方案，涵盖设计、仿真、培训和数据可视化等方面应用，提升生产效率和运营管理能力。

新能源

通过对新能源各场景的深度模拟，实现资产的数字管控，解决信息集成度不够所造成的“资源孤岛”和“数据孤岛”。