插件说明:
- •本插件实现 WebVR / MobileVR 的支持.
- •可以让全景图和全景视频在浏览器内实现3D虚拟漫游观看.
- •可以使用众多VR眼镜,如:Oculus Rift \the HTC Vive\类似放手机进去的Google Cardboard, Gear VR或国内的暴风魔镜等.
- •新版插件使用webvr浏览器api或移动端浏览器支持,结合陀螺仪传感器功能实现方向的检测.
语法:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 |
<plugin name="WebVR" devices="html5" keep="true" url="webvr.js" worldscale="1.0" mousespeed="0.00125" oversampling="1.0" headtracking="true" fullscreen_mirroring="false" mobilevr_support="true" mobilevr_ipd="63.5" mobilevr_screensize="auto" mobilevr_lens_overlap="1.0" mobilevr_lens_fov="96" mobilevr_lens_dist="0.6" mobilevr_lens_dist2="1|0|0|0" mobilevr_lens_ca="0.0" mobilevr_lens_vign="100" mobilevr_orientationlock="true" mobilevr_wakelock="true" mobilevr_sensor_mode="3" mobilevr_autocalibration="false" mobilevr_touch_support="false" mobilevr_fake_support="false" mobilevr_database_url="..." vr_cursor="" vr_cursor_enabled="true" vr_cursor_onover="" vr_cursor_onout="" onavailable="" onunavailable="" onunknowndevice="" onentervr="" onexitvr="" /> |
插件属性:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 |
•worldscale[数字型] //设置热点在vr状态下的远近程度(0.1-1.0),默认值1.0,数值越小感觉距离越近 •mousespeed[数字型] //在电脑桌面浏览器打开vr状态时,鼠标控制画面水平转动速度,如果设置为0,则无鼠标事件 •oversampling[数字型] //渲染采样系数,默认值1.0,设置更大数值需要更多的GPU运算才能显示,领主tips:如果您对画面要求较高,通知VR 眼镜性能也不错,可以适当调高该数值,从而获得更高画质 •headtracking[布尔型] //是否禁用头部跟踪,默认true, 如果设置false,则无法用陀螺仪控制方向,这样观感很差,慎用! •fullscreen_mirroring[布尔型] //设置是否投影镜像全屏,默认true, 该属性只在桌面电脑投影画面镜像时生效 •multireslock[布尔型] //多分辨率锁定,默认true,当多场景启动时,分辨率是否锁定在启动时分辨率,预览图将对分辨率插值有决定性影响 •mobilevr_support[布尔型] //设置是否在移动设备上支持vr模式,默认true •mobilevr_ipd[数字型] //设置VR模式下的瞳距(ipd),默认值63.5 •mobilevr_screensize[字符型] //设置眼镜屏幕的默认大小,默认值auto, 如果您觉得识别不准确,也可也根据手机屏幕尺寸如iPhone 5 (4"), iPhone 6 (4.7"), iPhone 6 zoomed (4.7"), iPhone 6+ (5.5"), iPhone 6+ zoomed (5.5")来设置屏幕大小,4"是4英寸的意思 •mobilevr_lens_overlap[数字型] //默认值1.0 //缩放因子镜头视场重叠值。这个值取决于镜头的距离和镜片的形状/设计 •mobilevr_lens_fov[数字型] //默认值96 //纵向视场角度。将取决于屏幕大小和透镜 •mobilevr_lens_dist[数字型] //默认值0.6 //镜头畸变强度。取值0.0 to 5.0, 0.0为没畸变 //畸变将使用kr内部鱼眼镜头投影效果实现 •mobilevr_lens_dist2[字符型] //默认值"1|0|0|0" //二次畸变设置 •mobilevr_lens_ca[数字型] //默认值0.0 //色彩校正值设置,取值: -1.0 to +1.0, 0.0=off. •mobilevr_lens_vign[数字型] //默认值100 //添加一个小插曲的阴影隐藏镜头边缘的或不需要的区域,取值: 0 to 100, 100=off. •mobilevr_orientationlock[布尔型] //默认值true. 设置是否支持锁定屏幕并定位到指定位置,该功能只支持在最新版本的原生android和firfox浏览器的api形式调用. •mobilevr_wakelock[布尔型] //默认true.尽量保持移动设备唤醒,并防止显示器开关进入休眠/待机模式. •mobilevr_sensor_mode[整型] //默认值3. 帧渲染和传感速度插值,1-7,越大渲染质量越高,反应越慢,数值越小渲染质量越小,反应越快. •mobilevr_autocalibration[布尔型] //默认false. 设置是否启动默认陀螺仪校正. •mobilevr_touch_support[布尔型] //默认false.设置是否支持vr模式下点击屏幕,默认false,因为有些眼镜支持点击情况下会错误输出. •mobilevr_fake_support[布尔型] //默认false。设置是否支持平板和桌面设备. •mobilevr_database_url[字符型] //设置一个json地址获取一些软件不能识别ua的设备的数值,如屏幕尺寸等,领主tips: 这个地址河蟹了,不然直接设置尺寸方便,国产机list里根本没参数 •vr_cursor[字符型] //使用一个已定义和加载的热点作为运动光标. //语法:vr_cursor="hotspot[name]" •vr_cursor_enabled[布尔型] //默认true. 设置是否显示运动光标. •vr_cursor_onover[动作事件] //运动光标移动到某个新热点上面执行的动作 •vr_cursor_onout[动作事件] //运动光标移出到某个新热点外面执行的动作. |
插件状态属性:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 |
•isavailable[布尔型] //默认返回false. 检测当前设备是否支持vr模式. •isenabled[布尔型] //默认返回false.检测是否已打开kr的vr模式. •iswebvr[布尔型] //默认返回false. 检测当前浏览器是否支持vr模式. •ismobilevr[布尔型] //默认返回false. 检测当前移动设备是否支持vr模式. •isfake[布尔型] //默认返回false. 检测当前桌面设备是否支持vr模式. •havesettings[布尔型] //默认返回false. 检测当前是否有执行过loadsettings动作. •devicename[字符型] // 获取当前VR头戴设备的名字 •devicesize[数字型] //默认返回0.0, 返回屏幕尺寸,0.0是检测失败,无法返回数据. |
插件事件:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
•onavailable //设置在支持检测到支持vr模式时执行的动作,通常可以显示进入vr按钮 •onunavailable //设置在不支持检测到支持vr模式时执行的动作 •onunknowndevice //当无法检测到设备名称和屏幕尺寸大小时执行的动作 •onentervr //设置在进入vr模式时执行的动作 •onexitvr //设置在退出vr模式时执行的动作 |
插件动作:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 |
•enterVR() //进入vr状态 •exitVR() //退出vr状态 •toggleVR() //切换进入/退出vr状态 •lookat(hlookat) / resetSensor(hlookat) //重置视角水平方向或传感器的水平方向 •calibrate(ondone*, onerror*) //手动校正陀螺仪传感器 //参数: ondone (可选) 校正完成后执行的动作. onerror (可选) 校正失败时执行的动作. •resetCalibration() //重设陀螺仪传感器全部数据 •loadSettings(storage*) //读取存储设置 •saveSettings(storage*) //存档存储设置 存储和读取可以设置以下属性,对应上文插件属性: ◦mobilevr_ipd ◦mobilevr_screensize ◦mobilevr_lens_overlap ◦mobilevr_lens_fov ◦mobilevr_lens_dist ◦mobilevr_lens_dist2 ◦mobilevr_lens_ca ◦mobilevr_lens_vign ◦mobilevr_sensor_mode ◦the gyroscope calibration data 参数: •storage (可选) 通常设置如下: ◦global (默认) - 读取和存储全局的跨域设定. ◦local - 只读取和存储本地设定,禁止跨域访问. •update() //更新当前显示设置,该动作将在 display.stereo该属性同帧执行. |