SuperMap iClient3D
常见问题与解答
北京超图软件股份有限公司
中国·北京
法律声明
本资料的版权为北京超图软件股份有限公司所有，受《中华人民共和国著作权法》和著作权国际公约的保护。未经北京超图软件股份有限公司书面许可，不得以任何方式或理由对该资料的任何部分进行使用、复制、修改、抄录、传播或与其它产品捆绑使用、销售，侵权必究。
“超图”、“SuperMap”以及
本资料并不代表供应商及其代理的承诺，北京超图软件股份有限公司可在不作任何声明的情况下对本资料进行修改。
本资料中提到其他公司和产品的商标所有权为该公司所有。未经该权利人的书面同意，不得以任何方式或理由进行使用、复制、修改、抄录、传播。
本资料中所涉及的软件产品及其后续升级产品均由北京超图软件股份有限公司研发、销售。
特此声明。
北京超图软件股份有限公司
地址：北京市朝阳区酒仙桥北路甲10号电子城IT产业园107楼6层
邮编：100015
电话：+86-10-59896655
传真：+86-10-59896666
技术支持与客户监督热线：400-8900-866
技术支持电子邮箱：support@supermap.com
客户监督电子邮箱：cs@supermap.com
网址：http://www.supermap.com.cn
SuperMap欢迎您的宝贵建议和意见。
本文档主要介绍一些常见问题与相关解决办法，协助大家快速解决在使用SuperMap_iClient3D_8C_for_Plugin中遇到的问题。
在以下操作过程中，需要使用到SuperMap桌面产品、服务器产品和iClient3D客户端。SuperMap iDesktop在V8.1及以后版本提供了地形、影像、模型新的缓存生成方式，请使用V8.1及以后版本的桌面产品和服务器产品进行操作。
² 产品官网下载地址：
http://support.supermap.com.cn/DownloadCenter/ProductPlatform.aspx
本文档所使用的桌面产品、服务器产品版本如下：
² 桌面产品：SuperMap iDesktop 810
² 服务器产品：supermap iserver 810
² 客户端产品：SuperMap_iClient3D_8C_(2017)_for_Plugin
正常情况下安装32位三维插件客户端即可，若需要体验64位带来的更好性能体验可同时安装64位与32位的插件客户端。推荐首先安装64位，再安装32位三维插件客户端。目前64位插件客户端暂时不支持除IE外的其他64位浏览器，如果先安装32位插件客户端后安装64位插件客户端，可能会导致Chrome等其他32位浏览器不能正常打开场景。
安装失败时，请暂时不关闭安装失败界面的提示，否则安装程序将回退而无法检查安装目录的完整性。
解决思路：
1. 请检查本机是否已经安装显卡驱动；
以“win10系统为例”
在我的电脑右键选择“管理”弹出对话框选择“设备管理”查看显卡驱动是否安装。
显卡驱动未安装视图
2. 检查是否缺少库文件
使用桌面提供的工具，在SuperMap iDesktop 8C > Tools文件夹下双击“DEPENDS.EXE”，点击“open”按钮打开安装路径(C:\SuperMap\SuperMap iClient\SuperMap iClient3D for Plugin)下的“npSuperMapRealspace.dll”文件，若缺少*.dll库文件，可百度下载相应库文件。 （注：如果安装的是32位客户端插件请使用桌面提供的32位DEPENDS查看，如使用的是64位桌面请使用对应的64位DEPENDS查看。
桌面下载地址：http://support.supermap.com.cn/DownloadCenter/DownloadPage.aspx?id=639）
3. 提示注册失败：
8C SP1及后续版本提供了用于注册的批处理文件rege.bat，它位于安装路径（C:\SuperMap\SuperMap iClient\SuperMap iClient3D for Plugin）下，直接双击rege.bat即可执行注册命令； 而早于8C SP1的三维客户端则需要手动注册：进入CMD命令行，输入命令“regsvr32
"C:\SuperMap\SuperMap iClient\SuperMap iClient3D for Plugin\npSuperMapRealspace.dll"即可。
目前三维插件客户端暂不支持Firefox，在不指定浏览器的情况下建议更换为其他浏览器。
可以通过下列方式实现：
将“C:\SuperMap\SuperMap iClient\SuperMap iClient3D for Plugin”放到path的最前边。
（2）使用Firefox可能会遇到的问题：
使用Firefox浏览三维场景可能会与网页其他控件有交互问题，导致场景变卡、性能变慢建议使用Chrome、IE、Opera等其他浏览器。
1、44以上版本已经不再支持插件功能，请使用44以前版本。
下载地址：http://pan.baidu.com/s/1pLi0mH9
2、三维插件客户端不支持64位chrome。
解决思路：
1、安装三维插件客户端时需要关闭chrome，是否安装时未关闭。关闭chrome后重新安装或者双击C:\SuperMap\SuperMap iClient\SuperMap iClient3D for
Plugin下rege.bat即可。
2、插件被拦截点击地址栏最右侧允许即可。
3、39以上版本默认关闭插件功能，使用下面方法开启：在地址栏输入"chrome://flages/#enable-npapi "回车启用npapi即可。
1: 使用高版本IE浏览器时，建议添加兼容代码，如下：
修改注册表[HKEY_CURRENT_USER\Software\Microsoft\Internet\Explorer\Main]下的：
三维插件客户端使用不稳定，其可能原因大致有以下几点：
·
(1)、模型、矢量数据推荐使用s3m格式缓存
·
(2)、影像数据推荐全球剖分的jpg_png格式
·
(3)、 地形图层推荐使用Tin缓存
注：详细生成及其设置见《SuperMap_iClient3D发布流程文档v1.0》
·
(1)、树、小品等建议最大可见距离建议不超过600米
·
(2)、建筑建议最大可见距离建议不超过1500米
·
(3)、地板建议最大可见距离不超过2500米
·
(4)、地形影像可以不设置
·
注：此方式适用于8.1版本和8.1之前版本
·
(1)、数、小品等建议设置为默认的0.3—0.5倍
·
(2)、建筑建议设置为默认的0.5—1倍
·
(3)、地板采用默认可以不设置
在隐藏图层的同时调用autoRelease接口，当隐藏图层时可以快速的释放内存
图层服务就是带有风格的特殊图层，使用图层服务场景加载快、资源占用少。
接口： Layer3Ds.addLayerService(string,string,string,string,Layer3DType);
在双显卡机器确认是否使用了集成显卡，如果是双显卡机器建议使用独立显卡。切换独立显卡方式见：链接
客户端浏览模型数据集时可能会导致浏览器崩溃，且浏览数据集时需iserver动态生成模型缓存，耗时长，推荐使用缓存数据发布服务。
在网络状态不稳定时，造成下载到本地缓存数据不完整，待下次打开场景将优先使用本地缓存，有可能导致浏览器崩溃。因此需要删除本地缓存重新下载。本地缓存存放路径如下：
·
Windows 7系统： %USERPROFILE%\AppData\LocalLow\SuperMap
·
Windows XP系统：%USERPROFILE%\LocalSetting\SuperMap
一般此类错误经常发生在某个固定位置，需要确定数据方面的原因。
·
确认系统是否安装了显卡驱动，可打开设备管理器查看。
·
检查显卡驱动是否为系统自带的显卡驱动，建议卸载该自带驱动，重新下载安装符合本机的显卡驱动程序。
·
·
【BIOS设置】进入BIOS（基本输入输出系统），在Config >
Display > Graphics Device下选择 NVIDIA Optimus(双显卡智能切换) 。
·
【NVIDIA显卡】在桌面点击鼠标右键选择“NVIDIA控制面板”，在“3D设置”下点击“管理3D设置” 在“全局设置”选项卡下“首选图形处理器”选择“高性能NVIDIA处理器”；
在“程序设置”选项卡下“1.选择要自定义的程序”选择浏览器，再在“2.为此程序选择首选的图形处理”下选择“高性能NVIDIA处理器”；逐个为不同浏览器设置（注意：ie浏览器首选图形处理器为“集成图形”，不可更改。）。
·
·
·
【ATI显卡】在桌面点击鼠标右键选择“配置可交换显示卡”，对话框中“选择图形处理单元”设置为“高性能GPU”。
·
A:首先这是IE保护用户电脑免于安装未知控件的的一种安全策略，其次我们的三维插件是以ActiveX的形式提供给用户的，所以如果您想使用我们的demo和samplecode，则请您在消息栏上右键，选择“允许阻止的内容”，这样才可以正常使用我们的demo和samplecode。
A: 在部署客户端时默认采用微软雅黑字体库，因为版权问题，本字体库不能随安装包一同分发 ，所以当用户的机器上没有安装微软雅黑字体库时，客户端会采用黑体等其他字体来替代默认的微软雅黑字体库，这样就有可能导致显示的字体效果不美观。
A: 为了保证客户端的浏览速度，要求发布数据 文件大小尽量不要超过3MB，因为在浏览数据的时候客户端需要对数据进行解析处理，如果数据量比较大则会比较耗费时间，影响用户体验。
A: KML/KMZ数据无版本信息，所以不支持版本更新；其他类型数据需要通过调用updateCacheFile接口，或者手动删除缓存文件，以达到更新数据的目的。
A:用户可以通过客户端的日志文件来确认问题的所在。默认情况下日志文件并不会生成，需要用户手动修改安装目录下的SuperMap.xml文件来获得。将SuperMap.xml文件<LogEnabled></LogEnabled>标签中的false值更改为true即可实现日志文件的开启，生成的日志文件将存放在客户端安装目录下。
A:在将二维对象拉伸为三维对象时，首先需要设置高度模式，关于高度模式的说明可以参见专题文档《高度模式》。并且在设置矢量面图层的风格时，矢量面图层的高度模式只能设置为地表层高度模式（ClampToGround）。在设置完高度模式之后，再设置拉伸的高度就会有效果了。
A:SuperMap iClient3D for Plugin对显卡要求比较高，以下情况下都可能会导致三维球体显示出现异常。
·
用户显卡驱动未更新，OpenGL版本在1.5以下。
·
在OpenGL软件仿真模式下运行客户端，包括使用虚拟机及远程连接状态下。
·
用户电脑的硬件加速未打开。
·
用户电脑的颜色设置不是32位真彩色。
A:不支持，解决办法将模型数据与 KML 数据一起打包成 Zip 文件，将打包后的文件以 KMZ 格式发布，其中模型数据的路径使用相对路径。
A: 发布的场景如果使用模型数据集，当客户端浏览时iserver需要动态生成模型缓存，这样花费的时间较长，建议发布的场景使用缓存数据。7C及后续版本将不再支持模型数据集的发布。
A: 可能与网卡IPV6协议有关，解决办法：1、卸载网卡的IPV6协议。2、修改hosts文件（添加127.0.0.1 localhost）。3、使用IP或者127.0.0.1访问。
A:从7.1版本开始客户端更换了新的javascript二维脚本库，原有ajax的二维脚本不再使用。新的使用方法请参看二维客户端的JavaScript帮助文档。