accelerometer

来自于:开发者立即使用

checkUp startListener stopListener

概述

accelerometer封装了iOS系统的加速度传感器,使用此模块可轻松实现对各个方向加速度(包含重力)获取的功能。

模块接口

checkUp

检查设备是否有加速度传感器

checkUp(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. code: //0代表设备有加速度传感器,1代表设备没有加速度传感器
  3. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. //无返回值
  3. }

示例代码

  1. var accelerometer= api.require('accelerometer');
  2. accelerometer.checkUp(function(ret,err){
  3. alert(JSON.stringify(ret));
  4. });

可用性

iOS系统

startListener

打开加速度传感器

startListener({params}, callback(ret, err))

params

time:

  • 类型:字符串
  • 描述:(必选)采集信息间隔时间,以秒为单位。

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. x: //沿x轴(包括重力)的加速度力(米/秒)
  3. y: //沿y轴(包括重力)的加速度力(米/秒)
  4. z: //沿z轴(包括重力)的加速度力(米/秒)
  5. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. //无返回值
  3. }

示例代码

  1. var accelerometer= api.require('accelerometer');
  2. accelerometer.startListener({
  3. time : '0.1'
  4. },function(ret, err){
  5. var msg = JSON.stringify(ret);
  6. api.toast({
  7. msg: msg
  8. });
  9. });

补充说明

经过测试,当间隔时间设置较长时,5s机型第一返回值时间会变长,建议设置0.1秒。

可用性

iOS系统

可提供的1.0.0及更高版本

stopListener

关闭加速度传感器

stopListener()

示例代码

  1. var accelerometer= api.require('accelerometer');
  2. accelerometer.stopListener();

可用性

iOS系统