- 开始
- Demo, 调试运行
- Hello World
- 与vue交互
- 常用api
- 支持库(超强)
- 热更新
- 打包
- 远程部署
- 与java交互
- Q&A - 常见问题
- UI设计
- 【API文档】:
- Overview - 综述
- Tip - 阅读说明
- Click - 基于坐标的操作
- 开始 - 基于控件的操作
- Click - 基于控件的操作
- UiSelector - 查找控件
- UiObject - 控件
- App - 应用
- Canvas - 画布
- Console - 控制台
- Crypto - 加解密与消息摘要
- Device - 设备
- Dialogs - 对话框
- Engines - 脚本引擎
- Events - 事件与监听
- Floaty - 悬浮窗
- Files - 文件系统
- Globals - 一般全局函数
- Http - HTTP
- Images - 图片与图色处理
- Keys - 按键模拟
- Media - 多媒体
- Modules - 模块
- Sensors - 传感器
- Shell - Shell命令
- Storages - 本地存储
- Threads - 多线程
- Timers - 定时器
- UI - 用户界面
- Work with Java - 调用Java API
用JS任意控制手机上的APP
目录
Sensors#
sensors模块提供了获取手机上的传感器的信息的支持,这些传感器包括距离传感器、光线光感器、重力传感器、方向传感器等。需要指出的是,脚本只能获取传感器的数据,不能模拟或伪造传感器的数据和事件,因此诸如模拟摇一摇的功能是无法实现的。
要监听一个传感器时,需要使用sensors.register()
注册监听器,之后才能开始监听;不需要监听时则调用sensors.unregister()
注销监听器。在脚本结束时会自动注销所有的监听器。同时,这种监听会使脚本保持运行状态,如果不注销监听器,脚本会一直保持运行状态。
例如,监听光线传感器的代码为:
//光线传感器监听
sensors.register("light").on("change", (event, light)=>{
log("当前光强度为", light);
});
要注意的是,每个传感器的数据并不相同,所以对他们调用on()
监听事件时的回调函数参数也不是相同,例如光线传感器参数为(event, light)
,加速度传感器参数为(event, ax, ay, az)
。甚至在某些设备上的传感器参数有所增加,例如华为手机的距离传感器为三个参数,一般手机只有一个参数。
常用的传感器及其事件参数如下表:
accelerometer
加速度传感器,参数(event, ax, ay, az)
:event
SensorEvent 传感器事件,用于获取传感器数据变化时的所有信息ax
<number> x轴上的加速度,单位m/s^2ay
<number> y轴上的加速度,单位m/s^2az
<number> z轴上的加速度,单位m/s^2 这里的x轴,y轴,z轴所属的坐标系统如下图(其中z轴垂直于设备屏幕表面):!
orientation
方向传感器,参数(event, azimuth, pitch, roll)
:event
SensorEvent 传感器事件,用于获取传感器数据变化时的所有信息azimuth
<number> 方位角,从地磁指北方向线起,依顺时针方向到y轴之间的水平夹角,单位角度,范围0~359pitch
<number> 绕x轴旋转的角度,当设备水平放置时该值为0,当设备顶部翘起时该值为正数,当设备尾部翘起时该值为负数,单位角度,范围-180~180roll
<number> 绕y轴顺时针旋转的角度,单位角度,范围-90~90
gyroscope
陀螺仪传感器,参数(event, wx, wy, wz)
:event
SensorEvent 传感器事件,用于获取传感器数据变化时的所有信息wx
<number> 绕x轴的角速度,单位弧度/swy
<number> 绕y轴的角速度,单位弧度/swz
<number> 绕z轴的角速度,单位弧度/s
magnetic_field
磁场传感器,参数(event, bx, by, bz)
:event
SensorEvent 传感器事件,用于获取传感器数据变化时的所有信息bx
<number> x轴上的磁场强度,单位uTby
<number> y轴上的磁场强度,单位uTbz
<number> z轴上的磁场强度,单位uT
gravity
重力传感器,参数(event, gx, gy, gz)
:event
SensorEvent 传感器事件,用于获取传感器数据变化时的所有信息gx
<number> x轴上的重力加速度,单位m/s^2gy
<number> y轴上的重力加速度,单位m/s^2gz
<number> z轴上的重力加速度,单位m/s^2
linear_acceleration
线性加速度传感器,参数(event, ax, ay, az)
:event
SensorEvent 传感器事件,用于获取传感器数据变化时的所有信息ax
<number> x轴上的线性加速度,单位m/s^2ay
<number> y轴上的线性加速度,单位m/s^2az
<number> z轴上的线性加速度,单位m/s^2
ambient_temperature
环境温度传感器,大部分设备并不支持,参数(event, t)
:event
SensorEvent 传感器事件,用于获取传感器数据变化时的所有信息t
<number> 环境温度,单位摄氏度。
light
光线传感器,参数(event, light)
:event
SensorEvent 传感器事件,用于获取传感器数据变化时的所有信息light
<number> 环境光强度,单位lux
pressure
压力传感器,参数(event, p)
:event
SensorEvent 传感器事件,用于获取传感器数据变化时的所有信息p
<number> 大气压,单位hPa
proximity
距离传感器,参数(event, distance)
:event
SensorEvent 传感器事件,用于获取传感器数据变化时的所有信息distance
<number> 一般指设备前置摄像头旁边的距离传感器到前方障碍物的距离,并且很多设备上这个值只有两种情况:当障碍物较近时该值为0,当障碍物较远或在范围内没有障碍物时该值为5
relative_humidity
湿度传感器,大部分设备并不支持,参数(event, rh)
:event
SensorEvent 传感器事件,用于获取传感器数据变化时的所有信息rh
<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
最快的更新频率】
- 返回 SensorEventEmiiter
注册一个传感器监听并返回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。
例如:
sensors.ignoresUnsupportedSensor = true;
//无需null判断
sensors.register("gravity").on("change", (gx, gy, gz)=>{
log("重力加速度: %d, %d, %d", gx, gy, gz);
});
更多信息,参见SensorEventEmitter和sensors.ignoresUnsupportedSensor。
sensors.unregister(emitter)#
emiiter
SensorEventEmitter
注销该传感器监听器。被注销的监听器将不再能监听传感器数据。
//注册一个传感器监听器
var sensor = sensors.register("gravity");
if(sensor == null){
exit();
}
//2秒后注销该监听器
setTimeout(()=> {
sensors.unregister(sensor);
}, 2000);
sensors.unregisterAll()#
注销所有传感器监听器。
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 高精度
当传感器精度改变时会触发的事件。比较少用。