Class: BattlefieldSimulation

Extends

• BaseObject

Methods

---

add(battlefieldSimulation, fn)

初始化一个BattlefieldSimulation对象

展示效果如下动图：

Parameters:

Name	Type	Description
battlefieldSimulation	object	战场仿真对象，支持以下属性： id (string) BattlefieldSimulation对象的ID groupId (string) 可选，Group分组Id userData (string) 可选，用户自定义数据 coordinateType (number) 可选，坐标系类型，取值：0为Projection类型，1为WGS84类型，默认值：0 noiseThreshold (number) 可选，车辆摆头的降噪距离，单位：米，默认值：0.05 delay (number) 可选，控制车辆移动的延迟时间，单位：秒，默认值：0.5，设置0则不延时立刻移动 timer (boolean) 设置为false使用dat数据内的时间字段time，设置为true则使用定时器的时间间隔，默认：false， models (array) 战场仿真包含的作战单元对象模型类型数组，注意：只需要在add()方法执行时配置，每一个数组元素对象包含属性如下： type (number) 车辆类型，注意这个数值会写入更新方法使用的.dat文件内。 package (string) 资源库车辆载具路径，取值类似CustomObject对象的assetPath，示例值：'/AirCityPlugin/ArtResources/Traffic/SUVTemplete'
fn	function	可选的回调函数，请参考二次开发：异步接口调用方式

Example

请求参数示例


            {   
                "id": "traffic",
                "coordinateType": 1,
                "groupId": "groupAll",
                "userData": "战场仿真",
                "delay": 1,
                "noiseThreshold": 0.05,  //车辆降噪距离 
                "timer": false,// 禁用定时器时间间隔，使用dat数据内的time字段         
                "models": [
                    {
                        "type": 1,
                        "package": "/AirCityPlugin/ArtResources/Traffic/SUVTemplete"
                    },
                    {
                        "type": 2,
                        "package": "/JC_CustomAssets/VehicleLibrary/Exhibition/公交车_04"
                    },
                    {
                        "type": 3,
                        "package": "/JC_CustomAssets/VehicleLibrary/Exhibition/迷你巴士_01"
                    }
                ]
            }

---

delete(ids, fn)

删除一个或多个BattlefieldSimulation对象

Parameters:

Name	Type	Description
ids	string | array	要删除的BattlefieldSimulation对象的ID或者ID数组（可以删除一个或者多个）
fn	function	可选的回调函数，请参考二次开发：异步接口调用方式

---

focus(ids, distance, flyTime, rotation, distanceRotation, fn)

自动定位到合适的观察距离

Parameters:

Name	Type	Description
ids	string | array	BattlefieldSimulation对象的ID或者ID数组
distance	number	可选参数，观察点距离目标点（被拍摄物体）的距离
flyTime	number	可选参数，相机飞行的时间，取值范围：[0~任意正数]，单位：秒，默认值2秒
rotation	array	可选参数，相机旋转的欧拉角：[Pitch,Yaw,Roll]，数组元素类型：(number)，取值范围：Pitch[-90~90] Yaw[-180~180] Roll[0]
distanceRotation	array	可选参数，跟车相机旋转的欧拉角：[Pitch,Yaw,Roll]，数组元素类型：(number)，取值范围：Pitch[-90~90] Yaw[-180~180] Roll[0]
fn	function	可选的回调函数，请参考二次开发：异步接口调用方式

---

update(battlefieldSimulation, fn)

更新一个时刻的BattlefieldSimulation对象

Parameters:

Name	Type	Description
battlefieldSimulation	object	战场仿真对象，支持以下属性： id (string) BattlefieldSimulation对象的ID groupId (string) 可选，Group分组Id userData (string) 可选，用户自定义数据 file (string) 某个时刻的多辆车的轨迹点数据文件路径，包含：车辆id、车辆经度、车辆纬度、车辆类型、时间、车辆朝向。二进制文件格式(.dat)，包含内容如下：id(int 4字节),lon(double 8字节),lat(double 8字节),type(int 4字节),time(int 4字节),heading(float 4字节) coordinateType (number) 可选，坐标系类型，取值：0为Projection类型，1为WGS84类型，默认值：0 noiseThreshold (number) 车辆摆头的降噪距离，单位：米，默认值：0.05 timer (boolean) 设置为false使用dat数据内的时间字段time，设置为true则使用定时器的时间间隔，默认：false，
fn	function	可选的回调函数，请参考二次开发：异步接口调用方式

Example

请求参数示例

{
            "id": "traffic",
            "coordinateType": 1,
            "groupId": "",
            "userData": "",
            "file": "F:\\vehicle\\vehicle_" + index + ".dat",
        }

---

updateBegin()

用于批量多次修改对象的属性

在开始修改之前调用updateBegin，然后可以多次调用setXXX方法，最后调用updateEnd提交修改更新数据
注意：
updateBegin不是异步调用，不需要await，也没有回调函数参数

Inherited From:

• BaseObject#updateBegin

Overrides:

• BaseObject#updateBegin

Example

fdapi.xxx.updateBegin();
for (let i = 0; i < 1000; i++) {
     fdapi.xxx.setColor(i, Color.Yellow);
} 
fdapi.xxx.updateEnd(function () {
     log('update finished!');
});

---

updateEnd(fn)

用于批量多次修改对象的属性，与updateBegin配套使用
注意：
updateEnd是异步调用，可以用回调函数也可以await

Parameters:

Name	Type	Description
fn	function	可选的回调函数，请参考二次开发：异步接口调用方式

Inherited From:

• BaseObject#updateEnd

Overrides:

• BaseObject#updateEnd