---

一、xml参数

1、<env>全局参数设置

名称	说明	FLASH	HTML5
autoRotateStart	是否初始自动旋转，true为是，false为不是；可缺省，不设置此行即为false；	√	√
autoRotateOnIdle	是否空闲自动旋转，true为是，false为不是；可缺省，不设置此值即为false；	√	√
autoRotateDelay	空闲自动转动的时间间隔，单位为秒，默认值为5；	√	√
rate	自动旋转速度，设置范围为大于0的小数和整数，合适的范围0-2，数值越大，速度越快；	√	√
dragRate	鼠标拖拽速度，设置范围为大于0的小数和整数，合适的范围为0-2，数值越大，拖拽的旋转速度越快；	√	√
hotspotInfo	是否显示热点注释信息，true为是，false为不是（鼠标移上去时显示）；可缺省，不设置此属性即为false；	√	√
playList	自动旋转时，是否按列表播放，true为是，false为只播放当前场景；	√	√
bgSound	全局背景音乐，不会随场景切换而更改。添加一个全局背景音乐：<bgSound file="img/you.mp3" loop="true" volume="1" />	√	√
planetStart	初始是否显示小星球效果过度动画，是为true，否未false	×	√
vrStart	初始是否VR双眼模式，是为true，否为false	√	√

 

2、<vr>全景视窗参数：

名称	说明	FLASH	HTML5
startpano	设定最初开始播放的全景名称（全景的唯一标识name）	√	√

 

3、<pano>全景场景设置

<pano>是<vr>的子标签。

名称	说明	FLASH	HTML5
name	全景唯一标识	√	√
type 全景图的类型	sphere               球形全景图；	√	√
	cubetile        立方体六个面的切片形式	√	√
	cubestrip           立方体长条形，横向或纵向；（iOS等移动平台限制了单个图像的分辨率，此类型容易超出限制而出现错误）	√	√
url	全景图路径。若为立方体6面形式,路径比如写为：images/0/pano_*.jpg，则分别表示以下6张图： pano_f.jpg (前) pano_r.jpg (右) pano_b.jpg (后) pano_l.jpg (左) pano_u.jpg (上) pano_d.jpg (下)	√	√
preview	全景预览图地址，立方体类型全景图只能用长条形作为预览图	√	√
thumb	全景图对应的缩略图地址，如果使用缩略图导航，此项不可缺少；	√	√
mapX	与该全景图对应的地图上的热点x坐标；如果使用百度地图，则为纬度。	√	√
mapY	与该全景图对应的地图上的热点y坐标；如果使用百度地图，则为经度。	√	√
heading	地图热点与全景匹配角度，首先保证地图是按照上北下南制作的。 数值为：全景图实际场景中，正南向的u值；可参考UV系统图。   获取参数方法一：直接查看全景图，找出正南向的位置，根据UV系统图确定这一数值；   获取参数方法二：采用FreeTour软件，把全景图添加进去，并选择，直接拖拽旋转即可获得正南向的角度值。 UV系统图 以上mapX、mapY、heading三个参数是地图导航相关的参数，如果使用地图导航，不可缺少。如果不用地图导航，则不需要设置。	√	√
pan	场景初始显示时的横向视角，从全景图的最左边到最右边，依次是-180 – 0 - 180度。参考UV系统图。	√	√
fov	默认视角范围，设置范围20-130度，可缺省，默认为70；	√	√
fovMax	最大视角范围，取值为20-130，可缺省，默认为130；	√	√
fovMin	最小视角范围，取值为20-130，可缺省，默认为20；	√	√
tilt	场景初始显示时的纵向视角，全景图原图从下到上，对应-90度至90度，可缺省，默认为0；	√	√
tiltMax	纵向向上的最大角度；取值范围：大于0小于90，可缺省，默认为90；	√	√
tiltMin	纵向向下的最大角度；取值范围：小于0大于-90，可缺省，默认为-90；	√	√
title	全景的标题，显示在地图和索引图导航中；	√	√
info	全景的描述文字，在信息面板中显示，支持html；	√	√

                 

4、<hotspot>热点设置

<hotspot>是<pano>的子标签。
添加一个<hotspot/>标签则意味着在场景中添加一个热点、热区。
 

