Class: DigitalTwinAPI

DigitalTwinAPI

JS SDK的总类

一般通过全局变量 fdapi 来调用其接口。

注意事项:

  • 只有new DigitalTwinAPI以后,全局变量 fdapi 才是有效的。

  • 如果在一个页面上创建了多个视频流窗口,那么 fdapi 始终指向最后一次创建的DigitalTwinAPI对象,对于这种情况的解决方案,请参考SDK文件夹的player_2_2.html


new DigitalTwinAPI(host, options)

构造一个DigitalTwinAPI类的对象,用于API接口的初始化。
注意:如果所开发的页面带有云渲染视频流展示,只需要初始化DigitalTwinPlayer即可,DigitalTwinAPI不需要用户创建(内部会自动创建),可以通过DigitalTwinPlayer的getAPI()方法获取。

Parameters:
Name Type Description
host string

服务器地址,格式如下 IP:Port(此处的Port是实例的WebSocket服务端口号)

options object

初始化选项,支持以下属性(都是可选)

  • onReady

    • 参数类型:function
    • 参数说明:工程加载成功后的回调函数,只有从这个时候开始,才能调用API, 如果工程尚未打开就调用API,会有崩溃或者错误的风险。

  • onLog

    • 参数类型:function
    • 参数说明:用于给DigitalTwinAPI指定输出日志的方法

  • onEvent

    • 参数类型:function
    • 参数说明:用于设置事件处理的回调函数,也可以通过setEventCallback方法来设置

  • onApiVersion

    • 参数类型:function
    • 参数说明:用于接收云渲染服务器的版本信息的回调方法

See:

Members


antenna

天线方向图对象,提供Antenna对象的操作方法

See:

beam

Beam类的对象,提供光流相关的操作

See:

camera

Camera类的对象,提供相机相关的操作

See:

cameraTour

CameraTour相机导览动画类,提供相机导览动画操作方法


cesium3DTileset

Cesium3DTileset类的对象,提供Cesium3DTileset的相关操作

See:

coord

Coord类的对象,提供坐标转换相关的操作

See:

customMesh

CustomMesh类的对象,提供自定义网格相关的操作

See:

customObject

CustomObject类的对象,提供用户自定义对象相关的操作

See:

customTag

CustomTag,提供对用户自定义标签相关的操作

See:

decal

Decal类的对象,提供贴花相关的操作

See:

dynamicWater

DynamicWater类的对象,提供动态水的相关操作

See:

editHelper

EditHelper类的对象,提供编辑助手相关操作

See:

finiteElement

FiniteElement类的对象,提供有限元分析对象相关的操作


floodFill

FloodFill类的对象,提供水淹分析的相关操作

See:

fluid

Fluid类的对象,提供流体仿真对象相关的操作


geoJSONLayer

GeoJSONLayer类的对象,提供GeoJSON类型图层符号化加载及相关操作

See:

heatmap

HeatMap类的对象,提供热力图相关的操作

See:

heatmap3d

HeatMap3D类的对象,提供三维热力图相关的操作

See:

highlightArea

HighlightArea类的对象,提供高亮区域相关的操作

See:

hydrodynamic1d

HydroDynamic1D类的对象,实现对一维水动力模型对象的操作接口

See:

hydrodynamic2d

HydroDynamic2D类的对象,实现对二维水动力模型对象的操作接口

See:

hydrodynamicModel

HydrodynamicModel类的对象,提供二维水动力模型相关的操作


hydrodynamicModel2

HydrodynamicModel2类的对象,提供二维水动力模型相关的操作(过时版本待移除)


imageryLayer

ImageryLayer类的对象,提供网络类型图层的相关操作

See:

infoTree

InfoTree类的对象,提供图层相关的操作

See:

light

Light类的对象,实现对光源的操作接口

See:

marker

Marker类的对象,实现对标注的操作方法

See:

marker3d

Marker3D类的对象,实现对三维标注的操作方法

See:

markerLayer

MarkerLayer类的对象,提供MarkerLayer标记图层相关操作

See:

misc

Misc类的对象,提供一些杂项功能

See:

odline

ODLine类的对象,提供迁徙线相关的操作

See:

panorama

Panorama类的对象,提供全景图相关的操作

