<2>配置接口
# <2> 控制配置 接口:
### ==2-1.交互控制==:开启鼠标控制(默认开启)
**接口方法名**:==STU_OpenOrCloseMouseController==
>i< boolValue > 开启或关闭(显示或隐藏),true开启,false关闭,默认false;
请求参数示例:
```
{
"boolValue": true
}
```
>i 返回参数:
{
"method": "STU_OpenOrCloseMouseController",
"exception": null,
"data": "success"
}
---
### ==2-2.交互控制==:鼠标灵敏度调节(旋转 缩放 拖动 左右键交换)
**接口方法名**:==STU_MouseConfig==
>i<左右旋转速度 rotatespeed> 鼠标 左右旋转场景的灵敏速度,取值范围0.001 – 720 , <rotatespeed: 360>
>i<缩放速度 zoomSpeed> 鼠标缩放场景速度,取值范围0.001 – 1500, <zoomSpeed : 600>
>i<拖动速度 panSpeed> 鼠标拖动场景的速度,取值范围0.001 - 1000 , <panSpeed: 100>
>i<上下旋转速度 tiltSpeed> 鼠标 上下旋转场景的灵敏速度,取值范围0.001 – 720, <tiltSpeed: 360>
>i<鼠标左键旋转 leftkeyRotate> ture:鼠标左键旋转,右键拖动;false:鼠标左键拖动,右键旋转;
请求参数示例:
```
{
"rotateSpeed": 360,
"tiltSpeed": 360,
"zoomSpeed": 600,
"panSpeed": 100,
"leftKeyRotate": true
}
```
>i 返回参数:
{
"method": "STU_MouseConfig",
"exception": null,
"data": "success"
}
---
### ==2-3.交互控制==:设置场景的空间限制范围
**接口方法名**:==STU_ConfigSceneBounds==
>i<经纬度边界范围> 朝北平面,右上角和左下角的两个经纬度点,限定场景的拖动范围;
>i<minDistance/maxDistance> 相机距离视线中心的最大和最小距离,**单位米**;
>i<minTilt/maxTilt> 最大和最小的仰视角度值;
请求参数示例:
```
{
"bounds": {
"xBoundsLongitude": "118.77886000",
"xBoundsLatitude": "32.07960000",
"yBoundsLongitude": "119.556000",
"yBoundsLatitude": "31.0742000"
},
"distance": {
"minDistance": 0,
"maxDistance": 50
},
"tilt": {
"minTilt": 0,
"maxTilt": 50
}
}
```
>i 返回参数:
{
"method": "STU_ConfigSceneBounds",
"exception": null,
"data": "success"
}
---
### ==2-4.控制后台运行==:开启或关闭 后台运行
**接口方法名**:==STU_SetRunInBackground==
**参数说明:** 字符串格式
>i < boolValue > 开启或关闭(显示或隐藏),true开启,false关闭,默认false;
若关闭后台运行后,鼠标在非激活的webgl窗口,三维场景不运行;
默认会开启后台运行;
请求参数示例:
```
{
"boolValue": true
}
```
>i 返回参数:
{
"method": "STU_SetRunInBackground",
"exception": null,
"data": "success"
}
---
### ==2-5==:配置2D地图的视角数据
**接口方法名**:==STU_ConfigMapScreenData==
>i 视口对角线两个点的经纬度点;默认朝向上方位北面;
请求参数示例:
```
{
"longitude_A": "113.28905848",
"latitude_A": "23.09863304",
"longitude_B": "113.28905848",
"latitude_B": "23.09863304",
"rotation": 60, //旋转朝向角度,0度为朝向上方位北面;
"tilt": 20 //上下抬头角度,0~90度;
}
```
>i 返回参数:
{
"method": "STU_ConfigMapScreenData",
"exception": null,
"data": "success"
}
---
### ~~==2-6==:开启或关闭 编辑模式~~
**接口方法名**:==STU_OpenOrCloseEditorState==
>i< boolValue > 开启或关闭(显示或隐藏),true开启,false关闭,默认false;
请求参数示例:
```
{
"boolValue": true
}
```
>i 返回参数:
{
"method": "STU_OpenOrCloseEditorState",
"exception": null,
"data": "success"
}
---
## --- 场景查询系统:
----------*查询场景的基础信息,包括当前中心点经纬度、视角方向、距离、高度等等;*
---
### ==2-7-1==:查询场景资源和信息
**接口方法名**:==STU_CheckSceneAsset== todo
>i无调用参数,查询场景资源和功能信息,返回场景中包括的模型特效等资源,以及对应可以使用的功能等;
>i 返回参数:
{
"method": "STU_CheckSceneAsset",
"exception": null,
"data": "{\"method\":\"STU_GetCameraInfo\",\"exception\":null,\"data\":{\"longitude\":\"113.28905848\",\"latitude\":\"23.09863304\",\"distance\":10.5,\"rotation\":10.5,\"tilt\":10.5}}"
}
data参数:
```
{
待补充
}
```
---
### ==2-7-2.== 获取当前镜头的参数
**接口方法名**:==STU_GetCameraInfo==
>i 无调用参数;
>i备注:角度是360度是一圈,小于0度或大于360度即重复循环;
< longitude >经度;
< latitude >纬度;
< rotation >相机对经纬度点的角度;
< distance >相机距离经纬度点的距离;
< time >跳转过去需要用的时间,单位秒,到达指定点后才会收到返回参数;
>i 返回参数:
{
"method": "STU_GetCameraInfo",
"exception": null,
"data": "{\"method\":\"STU_GetCameraInfo\",\"exception\":null,\"data\":{\"longitude\":\"113.28905848\",\"latitude\":\"23.09863304\",\"distance\":10.5,\"rotation\":10.5,\"tilt\":10.5}}"
}
data参数:
```
{
"longitude": "113.28905848",
"latitude": "23.09863304",
"distance": 10.5,
"rotation": 10.5,
"tilt": 10.5
}
```
---
### ==2-7-3==:查询当前鼠标箭头指向三维空间的经纬度
**接口方法名**:==STU_CheckMouseArrowPoint==
>i无需参数
>i 返回参数:
{
"method": "STU_CheckMouseArrowPoint",
"exception": null,
"data": "参数内容(经纬度),无高度(0)"
}
---
### ==2-7-4==:查询3D空间的2D地图视角数据
**接口方法名**:==STU_CheckMapScreenData==
>i无需参数
>i 返回参数:
{
"method": "STU_CheckMapScreenData",
"exception": null,
"data": "屏幕左上角经纬度_屏幕右下角经纬度"
}
---
### ==2-7-5==:开启或关闭 场景操作变动回调
**接口方法名**:==STU_OpenOrCloseSceneInfo==
>i< boolValue > 开启或关闭(显示或隐藏),true开启,false关闭,默认false;
< numberValue > 监听间隔频率时间;
开启后,鼠标操作停止numberValue参数时间后,检查一次场景的状态变动,若发生平移或缩放(无旋转)时候,通过回调接口3:“callback_OnMapChanged”传递场景信息参数;无变化不调用回调,默认是关闭状态;
请求参数示例:
```
{
"boolValue": true,
"numberValue": 1.6
}
```
>i 返回参数:
{
"method": "STU_OpenOrCloseSceneInfo",
"exception": null,
"data": "success"
}
---