名称	说明	FLASH	HTML5
type	热点和热区类型，共有2种，分别是spot、area   spot          热点，大小不随场景放缩而变化； 可以设置jpg\gif\png\swf文件为热点标识； area        热区   若为热区类型，则加入vertex子标签设置闭合多边形热区的各个顶点坐标：<vertex u="-25.44" v="-3.38"/>，u和v分别是各个点的UV值	√	√
file	热点标识的外部引用文件；	√	√
u	热点在场景中横向上的角度，参考UV系统图；	√	√
v	热点在场景中纵向上的角度，参考UV系统图；	√	√
title	热点的注释信息标题	√	√
action	热点点击后的动作类型，其值可以设定为： toPano               切换全景图；	√	√
	toURL                打开超链接；	√	√
	toShow         在全景视窗内打开子窗口载入文字、图片、视频、DIV或其他HTML内容，HTML5版本另外还可以指定显示网页上某id的元素里的内容；	√	√
url	热点的目标，可以是     1、全景图名称（action=”toPano” url=”b”）	√	√
	2、超链接地址（action=”toURL” url=”http://www.86rm.com” target=”_blank”）	√	√
	3、图片、动画、视频的加载地址（action=”toShow” url=”image.jpg”） action=”toShow”情况下，如果设置了url，则打开的子窗口加载url设置的加载地址内容；	√	√
target	只适用打开超链接toURL，等同于html中的超链接的target，可以设置为：_self 、_blank、_parent等值。	√	√
color	颜色值，6位色值；适用于热区	√	√
alpha	颜色的透明度，范围0-1，0为完全透明，1为完全不透明；适用于热区	√	√
windowWidth	子窗口的宽度	√	√
windowHeight	子窗口的高度	√	√
windowTitle	子窗口显示标题，支持HTML	√	×
windowColor	子窗口背景渐变色一，默认值：FFFFFF，HTML5版默认值EAECF0	√	√
windowAlpha	子窗口背景透明度，默认值：1	√	√
windowType	子窗口加载的内容类型：image、iframe、html	√	√

5、sound标签，添加一个场景音频

<sound>是<pano>的子标签。
添加一个<sound>标签则意味着在场景中添加一个场景音频。
 
<sound file="img/qinghua.mp3" volume ="0.8" repeat="10" />
 

file	声音文件地址	√	√
volume	音量	√	√
repeat	重复播放次数	√	√

 
 

6、<panoGroup>分组标签

<group>是<panoGroup>的子标签。
添加一个<group/>标签表示设置一个全景组。
<group name="分组1" pano="0,1,2,3,4,5"/>
 

name	组的名称，会显示在缩略图导航的上方	√	√
pano	包含的全景的name，每个name之间使用小写逗号分隔	√	√

 
 

7、<map> 地图导航设置

         <map>是<ui>的子标签。
如果要使用地图导航，在config.xml里加入此块，否则，省略此块内容：

7.1本地地图

         <map plugin="map.swf" file="img/map1.png" type="local" width="30%" height="100%" x="70%" y="0" radarColor="FFFFFF"  radarSize="75"  scrollBar="false" initialShow="true" hotspot="img/hotspot.gif" activeState="img/active.gif">
         </map>
 
详细参数描述：
map 标签：

名称	说明	FLASH	HTML5
plugin	地图导航插件，FLASH版本是map.swf或baidu.swf文件的路径，HTML5版本，本地地图和百度地图都不需要引用外部插件，所以可不用设置。	√	×
file	本地地图图片地址	√	√
type	地图类型，local：本地地图；baidu：百度地图	√	√
width	地图显示的宽度，可以是正数值或者百分比	√	√
height	地图显示的高度，可以是正负数值或者百分比	√	√
x	地图在界面上显示的x坐标，单位为像素，以地图中心点为基准点，值为正负数字或百分比，正数为离开左边的距离，负数为离开右边的距离，百分比为舞台宽度的百分比；	√	√
y	地图在界面上显示的y坐标，单位为像素，以地图中心点为基准点，值为正负数字或百分比，正数为离开上边的距离，负数为离开下边的距离，百分比为舞台高度的百分比；	√	√
initialShow	初始是否显示，true为显示，false为隐藏；	√	√
radarColor	设置雷达的颜色，六位16进制颜色值，如FFFFFF；	√	√
radarAlpha	雷达透明度，取值0-1，默认值0.5	√	√
radarSize	设置雷达的尺寸，整数值，FLASH版本默认值75；HTML5版本默认值100；	√	√
scrollBar	地图面板是否显示滚动条，true为显示，false为隐藏；	√	√
hotspot	地图上的热点的标识图（jpg\png\gif\swf）；	√	√
activeState	切换到此热点时显示的热点标识图（jpg\png\gif\swf）；	√	√

                           