See:

polygon

Polygon类的对象,提供多边形相关的操作

See:

polygon3d

Polygon3D类的对象,提供三维多边形相关的操作

See:

polyline

Polyline类的对象,提供线段相关的操作

See:

radiationPoint

RadiationPoint类的对象,提供辐射圈相关的操作

See:

river

River类的对象,实现对河道对象的操作接口

Deprecated:
  • Yes
See:

settings

Settings类的对象,提供三维参数设置相关的接口

See:

settingsPanel

设置面板对象,提供对设置面板里的参数进行操作的接口

See:

shapeFileLayer

ShapeFileLayer类的对象,提供ShapeFileLayer对象的相关操作

See:

signalWave

SignalWave类的对象,实现对信号波束的操作接口

See:

tag

Tag类的对象,实现标签对象的增、删、改、查相关的功能

See:

tileLayer

TileLayer类的对象,提供TileLayer增、删、改、查相关的功能

See:

tools

Tools类的对象,提供一些工具类的接口

See:

vectorField

VectorField类的对象,提供向量场相关的操作

See:

vehicle

Vehicle类的对象,提供车辆载具对象相关的操作

See:

videoProjection

VideoProjection类的对象,提供视频投影相关的操作

See:

waterFlowField

WaterFlowField类的对象,提供流场相关的操作

See:

waterMesh

WaterMesh类的对象,提供水体网格相关的操作

See:

weather

Weather类的对象,提供天气相关的操作接口

See:

Methods


checkApiReady()

检查API调用是否就绪


destroy()

关闭WebSocket连接

如果不调用destroy方法,当WebSocket连接被动关闭后,会自动尝试重连,但是
如果调用了destroy方法,连接断开后,不会再尝试重连了,需要刷新页面才会继续连接。


executeJsInTickPage(code, fn)

在tick页面里执行Javascript代码

Parameters:
Name Type Description
code string

JS代码

fn function

可选的回调函数,请参考二次开发:异步接口调用方式


getPlayer()

获取DigitalTwinAPI所关联的DigitalTwinPlayer对象,如果只是纯接口调用,则返回null.

Returns:

DigitalTwinPlayer对象


getVersion()

获取SDK的完整版本号,例如:5.3.0413
注:通过AcApiVersion或者acapi.VERSION获取到的是SDK的大版本号,例如:5.3,而通过此方法获取到的是完整版本号


registerTick(url, options, fn)

注册每帧渲染时要执行的JS脚本
注意:ontick方法里禁止调用耗时接口 否则会导致视频流卡顿影响交互

Parameters:
Name Type Description
url string

在渲染程序里运行的HTML页面

options boolean

用于调试的选项。 可设置调试窗口的位置、大小和可见性。 属性如下:x, y, width, height, visible

fn function

可选的回调函数,请参考二次开发:异步接口调用方式


removeTick(fn)

移除每帧渲染时执行的JS脚本

Parameters:
Name Type Description
fn function

可选的回调函数,请参考二次开发:异步接口调用方式


reset(type, fn)

对三维场景执行重置操作

Parameters:
Name Type Description
type ResetType

设置重置的类别,请参考 ResetType,如果不传此参数,默认行为是清除添加的所有对象

fn function

可选的回调函数,请参考二次开发:异步接口调用方式


saveProject(fn)

保存场景(只保存场景设置,不保存接口创建的对象)
注意:此接口有并发问题,请务必保证各客户端的调用顺序是同步的。

Parameters:
Name Type Description
fn function

可选的回调函数,请参考二次开发:异步接口调用方式


setEnableAliases()

开启接口别名(不建议使用)


setEventCallback(fn)

设置三维事件(例如相机飞行开始、结束、Actor的点击等)的回调函数

Parameters:
Name Type Description
fn function

事件回调函数


setHost(ip, port)

设置主机地址

Parameters:
Name Type Description
ip string

IP地址或者主机名

port number

WebSocket服务的端口号


showTickWindow(visible, fn)

显示/隐藏tick调试窗口。 该方法既可以在客户端调用,也可以在tick调试窗口调用

Parameters:
Name Type Description
visible boolean

是否可见

fn function

可选的回调函数,仅在客户端调用时有效。