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 对象
  • 内部字段：
{
    eventType : 'show'       // 字符串类型；取值范围：
                            // show 表示视图打开成功
}

imgPath使用规则

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

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

widget://image/img_%s.jpg，widget：//image 目录下要包含如下六张图片，
widget://image/img_f.jpg 前
widget://image/img_u.jpg 上
widget://image/img_b.jpg 后
widget://image/img_l.jpg 左
widget://image/img_r.jpg 右
widget://image/img_d.jpg 下

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

示例代码

var panorama = api.require('detuPanorama');
panorama.open({
    x: 0,
    y: 64,
    w: api.winWidth,
    h: 300,
    imgPath: 'widget://res/img/ic/360viewtest.jpg',
    fixedOn: api.frameName,
        fixed: true
}, function(ret, err) {
    if (ret) {
        api.alert({
            msg: JSON.stringify(ret)
        })
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

close

关闭全景展示视图

close()

示例代码

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

可用性

iOS系统，Android系统

可提供的1.0.1及更高版本

hide

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

hide()

示例代码

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

可用性

iOS系统，Android系统

可提供的1.0.1及更高版本

show

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

show()

示例代码

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

可用性

iOS系统，Android系统

可提供的1.0.1及更高版本

是否仍需要帮助？ 请保持联络！
最后更新于 2024/11/18