detuPanorama

来自于:开发者立即使用

open close hide show

概述

detuPanorama 封装了得图全景SDK,得图云专注于360全景影像领域,立志为用户提供完整一站式全景平台服务。平台基于自主研发的detu pano全景技术结合平台服务模式,降低用户的全景使用成本,让更多行业和用户利用全景技术提升网站展示效果。想要更详细的了解请参考以下网址:

open

打开全景播放器

open({params}, callback(ret))

params

x:

  • 类型:数字
  • 描述:(可选项)模块左上角的 x 坐标(相对于所属的 Window 或 Frame)
  • 默认值:0

y:

  • 类型:数字
  • 描述:(可选项)模块左上角的 y 坐标(相对于所属的 Window 或 Frame)
  • 默认值:0

w:

  • 类型:数字
  • 描述:(可选项)模块的宽度
  • 默认值:当前设备屏幕的宽度

h:

  • 类型:数字
  • 描述:(可选项)模块的高度
  • 默认值:当前设备屏幕的高度

type:

  • 类型:字符串
  • 描述:(可选项)展示类型
  • 默认:sphere
  • 取值范围:
    • sphere: 360度全景图
    • cube: 六面图,ios暂不支持

imgPath:

  • 类型:字符串
  • 描述:要展示的 360 度全景图片的路径(支持widget://(Android暂不支持) fs:// http://)
  • 使用规则见下方 :”imgPath使用规则”

useGyro:

  • 类型:布尔
  • 描述:(可选项)是否使用陀螺仪
  • 默认值:false

fixedOn:

  • 类型:字符串类型
  • 描述:(可选项)模块视图添加到指定 frame 的名字(只指 frame,传 window 无效)
  • 默认:模块依附于当前 window

fixed:

  • 类型:布尔
  • 默认值:true
  • 描述:(可选项)是否将模块视图固定到窗口上,不跟随窗口上下滚动

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. eventType : 'show' // 字符串类型;取值范围:
  3. // show 表示视图打开成功
  4. }

imgPath使用规则

(1) 当type = sphere时需要传入360全景图片

(2) 当type = cube时(iOS暂不支持),该地址为通配地址,地址中必须包含 %s,如下:

  1. widget://image/img_%s.jpg,widget://image 目录下要包含如下六张图片,
  2. widget://image/img_f.jpg 前
  3. widget://image/img_u.jpg 上
  4. widget://image/img_b.jpg 后
  5. widget://image/img_l.jpg 左
  6. widget://image/img_r.jpg 右
  7. widget://image/img_d.jpg 下

(3) 当type = cube时(iOS暂不支持),fs:// http:// 路径配置同上

示例代码

  1. var panorama = api.require('detuPanorama');
  2. panorama.open({
  3. x: 0,
  4. y: 64,
  5. w: api.winWidth,
  6. h: 300,
  7. imgPath: 'widget://res/img/ic/360viewtest.jpg',
  8. fixedOn: api.frameName,
  9. fixed: true
  10. }, function(ret, err) {
  11. if (ret) {
  12. alert(JSON.stringify(ret));
  13. }
  14. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

close

关闭全景展示视图

close()

示例代码

  1. var panorama = api.require('detuPanorama');
  2. panorama.close();

可用性

iOS系统,Android系统

可提供的1.0.1及更高版本

hide

隐藏全景展示视图。隐藏视图,并没有从内存里清除

hide()

示例代码

  1. var panorama = api.require('detuPanorama');
  2. panorama.hide();

可用性

iOS系统,Android系统

可提供的1.0.1及更高版本

show

显示全景展示视图,显示已隐藏的视图

show()

示例代码

  1. var panorama = api.require('detuPanorama');
  2. panorama.show();

可用性

iOS系统,Android系统

可提供的1.0.1及更高版本