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

常见问题解答(FAQ)

1、产品安装类

安装64位与32位三维客户端

A: 若需要同时安装64位与32位的插件客户端，推荐首先安装64位，再安装32位三维插件客户端，否则Chrome等浏览器不能正常打开场景。

安装三维插件客户端时失败，或提示OpenGL版本低

A:安装失败时，请暂时不关闭安装失败界面的提示，否则安装程序将回退而无法检查安装目录的情况。

1. 请检查本机是否已经安装显卡驱动；

2. 检查是否缺少库文件：使用桌面提供的工具，在SuperMap iDesktop 8C > Tools文件夹下双击“DEPENDS.EXE”，点击“open”按钮打开安装路径(C:\SuperMap\SuperMap iClient\SuperMap iClient3D for Plugin)下的“npSuperMapRealspace.dll”文件，若缺少*.dll库文件，可到官网下载相应库文件。

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"即可。

2、浏览器相关类

Firefox浏览器

目前Firefox对三维插件客户端的支持相对较差，在不指定浏览器的情况下建议更换为其他浏览器。

在Firefox 中无法浏览三维场景

A: 使用Firefox浏览场景需要手动设置环境变量，解决办法为将“C:\SuperMap\SuperMap iClient\SuperMap iClient3D for Plugin”放到path的最前边。

使用Firefox 浏览三维场景性能较慢

A: 使用Firefox浏览三维场景时与网页其他控件交互会变慢，建议使用Chrome、IE、Opera等其他浏览器。

Chrome浏览器

Chrome支持的版本

1、44以上版本已经不再支持插件功能，请使用44以前版本。

2、三维插件客户端不支持64位chrome。

安装完客户端插件后chrome仍然不出球或提示没安装插件？

1、安装三维插件客户端时需要关闭chrome，是否安装时未关闭。关闭chrome后重新安装即可。

2、插件被拦截点击地址栏最右侧允许即可。

3、39以上版本默认关闭插件功能，使用下面方法开启：在地址栏输入"chrome://flages/#enable-npapi "回车启用npapi即可。

IE浏览器

Q:使用IE11浏览器，打开示范程序没问题，却不能打开用户项目？

1: 使用高版本IE浏览器时，建议添加兼容代码，如以下：

<meta http-equiv="x-ua-compatible" content="IE=EmulateIE9" />

3、场景稳定性、性能类

三维插件客户端使用不稳定，出现了崩溃的情况？其可能原因大致有以下几点：

内存占用过大

优化场景

· (1)、模型、矢量数据推荐使用s3m格式缓存

· (2)、影像数据推荐全球剖分的jpg_png格式

· (3)、地形图层推荐使用Tin缓存

设置可见距离（根据实际需求可以适当调整）

· (1)、数、小品等建议最大可见高度为：2500米，最大可见距离建议不超过600米

· (2)、建筑建议最大可见高度为：3500米，最大可见距离建议不超过1200米

· (3)、地板建议最大可见高度为：4000米，最大可见距离建议不超过2500米

· (4)、地形影像可以不设置

设置LOD距离（根据实际需求可以适当调整）

· 注：此方式适用于8.1版本和8.1之前版本

· (1)、数、小品等建议设置为默认的0.3—0.5倍

· (2)、建筑建议设置为默认的0.5—1倍

· (3)、地板采用默认可以不设置

隐藏图层释放内存

采用加载快、资源占用少的图层服务

使用独立显卡

在双显卡机器确认是否使用了集成显卡

浏览器崩溃

检查是否发布了模型数据集

客户端浏览模型数据集时需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”。

4、其他

1. Q: 为什么每次在本地运行demo或者samplecode，IE地址栏下面都会出现一个信息栏：为了有利于保护安全性，Internet Explorer已限制此网页运行可以访问计算机的脚本或 ActiveX 控件。请单击这里获取选项...

A:首先这是IE保护用户电脑免于安装未知控件的的一种安全策略，其次我们的三维插件是以ActiveX的形式提供给用户的，所以如果您想使用我们的demo和samplecode，则请您在消息栏上右键，选择“允许阻止的内容”，这样才可以正常使用我们的demo和samplecode。

2. Q: 客户端字体显示问题。

A: 在部署客户端时默认采用微软雅黑字体库，因为版权问题，本字体库不能随安装包一同分发，所以当用户的机器上没有安装微软雅黑字体库时，客户端会采用黑体等其他字体来替代默认的微软雅黑字体库，这样就有可能导致显示的字体效果不美观。

3. Q: 为什么有时候数据加载比较慢？

A: 为了保证客户端的浏览速度，要求发布数据文件大小尽量不要超过3MB，因为在浏览数据的时候客户端需要对数据进行解析处理，如果数据量比较大则会比较耗费时间，影响用户体验。

4. Q: 数据是否支持更新？

A: KML/KMZ数据无版本信息，所以不支持版本更新；其他类型数据需要通过调用updateCacheFile接口，或者手动删除缓存文件，以达到更新数据的目的。

5. Q: 当客户端出现问题时如何进行确认？

A:用户可以通过客户端的日志文件来确认问题的所在。默认情况下日志文件并不会生成，需要用户手动修改安装目录下的SuperMap.xml文件来获得。将SuperMap.xml文件<LogEnabled></LogEnabled>标签中的false值更改为true即可实现日志文件的开启，生成的日志文件将存放在客户端安装目录下。

6 Q: 在设置矢量图层的拉伸风格时，为什么没有预期效果？

A:在将二维对象拉伸为三维对象时，首先需要设置高度模式，关于高度模式的说明可以参见专题文档《高度模式》。并且在设置矢量面图层的风格时，矢量面图层的高度模式只能设置为地表层高度模式（ClampToGround）。在设置完高度模式之后，再设置拉伸的高度就会有效果了。

7. Q: 为什么使用客户端三维球体会出现“白球”或者“黑图”现象？

A:SuperMap iClient3D for Plugin对显卡要求比较高，以下情况下都可能会导致三维球体显示出现异常。

· 用户显卡驱动未更新，OpenGL版本在1.5以下。

· 在OpenGL软件仿真模式下运行客户端，包括使用虚拟机及远程连接状态下。

· 用户电脑的硬件加速未打开。

· 用户电脑的颜色设置不是32位真彩色。

8. Q: 在 KML 中添加的模型是否支持发布？

A:不支持，解决办法将模型数据与 KML 数据一起打包成 Zip 文件，将打包后的文件以 KMZ 格式发布，其中模型数据的路径使用相对路径。

9. Q: 发布的场景使用模型数据集太慢，有时甚至无法浏览显示？

A: 发布的场景如果使用模型数据集，当客户端浏览时iserver需要动态生成模型缓存，这样花费的时间较长，建议发布的场景使用缓存数据。7C及后续版本将不再支持模型数据集的发布。

10. Q: 使用localhost无法访问场景？

A: 可能与网卡IPV6协议有关，解决办法：1、卸载网卡的IPV6协议。2、修改hosts文件（添加127.0.0.1 localhost）。3、使用IP或者127.0.0.1访问。

11. Q: 原有程序二维点、线、面代码报错？

A:从7.1版本开始客户端更换了新的javascript二维脚本库，原有ajax的二维脚本不再使用。新的使用方法请参看二维客户端的JavaScript帮助文档。