Panorama~Panorama(container, options, callback)

全景图实现主类,负责实现全景图的加载,渲染

Summary

Methods:
changePanorama

切换全景图

getStereoViewEnabled

获取立体状态是否开启

print

打印全景图

setStereoViewEnabled

开启/关闭立体视图

Constructor

new Panorama(container, options, callback)

Parameters:
Name Type Description
container HTMLElement | String

全景图容器,div元素容器或者容器id

options Object

构建参数,构建参数分为两大类,全局配置参数和全景配置参数

Name Type Attributes Description
panoramaUrl String

平台的全景服务地址或者单张全景图图片的URL地址

previewUrl String <optional>

预览图片路径

tileUrl String <optional>

全景图切片地址,当切片地址设置的时候会优先加载切片地址

enablePan Boolean <optional>

控制是否可以平移,默认true

enableZoom Boolean <optional>

控制是否可以缩放,默认true

zoom Number <optional>

初始显示级别 zoom的范围为[1,100],默认35

minZoom Number <optional>

控制可以缩放的最小级别 默认为10

maxZoom Number <optional>

控制可以缩放的最大级别 默认65

longitude Number <optional>

初始中心点经度,使用弧度,范围为[0,2π]备注:不是地理坐标系的经度

latitude Number <optional>

初始中心点纬度,使用弧度,范围为[-π/2,π/2] 备注:不是地理坐标系的纬度

longitudeRange Array.<Number> <optional>

控制水平面旋转范围,默认 '',可以无限制旋转,可设置范围[0,2π]

latitudeRange Array.<Number> <optional>

控制垂直面旋转范围,默认 '',可以无限制旋转,可设置范围[-π/2,π/2],

planetAnimation Boolean <optional>

是否开启小行星动画,默认true

planetDuration Number <optional>

小行星动画旋转持续时间,默认2.5秒

planetDelayTime Boolean <optional>

小行星延迟动画时间,即在这个时间之后才开始小行星旋转,默认2秒

planetRotateTwoPI Boolean <optional>

小行星动画是否需要旋转一周,默认true

loading Object <optional>

加载loading组件

Name Type Attributes Description
img String <optional>

加载组件的图片

msg String <optional>

加载组件的文字

element String <optional>

加载组件的html片段

autoRotate Boolean | Object <optional>

是否开启自动旋转(默认关闭),如果需要配置个性化时间,请配置相关参数{stopDelay:1,inactivityDelay:10},直接传入对象即可
stopDelay用户自动加载全景之后多少秒之后开启自动旋转,默认1秒,inactivityDelay 用户活动停止后多少秒后开启自动旋转,默认10秒

backgroundColor String <optional>

设置场景的背景颜色,用户在开启水晶球时会显示背景颜色,默认是‘#ffffff’,

backgroundImg string <optional>

设置场景的背景图片,用户在开启水晶球时会显示背景图片,背景图片的优先级高

callback function

全景图初始化回调函数,全景图其他逻辑的编写都要在回调函数中开始执行。默认执行函数:控制台输出"The panorama is completed!"

Throws:
  • 当浏览器不支持canvas抛出错误

  • 当没有传全景图图片时候抛出错误

  • 当div容器没有传入的时候

Methods

changePanorama(params, optionsopt)

切换全景图

Parameters:
Name Type Attributes Description
params Object

切换场景需要的参数,参照new Panorama的参数设置

options Object <optional>

场景切换参数

Name Type Attributes Description
transition Boolean <optional>
way String <optional>

动画切换方式 目前包含 'normal'(普通)||'zoom'(缩放)||'circle'(圆形)||'rhombus'(菱形消失)||'cross'(十字展开)||'leftToRight'(从左向右)||
'rightToLeft'(从右向左)||'noise'(噪声消失)||'split'(分割,从中间擦除)||'clock'(时钟)||'ripple'(涟漪)||'dissolve'(溶解)||'pageTurn'(翻页),默认normal,

duration Number <optional>

动画持续时间,使用秒为单位,默认1s

showPreview Boolean <optional>

是否显示预览图,开启切换动画的时候强制为false

showLoad Boolean <optional>

是否显示loading,开启切换动画的时候强制为false

showLoadTime Boolean <optional>

设置加载动画的显示时间,默认1s 使用秒为单位,注意预览图和loading动画都会按照这个值消失

clear Boolean <optional>

切换场景的时候是否默认删除当前场景的点线面,弹窗,视频投影等效果,默认true

Throws:

当全景图参数配置不正确的时候,抛出异常

getStereoViewEnabled() → {Boolean}

获取立体状态是否开启

Returns:
Boolean

print()

打印全景图

setStereoViewEnabled(enable)

开启/关闭立体视图

Parameters:
Name Type Description
enable Boolean