室内三维场景免费离线三维场景部署本地运行-室内三维场景示例本地运行方法步骤

注意:请保证下载使用的是最新的SDK和DEMO例子文档到本地. 前往下载示例


1.请先登录帐号后,下载相关DEMO例子文档到本地,如下图所示,文件夹结构说明: 室内三维场景例子文件夹结构

2.下载运行例子请放到IIS、Tomcat、NodeJs等服务器目录下,通过浏览器访问http:// ip或者网址来查看,直接双击网页文件是查看不了的!!!


3.进入会员中心我的室内三维场景,下载您自己的室内三维场景离线三维场景包.
我的室内三维场景下载室内三维场景

4.下载您自己的室内三维场景离线三维场景包解压后,直接拷贝三维场景数据文件夹(不是单个文件)放到data目录下(不是放10005目录下替换).
室内三维场景例子配置新三维场景

5.在室内三维场景初始化参数里面请配置token:'您的三维场景TOKEN', (注意要有逗号) 参考页面


6.打开离线三维场景map.openMapById('10005');这里注意是字符串,需要有''。


7.SDK目前不支持用require js引用,只能使用<script src="./esmap.min.js"></script >引用


8.如果发现三维场景还是旧的,或者样式出错,请参考离线部署清除浏览器缓存方法


如何配置在Tomcat、NodeJs、IIS、Springboot、SSM等服务器下

此类服务器只需要拷贝到网站发布的目录下就可以了,然后通过http:// 您的服务器ip/三维场景网页.html。

浏览器调试方法

请使用chrome浏览器或者火狐浏览器,然后按F12或者如下图所示位置方法,查看console控制台报了什么错误,方便分析问题。
室内三维场景浏览器F12调试

如何配置在IIS下运行

tomcat下配置.esmap文件类型

如果在tomcat下访问.esmap文件为404状态,说明找不到文件,先确认访问服务器文件夹路径下有三维场景文件,然后需要在tomcat/conf/web.xml里面配置

<mime-mapping>
    <extension>esmap</extension>
    <mime-type>application/octet-stream</mime-type>
</mime-mapping>
<mime-mapping>
    <extension>gltf</extension>
    <mime-type>application/octet-stream</mime-type>
</mime-mapping>
易景三维场景tomcat开启gzip方法1

Springboot项目或者SSM项目需要注意事项

三维场景相关的文件只能在web的静态文件目录,打包过程如果有做文件类型过滤需要保证.esmap .bin文件被打包进jar或war,三维场景数据文件中有${key}这样的配置,maven在打包项目的时会替换文件中${key}。如果.esmap .bin文件中${key}被替换会导致文件变大或变小,浏览器端三维场景无法显示。

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
    </plugins>

    <resources>
    <resource>
        <directory>src/main/resources</directory>
        <excludes>
            <exclude>**/*.esmap</exclude>
            
            <exclude>**/*.bin</exclude>
        </excludes>
        <filtering>true</filtering>
    </resource>
        
    <resource>
        <directory>src/main/resources</directory>
        <includes>
            <include>**/*.esmap</include>
            
            <include>**/*.bin</include>
        </includes>
        <filtering>false</filtering>
    </resource>
    </resources>
</build>

如果觉得三维场景加载速度有些慢,请服务器开启gzip压缩

服务器开了gzip压缩,这样文件传输占用带宽就会小很多.

tomcat下配置开启gzip压缩方法


在server.xml里面配置
<Connector port='9090' protocol='HTTP/1.1'
        connectionTimeout='20000'
        redirectPort='9443' 
        URIEncoding='UTF-8' 
        compression='on'
        compressionMinSize='1024'
        noCompressionUserAgents='gozilla,traviata'
        compressableMimeType='image/bmp,image/png,text/html,text/xml,text/javascript,application/javascript,application/octet-stream,text/css,text/plain'
        useSendfile='false'/>
易景三维场景tomcat开启gzip方法2