PhoneGap中文API

PhoneGapAccelerometer点击设备屏幕的手势感应器。采集设备在x、y、z方向上的动作。方法：accelerometer.getCurrentAccelerationaccelerometer.watchAccelerationaccelerometer.clearWatch参数：accelerometerSuccessaccelerometerErroraccelerometerOptions对象（只读）：Accelerationaccelerometer.getCurrentAcceleration返回当前沿x、y和z方向的加速度。navigator.accelerometer.getCurrentAcceleration(accelerometerSuccess,accelerometerError);说明：加速计是检测设备在当前方向上所做相对运动变化（增、减量）的运动传感器。加速计可以检测沿X、Y和Z轴的三维运动。加速度数据通过accelerometerSuccess回调函数返回。支持的平台：AndroidBlackBerryWebWorks(OS5.0或更高版本)iPhone简单的范例：functiononSuccess(acceleration){alert('AccelerationX:'+acceleration.x+'\n'+'AccelerationY:'+acceleration.y+'\n'+'AccelerationZ:'+acceleration.z+'\n'+'Timestamp:'+acceleration.timestamp+'\n');}functiononError(){alert('onError!');}navigator.accelerometer.getCurrentAcceleration(onSuccess,onError);完整的范例：!DOCTYPEhtmlhtmlheadtitleAccelerationExample/titlescripttype=text/javascriptcharset=utf-8src=phonegap.js/scriptscripttype=text/javascriptcharset=utf-8//等待加载PhoneGapdocument.addEventListener(deviceready,onDeviceReady,false);//PhoneGap加载完毕functiononDeviceReady(){navigator.accelerometer.getCurrentAcceleration(onSuccess,onError);}//onSuccess:返回当前加速度数据的快照functiononSuccess(acceleration){alert('AccelerationX:'+acceleration.x+'\n'+'AccelerationY:'+acceleration.y+'\n'+'AccelerationZ:'+acceleration.z+'\n'+'Timestamp:'+acceleration.timestamp+'\n');}//onError:返回加速度数据失败functiononError(){alert('onError!');}/script/headbodyh1Example/h1pgetCurrentAcceleration/p/body/htmliPhone的特异情况：iPhone没有获取在任何给定点当前加速度数据的概念。你必须通过给定时间间隔查看加速度并获得数据。因此，getCurrentAcceleration函数会返回从phoneGapwatchAccelerometer调用开始后的最近一个返回值。accelerometer.watchAcceleration在固定的时间间隔获取沿x、y和z轴的加速度。varwatchID=navigator.accelerometer.watchAcceleration(accelerometerSuccess,accelerometerError,[accelerometerOptions]);说明：加速计是检测设备在当前方向上所做相对运动变化（增、减量）的动作传感器。加速计可以检测沿X、Y和Z轴的三维运动。accelerometer.watchAcceleration每隔固定时间就获取一次设备的当前加速度。每次取得加速度后，accelerometerSuccess回调函数会被执行。通过acceleratorOptions对象的frequency参数可以设定以毫秒为单位的时间间隔。返回的watchid是加速度计监视周期的引用，可以通过accelerometer.clearWatch调用该watchID以停止对加速度计的监视。支持的平台：AndroidBlackBerryWebWorks(OS5.0或更高版本)iPhone简单的范例：functiononSuccess(acceleration){alert('AccelerationX:'+acceleration.x+'\n'+'AccelerationY:'+acceleration.y+'\n'+'AccelerationZ:'+acceleration.z+'\n'+'Timestamp:'+acceleration.timestamp+'\n');}functiononError(){alert('onError!');}varoptions={frequency:3000};//每隔3秒更新一次varwatchID=navigator.accelerometer.watchAcceleration(onSuccess,onError,options);完整的范例：!DOCTYPEhtmlhtmlheadtitleAccelerationExample/titlescripttype=text/javascriptcharset=utf-8src=phonegap.js/scriptscripttype=text/javascriptcharset=utf-8//watchid是当前“watchAcceleration”的引用varwatchID=null;//等待加载PhoneGapdocument.addEventListener(deviceready,onDeviceReady,false);//PhoneGap加载完毕functiononDeviceReady(){startWatch();}//开始监视加速度functionstartWatch(){//每隔3秒钟更新一次加速度数据varoptions={frequency:3000};watchID=navigator.accelerometer.watchAcceleration(onSuccess,onError,options);}//停止监视加速度functionstopWatch(){if(watchID){navigator.accelerometer.clearWatch(watchID);watchID=null;}}//onSuccess:获取当前加速度数据的快照functiononSuccess(acceleration){varelement=document.getElementById('accelerometer');element.innerHTML='AccelerationX:'+acceleration.x+'br/'+'AccelerationY:'+acceleration.y+'br/'+'AccelerationZ:'+acceleration.z+'br/'+'Timestamp:'+acceleration.timestamp+'br/';}//onError:获取加速度失败functiononError(){alert('onError!');}/script/headbodydivid=accelerometerWaitingforaccelerometer.../div/body/htmliPhone的特异情况：在请求的时间间隔，PhoneGap将调用success回调指向的函数，并传递加速度计数据。不过，PhoneGap将对设备的请求间隔时间限制为最小40ms，最大1000ms。例如，如果你设定每隔3秒（3000毫秒）请求一次，PhoneGap仍然每隔1秒请求一次设备，但是每隔3秒才调用一次success回调函数。accelerometer.clearWatch停止watchID参数指向的加速度监视。navigator.accelerometer.clearWatch(watchID);watchID：由accelerometer.watchAcceleration返回的引用标识ID。支持的平台：AndroidBlackBerryWebWorks(OS5.0或更高版本)iPhone简单的范例：varwatchID=navigator.accelerometer.watchAcceleration(onSuccess,onError,options);//...后续处理...navigator.accelerometer.clearWatch(watchID);完整的范例：!DOCTYPEhtmlhtmlheadtitleAccelerationExample/titlescripttype=text/javascriptcharset=utf-8src=phonegap.js/scriptscripttype=text/javascriptcharset=utf-8//watchid是当前“watchAcceleration”的引用varwatchID=null;//等待加载PhoneGapdocument.addEventListener(deviceready,onDeviceReady,false);//PhoneGap加载完毕functiononDeviceReady(){startWatch();}//开始监视加速度functionstartWatch(){//每隔3秒钟更新一次加速度数据varoptions={frequency:3000};watchID=navigator.accelerometer.watchAcceleration(onSuccess,onError,options);}//停止监视加速度functionstopWatch(){if(watchID){navigator.accelerometer.clearWatch(watchID);watchID=null;}}//onSuccess:获取当前加速度数据的快照functiononSuccess(acceleration){varelement=document.getElementById('accelerometer');element.innerHTML='AccelerationX:'+acceleration.x+'br/'+'AccelerationY:'+acceleration.y+'br/'+'AccelerationZ:'+acceleration.z+'br/'+'Timestamp:'+acceleration.timestamp+'br/';}//onError:获取加速度失败functiononError(){alert('onError!');}/script/headbo