<3>通用接口
# <3> 功能调用 接口：
## --- 基础系统：
### ==3-1==：重启动三维场景
**接口方法名**：==STU_ResetScene==
>i 无调用参数；相当于场景页面重新刷新；
>i 返回参数：
无参数，会重新刷新场景，返回初始化完成回调；
---
## --- 相机配置系统：
----------*控制场景的相机系统，移动跳转，漫游路径，追踪物体等；*
### ==3-2-1==：镜头跳转到指定位置
**接口方法名**：==STU_MoveToPosition==
**调用参数说明：**
>i< longitude >经度；
< latitude >纬度；
< rotation >相机 左右 观察的角度，0~360度；
< tilt >相机 上下 观察的角度，0~90度；
< distance >相机距离经纬度点的距离，==单位米==；
< time >跳转过去需要用的时间，单位秒，到达指定点后才会收到返回参数；
备注：若跳转位置不对，请检查设置的范围限制；上一组跳转未结束，再次调用后，会停止上一次的跳转，执行新的跳转镜头，并且接收不到上一次调用的回调；
若不传入某条参数，跳转镜头将忽略该参数，不受此参数影响；
请求参数示例：
```
{
"longitude": "113.28905848",
"latitude": "23.09863304",
"distance": 500,
"rotation": 10.5,
"tilt": 10.5,
"time": 10.5
}
或
{
"distance": 500,
"rotation": 10.5,
"time": 10.5
}
```
>i 返回参数：
{
"method": "STU_MoveToPosition",
"exception": null,
"data": "success"
}
---
### ~~==3-2-2==：运行镜头漫游轨迹~~
**接口方法名**：==STU_RunCameraMovePath==
**参数说明：**
>i< time > 整个路径漫游完所需时间，单位秒；
< line > 轨迹点数据，起始经纬度点到尾点，至少2个点；
< longitude > 经度；
< latitude > 纬度；
< height > 高度；
>d注：此接口会继续拓展，等模拟系统完成后，可自行模拟漫游路径，直接生成数据调用；
**参数示例：**
```
{
"time": "10",
"line": [
{
"longitude": "113.25163907",
"latitude": "23.10045305",
"height": "0.2"
},
{
"longitude": "113.26795882",
"latitude": "23.09083306",
"height": "0.2"
},
{
"longitude": "113.28905848",
"latitude": "23.09863304",
"height": "0.2"
}
]
}
```
>i 返回参数：
{
"method": "STU_RunCameraMovePath",
"exception": null,
"data": "success"
}
---
### ~~==3-2-3==：停止镜头漫游轨迹~~
**接口方法名**：==STU_StopCameraMovePath==
>i 无调用参数；
>i 返回参数：
{
"method": "STU_StopCameraMovePath",
"exception": null,
"data": "success"
}
---
### ~~==3-2-4==：开启镜头追踪目标（占位接口，等单模型系统开发完成）~~
**接口方法名**：==STU_OpenOrCloseCameraTrack==
---
### ==3-3-1.交互控制==：开启或关闭自动旋转
**接口方法名**：==STU_OpenOrCloseAutoRotate==
**参数说明：** 字符串格式
>i < boolValue > 开启或关闭（显示或隐藏）自动镜头旋转，true开启，false关闭，默认false；
< numberValue > 自转速率，建议以 0.01为基准上下浮动，参数大于0方向为顺时针旋转，反之为逆时针反向旋转；
请求参数示例：
```
{
"boolValue": true,
"numberValue": -0.3
}
```
>i 返回参数：
{
"method": "STU_OpenOrCloseAutoRotate",
"exception": null,
"data": "success"
}
---