7.2百度地图

         <map file="baidu.swf" type="baidu" width="30%" height="100%" x="70%" y="0" initialShow="true" radarColor="FFFFFF" radarSize="100" hotspot="img/image1.png" activeState="img/image2.png" mapType="3" zoom="16" >
         </map>
 
    详细参数描述：
         map 标签：
                   除以下参数外，所有参数与本地地图的参数设置一致。

名称	说明	FLASH	HTML5
mapType	初始显示的地图类型，取值分别是对应4种地图类型： 1：平面地图  2：卫星地图  3：混合地图 4：3D地图	√	√
zoom	地图初始显示的放缩级别。	√	√

8、<thumb> 缩略图导航设置

         <thumb>是<ui>的子标签。
如果要使用索引图导航，在config.xml里加入此块，否则省略此块内容：
 
         <thumb plugin="thumb.swf" width="810" height="100" x="14" y="12" imageWidth="90" imageHeight="60" bgColor="000000" bgAlpha="0.6" left="img/thumbleft.png" right="img/thumbright.png" border="img/thumbborder.png" initialShow="true">
         </thumb>
 
 
详细参数描述：
thumb标签：
 

名称	说明	FLASH	HTML5
plugin	索引图导航程序thumb.swf路径	√	×
width	导航显示的宽度	√	√
height	导航显示的高度	√	√
x	导航在界面上显示的x坐标，单位为像素，以导航中心点为基准点，值为正负数字或百分比，正数为离开左边的距离，负数为离开右边的距离；百分比则为缩略图中央处于窗口横向的位置百分比。	√	√
y	索引图在界面上显示的y坐标，单位为像素，以导航中心点为基准点，值为正负数字或百分比，正数为离开上边的距离，负数为离开下边的距离；百分比则为缩略图中央处于窗口纵向的位置百分比。	√	√
imageWidth	每个缩略图的宽度，默认值120	√	√
imageHeight	每个缩略图的高度，默认值80	√	√
bgColor	缩略图导航的背景色，6位数色值，如：FFFFFF	√	√
bgAlpha	缩略图导航的背景透明的，值为0至1	√	√
left	指定左滑动箭头的标识路径	√	√
right	指定右滑动箭头的标识路径	√	√
border	当前全景对应缩略图的激活边框的文件路径	×	√
initialShow	初始是否显示，true为显示，false为隐藏；	√	√

                           

9、<control> 控制面板的设置

         <control>是<ui>的子标签。
如果要使用控制面板，在config.xml里加入此块，否则省略此块内容：
 
         <control file="bg.png" width="100%" height="50" x="50%" y="-60" fileWidth="128" fileHeight="576" buttonWidth="64" buttonHeight="64" buttonScale="0.5" bgColor="000000" bgAlpha="0.6" initialShow="false" />
 
   详细参数描述：

名称	说明	FLASH	HTML5
file	控制面板按钮图片地址，所有按钮都按同一尺寸放在一个图片上	√	√
width	控制面板的宽度，单位像素或百分比	√	√
height	控制面板的高度，单位像素	√	√
x	控制面板在界面上显示的x坐标，以控制面板中心点为基准点，可以是百分比和正负数字，百分比为50%，则居中；正负数字单位为像素，正数为离开左边的距离，负数为离开右边的距离；	√	√
y	控制面板在界面上显示的y坐标，以控制面板中心点为基准点，正负数字单位为像素，正数为离开上边的距离，负数为离开下边的距离；	√	√
fileWidth	按钮底图的原始宽度	√	√
fileHeight	按钮底图的原始高度	√	√
buttonWidth	按钮原始宽度	√	√
buttonHeight	按钮原始高度	√	√
buttonScale	按钮的缩放比例，如iphone\ipad等高清屏幕，一般设置按钮图片按0.5比例缩小显示	√	√
bgColor	控制面板背景颜色，6位色值，如：FFFFFF	√	√
bgAlpha	控制面板背景透明度，值为0至1	√	√
initialShow	初始是否显示，true为显示，false为不显示	√	√

 
 
<button>标签是<control>标签的子标签，每个button标签设置一个按钮；
<button x="0" y="128" align="center" action="left" url="null"/>
 

