2.23 常见问题

Q1：SDK如何安装？

A1：SDK安装请参见CooSDK开发文档第一章SDK安装指南。

Q2：在确认SDK已经安装成功的情况下，发现在非IE浏览器下，三维地图不显示，且存在sdkWindow.exe进程，该如何处理？

A2：出现这种情况，可能是负责CooMap初始化的网页的标题title内容与当前浏览器标签页显示的标题内容不匹配导致的的，需要将title内容设置唯一且对应。

Q3：在确认SDK已经安装成功的情况下，发现在非IE浏览器下，三维地图位置显示异常，该如何处理？

A3：首先在“任务管理器”的进程选项卡中，找到“SDKWindow.exe”,将其结束任务；其次，在“任务管理器”的服务选项卡中，找到“SDKDaemon”服务，将其停止再开始，通过如上处理，一般可解决常规的显示异常问题。如问题未解决，则请看Q4。

Q4：非IE浏览器下，将SDK接入Vue、React等框架时，发现三维地图位置与绑定的div位置有偏移，该如何处理？

A4：出现这种现象，原因与JS API内部获取div相对于页面位置的方式有关，即使用了document.getElementById("map").getBoundingClientRect()，而这些框架因为其结构设计关系，使该方法无法正确获取其在页面实际位置，因此这里需要用户自行进行修改，首先在cooSdkApi.js中搜索“changeMapPositionAndSize”和“changeMapPositionAndSizeForScroll”函数，找到if(window.parent) 代码段，对内部逻辑根据框架实际情况进行修改。

Q5：SDK安装在服务器端，客户机能直接使用吗？

A5：不能，因为SDK是基于计算机本地计算的引擎软件，其对客户机的硬件，特别是显卡有一定的要求。可以把SDK看作是三维游戏客户端，必须得安装在客户机上才能使用，服务器端仅仅提供数据的访问和授权的管理。

Q6：SDK的跨浏览器插件是什么，它和Chrome浏览器插件一样吗，它还支持哪些浏览器呢？

A6：SDK是基于ActiveX插件技术开发的，其被IE所支持，但其他主流浏览器已不支持该类插件，因此开发了跨浏览器插件，它是一套后台通信体系框架，使用了一定的技术手段，使其能运行在非IE浏览器之上，其并不是Chrome中的插件，可以认为是Windows系统中的一套软件体系。目前跨浏览器插件仅支持Chrome、Edge(chromium内核版) 这些浏览器，国内的套壳浏览器暂不支持。

Q7：如何检测SDK是否已经安装在当前计算机中，以便告知用户需要下载SDK才能使用？

A7：JS API的CooMap对象在初始化的时候，提供了errorCallback属性，用来在SDK初始化失败时，告知用户做相应的处理，比如提供SDK下载链接，让用户安装SDK后再运行。如：

var cooMap = new CooSDK.CooMap("map", {
    errorCallback: function(){
        //do something...
    }
});

当SDK安装正常时，初始化时是不会触发errorCallback所绑定的回调函数的。

Q8：非IE浏览器下，打开多个三维地图实例，会出现弹窗报错：“不支持多个三维地图实例”，该如何解决？

A8：三维地图目前仅支持一个实例进行使用，不支持多个实例同时运行，因此会在后台实时检测，当用户创建了多个实例或者以极快的速度刷新网页，都可能会触发检测机制，导致弹窗。为了保证三维地图后续稳定使用，请关闭弹窗后，再关闭所有关联网页，在“任务管理器”的进程选项卡中，找到“SDKWindow.exe”,将其结束任务；其次，在“任务管理器”的服务选项卡中，找到“SDKDaemon”服务，将其停止再开始。

或者找我司相关人员索要双客户端版本。

Q9：静态弹窗界面出现缺失的情况该怎么办？

A9：出现这种情况多半是被电脑中未知软件的弹窗所遮挡，导致静态弹窗出现模块缺失的现象。这时我们需要把SDK安装目录中的plugins文件夹的“SDKWindow.ini”文件用记事本打开，配置“IsCheckTop”和“IsLogging”为true，并保持SDK运行状态，将静态弹窗开启。 等待若干时间，后台会在“C:\ProgramData\KELANTEC”路径下生成相关日志，记录下遮挡静态弹窗的的软件弹窗名称，只需要把类似下列格式的文件发送给我司相关技术人员处理即可。