插件说明
本插件是使用于陀螺仪和加速感应器的移动设备上,用于感应设备方向和移动加速动作.
Gyro 2对比旧版本 Gyroscope plugin是一个全新开发的插件. 新插件使用浏览器事件响应代替旧插件的设备事件响应,更快速、更精确和更平滑,同时适用于ios\android\winphone平台.
设备和浏览器支持
- iOS - yes
- Windows Phone 8 / IE11 - yes
- Android Chrome - yes
- Android Opera - yes
- Android Firefox - yes
- Older Webkit-based Android browsers - no (no 'devicemotion' event support)
Note - 设备必须具有陀螺仪和加速感应功能,注意有横屏感应(有时称重力感应)和有陀螺仪是不同的,旧款一些安卓手机只有横屏感应功能,查看手机说明书或上网查找相关参数,可以清楚了解手机是否支持陀螺仪,一般陀螺仪自带加速感应,所以只需要确认是否支持陀螺仪即可. 上述的设备和浏览器支持名称,领主就不翻译了,看不明白个别咨询领主.
语法和xml样例:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
<plugin name="gyro" devices="html5" keep="true" url="gyro2.js" enabled="false" camroll="true" friction="0.0" touch_mode="full" sensor_mode="1" softstart="0.5" autocalibration="false" onavailable="" onunavailable="" onenable="" ondisable="" /> |
插件属性:
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 |
•enabled[布尔型] 是否打开该插件功能,开启陀螺仪感应,默认false. •camroll[字符型] 是否跟随设备横向旋转,默认true. •friction[字符型] 摩擦和减震系数,默认是0.0, 可以设置范围 0.0 - 0.99 或设置为 "auto" •touch_mode[字符型] 陀螺仪打开期间的,触屏设置,默认full •off - 禁止触屏. •horizontaloffset - 允许横向拨动屏幕旋转. •full - 触屏可以完全控制. •disablegyro - 触屏后停止陀螺仪感应,这时enabled被设置成false,需要设置会true,陀螺仪才会恢复运作. •sensor_mode[整型] 鉴于不同设备和浏览器渲染和感应能力不同,该参数可以调整插值,让感应更顺滑,默认值是1. 0-直接使用最新的可用的传感器数据。无插值或外推。根据浏览器的传感器时间间隔,移动可以是生涩的,也可以是平滑的。 1-平滑插值最新可用的传感器数据之间。这将给一个很光滑,但迟发性运动。 2-预测设备旋转,然后在传感器数据之间进行插值。 3-将最新可用的传感器数据外推到当前帧时间。这将提供快速响应和平滑的运动,但可以有一个颠簸在外推/预测数据和实际运动不匹配。 4-预测设备旋转到当前帧时间。这将提供快速响应和平滑的运动,但可以有一个颠簸在外推/预测数据和实际运动不匹配。 5-预测设备旋转,并将传感器数据从最新事件外推到当前帧时间。 •softstart[数字型] •当使陀螺跟踪褪色慢慢从目前的观察方向的陀螺跟踪观察方向。默认是0.5 •软启动设置中定义的秒数用“淡入”的过程。 •将此设置设置为0,使其立即禁用陀螺仪跟踪值。 •autocalibration[布尔型] 启用自动陀螺仪校准。默认是false •一些设备未校准的传感器有自动校准可以帮助避免意外的陀螺运动/漂流。 •每当设备保持静止时,都会自动进行自动校准,例如通过保持设备非常稳定或将设备放置在稳定的桌子上。 |
插件只读属性:
1 2 3 |
•isavailable[布尔型] •陀螺仪判断是否可用,这是检测设备上是否支持。 •这个变量将首先反馈到onavailable或onunavailable事件。 |
插件事件:
1 2 3 4 5 6 7 8 |
•onavailable 该事件可以设置在检测到支持陀螺仪的情况下执行的动作,例如用来显示重力按钮 •onunavailable 该事件可以设置在检测到不支持陀螺仪的情况下执行的动作,例如弹出文字等提示用户不支持陀螺仪 •onenable 当陀螺仪被打开是执行的事件 •ondisable 当陀螺仪被关闭是执行的事件 |
插件动作:
1 2 3 |
•resetSensor(hlookat, vlookat*) •重置传感器跟踪看了hlookat(往水平方向看)。 •使用时touch_mode =full时,也可以设置vlookat(垂直方向看)。 |