x	按钮在底图上的坐标x，以按钮左上角为基准点		√	√
y	按钮在底图上的坐标y，以按钮左上角为基准点		√	√
align	控制面板分3个区域，分别为左中右，设置按钮放置在哪个区域，取值：left、center、right		√	√
action	设置按钮的动作		√	√
	left	左转	√	√
	right	右转	√	√
	up	上转	√	√
	down	下转	√	√
	zoomin	放大	√	√
	zoomout	缩小	√	√
	full	全屏	√	√
	eixtFull	退出全屏	√	√
	prev	上一个全景	√	√
	next	下一个全景	√	√
	thumb	显示/隐藏缩略图	√	√
	map	显示/隐藏地图	√	√
	show	显示控制面板	√	√
	hide	隐藏控制面板、缩略图导航和地图	√	√
	gyro	陀螺仪浏览模式开启	√	√
	exitGyro	陀螺仪浏览模式关闭	√	√
	vr	进入VR模式	√	√
	exitVr	退出VR模式	√	√
	toPano	打开一个全景	√	√
	toURL	打开一个链接	√	√
	toShow	打开子窗口	√	√
	soundOn	打开声音	√	√
	soundOff	关闭声音	√	√
url	当按钮动作为toPano、toURL、toShow时，打开的全景名称或目标文件		√	√

        
 

10、<face>界面元素的添加

<face>是<ui>的子标签。
使用face标签可添加多个界面元素或HTML，并可以添加多种点击事件。
 
<face type=”image” file="control/86rm.gif" x="10" y="10" action="toURL" url=”http://www.86rm.com”  target=”_blank”/>
 
         详细参数描述：

名称	说明	FLASH	HTML5
file	要添加的界面元素文件路径，如果是div类型，则为#加上DIV的ID	√	√
scale	设置界面元素的放缩比例0-1，如iphone等高清屏幕，一般设置为0.5	√	√
x	界面元素在界面上显示的x坐标，以界面元素中心点为基准点，可以是百分比和正负数字，百分比为50%，则横向居中；正负数字单位为像素，正数为离开窗口最左边的距离，负数为离开窗口最右边的距离；	√	√
y	界面元素在界面上显示的y坐标，以界面元素中心点为基准点，可以是百分比和正负数字，百分比为50%，则纵向居中；正负数字单位为像素，正数为离开最上边的距离，负数为离开最下边的距离；	√	√
action	同控制面板按钮的action完全相同，共23种动作。	√	√
url	同控制面板按钮的url完全相同。	√	√

                  

11、<info>信息面板

<info>是<ui>的子标签
使用<info>标签添加信息面板到界面上，动态显示全景的标题和信息内容；
 
<info width="400" height="200" x="10" y="10" fontSize="16" fontColor="FFFFFF"/>
 

名称	说明	FLASH	HTML5
width	信息面板的宽度	√	√
height	信息面板的高度	√	√
x	X位置	√	√
y	Y位置	√	√
fontSize	字体大小，单位像素	√	√
fontColor	字体颜色，6位色值，如：FFFFFF	√	√

 

12、<window>子窗口关闭按钮

<window>是<ui>的子标签
设置子窗口的关闭按钮的图片地址，仅HTML5版本需要设置此标签。
 
<window close="img/close.png"/>
 

名称	说明	FLASH	HTML5
close	关闭按钮的图片路径，如果不设置此标签，则会默认调用”control/close.png”这个路径	×	√

 

二、与外部程序通信交互的参数：

    可以在网页上通过js与程序进行通信和交互，从外部控制程序中的一些操作命令，如播放、停止播放、左转、右转、向上、向下、放大、缩小、热点开关、声音开关、切换全景等，具体参见案例webapi.html的演示和网页代码。

名称	说明	FLASH	HTML5
changePano	外部切换全景的方法，参数为全景的name	√	√
toPano	外部操作全景交互，参数如下： play                             播放                    pause                          停止播放                    zoomInDown             开始放大                    zoomInUp                  停止放大                    zoomOutDown         开始缩小                    zoomOutUp               停止缩小                    leftDown                    开始左转                    leftUp                          停止左转                    rightDown                 开始右转                    rightUp                       停止右转                    upDown                      开始上转                    upUp                           停止上转                    downDown                开始下转                    downUp                      停止下转                    info                              打开信息面板                    help                             打开帮助面板                    hotspot                       开关热点显示                    sound                          开关声音	√	√
sendToJS	全景传递出的信息描述（info）	√	√
rotateLeft	左转一定角度，参数为度数	×	√
rotateRight	左转一定角度，参数为度数	×	√
rotateUp	左转一定角度，参数为度数	×	√
rotateDown	左转一定角度，参数为度数	×	√
showHideHotspot	显示隐藏当前场景中的某个热点，参数为热点在当前场景中的序号0 - n	×	√
playAudio	播放暂停设置的背景声音	×	√

 

---