Auto.js 4.1.0 文档

目录

  • Sensors#

    SensorEvent 传感器事件，用于获取传感器数据变化时的所有信息
  • ax <number> x轴上的加速度，单位m/s^2
  • ay <number> y轴上的加速度，单位m/s^2

  • az <number> z轴上的加速度，单位m/s^2 这里的x轴，y轴，z轴所属的坐标系统如下图(其中z轴垂直于设备屏幕表面):

    !axis_device

  • orientation 方向传感器，参数(event, azimuth, pitch, roll):

    • event <number> 方位角，从地磁指北方向线起，依顺时针方向到y轴之间的水平夹角，单位角度，范围0~359
    • pitch <number> 绕x轴旋转的角度，当设备水平放置时该值为0，当设备顶部翘起时该值为正数，当设备尾部翘起时该值为负数，单位角度，范围-180~180
    • roll <number> 绕y轴顺时针旋转的角度，单位角度，范围-90~90

  • gyroscope 陀螺仪传感器，参数(event, wx, wy, wz):

    • event <number> 绕x轴的角速度，单位弧度/s
    • wy <number> 绕y轴的角速度，单位弧度/s
    • wz <number> 绕z轴的角速度，单位弧度/s

  • magnetic_field 磁场传感器，参数(event, bx, by, bz):

    • event <number> x轴上的磁场强度，单位uT
    • by <number> y轴上的磁场强度，单位uT
    • bz <number> z轴上的磁场强度，单位uT

  • gravity 重力传感器，参数(event, gx, gy, gz):

    • event <number> x轴上的重力加速度，单位m/s^2
    • gy <number> y轴上的重力加速度，单位m/s^2
    • gz <number> z轴上的重力加速度，单位m/s^2

  • linear_acceleration 线性加速度传感器，参数(event, ax, ay, az):

    • event <number> x轴上的线性加速度，单位m/s^2
    • ay <number> y轴上的线性加速度，单位m/s^2
    • az <number> z轴上的线性加速度，单位m/s^2

  • ambient_temperature 环境温度传感器，大部分设备并不支持，参数(event, t):

    • event <number> 环境温度，单位摄氏度。

  • light 光线传感器，参数(event, light):

    • event <number> 环境光强度，单位lux

  • pressure 压力传感器，参数(event, p):

  • proximity 距离传感器，参数(event, distance):

    • event <number> 一般指设备前置摄像头旁边的距离传感器到前方障碍物的距离，并且很多设备上这个值只有两种情况：当障碍物较近时该值为0，当障碍物较远或在范围内没有障碍物时该值为5

  • relative_humidity 湿度传感器，大部分设备并不支持，参数(event, rh):

    • event <number> 相对湿度，范围为0~100（百分比）

    • sensors.register(sensorName[, delay])#

    • sensorName <string> 传感器名称，常用的传感器名称如上面所述
    • delay <number> 传感器数据更新频率，可选，默认为sensors.delay.normal。可用的值如下：
      • sensors.delay.normal 正常频率
      • sensors.delay.ui 适合于用户界面的更新频率
      • sensors.delay.game 适合于游戏的更新频率
      • sensors.delay.fastest 最快的更新频率】
    • 返回 SensorEventEmitter。

      例如:

      console.show();
//注册传感器监听
var sensor = sensors.register("gravity");
if(sensor == null){
    toast("不支持重力传感器");
    exit();
}
//监听数据
sensor.on("change", (gx, gy, gz)=>{
    log("重力加速度: %d, %d, %d", gx, gy, gz);
});

      可以通过delay参数来指定传感器数据的更新频率，例如：

      var sensor = sensors.register("gravity", sensors.delay.game);

      另外，如果不支持sensorName所指定的传感器，那么该函数将返回null；但如果sensors.ignoresUnsupportedSensor的值被设置为true, 则该函数会返回一个不会分发任何传感器事件的SensorEventEmitter和#

      • emiiter #

        注销所有传感器监听器。

        sensors.ignoresUnsupportedSensor#

        表示是否忽略不支持的传感器。如果该值被设置为true，则函数sensors.register()即使对不支持的传感器也会返回一个无任何数据的虚拟传感器监听，也就是sensors.register()不会返回null从而避免非空判断，并且此时会触发sensors的"unsupported_sensor"事件。

        //忽略不支持的传感器
sensors.ignoresUnsupportedSensor = true;
//监听有不支持的传感器时的事件
sensors.on("unsupported_sensor", function(sensorName){
    toastLog("不支持的传感器: " + sensorName);
});
//随便注册一个不存在的传感器。
log(sensors.register("aaabbb"));

        事件: 'unsupported_sensor'#

        • sensorName <string> 不支持的传感器名称

        当sensors.ignoresUnsupportedSensor被设置为true并且有不支持的传感器被注册时触发该事件。事件参数的传感器名称。

        SensorEventEmitter#

        注册传感器返回的对象，其本身是一个EventEmmiter，用于监听传感器事件。

        事件: 'change'#

        • ..args <Any> 传感器参数

        当传感器数据改变时触发该事件；该事件触发的最高频繁由sensors.register()指定的delay参数决定。

        事件参数根据传感器类型不同而不同，具体参见本章最前面的列表。

        一个监听光线传感器和加速度传感器并且每0.5秒获取一个数据并最终写入一个csv表格文件的例子如下：

        //csv文件路径
cosnt csvPath = "/sdcard/sensors_data.csv";
//记录光线传感器的数据
var light = 0;
//记录加速度传感器的数据
var ax = 0;
var ay = 0;
var az = 0;
//监听光线传感器
sensors.register("light", sensors.delay.fastest)
    .on("change", l => {
        light = l;
    });
//监听加速度传感器
sensors.register("accelerometer", sensors.delay.fastest)
    .on("change", (ax0, ay0, az0) => {
        ax = ax0;
        ay = ay0;
        az = az0;
    });

var file = open(csvPath, "w");
//写csv表格头
file.writeline("light,ax,ay,az")
//每0.5秒获取一次数据并写入文件
setInterval(()=>{
    file.writeline(util.format("%d,%d,%d,%d", light, ax, ay, az));
}, 500);
//10秒后退出并打开文件
setTimeout(()=>{
    file.close();
    sensors.unregsiterAll();
    app.viewFile(csvPath);
}, 10 * 1000);

        事件: 'accuracy_change'#

        • accuracy <number> 表示传感器精度。为以下值之一:
          • -1 传感器未连接
          • 0 传感器不可读
          • 1 低精度
          • 2 中精度
          • 3 高精度

        当传感器精度改变时会触发的事件。比较少用。