<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" } ---