Rexsee API介绍：Android传感器系列之 - 磁场传感器Magnetic Field源码
Android的磁场传感器，Magnetic Field。。读取磁场的变化，通过该传感器可开发出指南针、罗盘等磁场应用。该传感器读取的数据是空间坐标系三个方向的磁场值，其数据单位为uT，即微特斯拉。
主要的扩展函数对象如下。关于一些具体的应用Demo可以在Rexsee项目中心查阅： http://www.rexsee.com/project/index.php
【函数】 boolean isReady()
【说明】 判断磁场传感器是否可用。
【返回】 true或false。
【示例】
alert(rexseeMagneticField.isReady());
【函数】 void start()
【说明】 启动磁场传感器。
【示例】
rexseeMagneticField.start();
rexseeDialog.toast('传感器已启动。');
【函数】 void stop()
【说明】 关闭磁场传感器。
【示例】
rexseeMagneticField.stop();
rexseeDialog.toast('传感器已关闭。');
【函数】 String getLastKnownX()
【说明】 读取X方向的磁场值。
【返回】 磁场值，单位是特斯拉（micro-Tesla, uT），null表示没有值。
【示例】
alert(rexseeMagneticField.getLastKnownX());
【函数】 String getLastKnownY()
【说明】 读取Y方向的磁场值。
【返回】 磁场值，单位是特斯拉（micro-Tesla, uT），null表示没有值。
【示例】
alert(rexseeMagneticField.getLastKnownY());
【函数】 String getLastKnownZ()
【说明】 读取Z方向的磁场值。
【返回】 磁场值，单位是特斯拉（micro-Tesla, uT），null表示没有值。
【示例】
alert(rexseeMagneticField.getLastKnownZ());
【函数】 void setRate(String rate)
【说明】 设置传感器响应速度，默认为“normal”。
【参数】 rate：传感器响应速度，“fastest”，“game”，“ui”或“normal”。
【示例】
rexseeMagneticField.setRate('fastest');
rexseeDialog.toast('设置完毕。');
【函数】 String getRate()
【说明】 读取传感器响应速度。
【返回】 传感器响应速度，“fastest”，“game”，“ui”或“normal”。
【示例】
alert(rexseeMagneticField.getRate());
【函数】 void setCycle(int milliseconds)
【说明】 设置传感器检测周期，毫秒数，默认为100毫秒。
【参数】 milliseconds：传感器检测周期。
【示例】
rexseeMagneticField.setCycle(1000);
rexseeDialog.toast('设置完毕。');
【函数】 int getCycle()
【说明】 读取传感器检测周期。
【返回】 传感器检测周期，毫秒数。
【示例】
alert(rexseeMagneticField.getCycle());
【函数】 void setEventCycle(int milliseconds)
【说明】 设置传感器触发事件的最短间隔，在该间隔内不会重复触发事件，毫秒数，默认为100毫秒。
【参数】 milliseconds：传感器触发事件的最短间隔。
【示例】
rexseeMagneticField.setEventCycle(1000);
rexseeDialog.toast('设置完毕。');
【函数】 int getEventCycle()
【说明】 读取传感器触发事件的最短间隔。
【返回】 传感器触发事件的最短间隔，毫秒数。
【示例】
alert(rexseeMagneticField.getEventCycle());
【函数】 void setAccuracy(float x, float y, float z)
【说明】 设置X/Y/Z方向上的敏感度，两次检测的差异大于该敏感度才会触发事件，单位是特斯拉（micro-Tesla, uT），小于零表示忽略该方向的变化，即无论该方向两次检测的差异有多大都不会触发事件。
【参数】 x：X方向的敏感度。
y：Y方向的敏感度。
z：Z方向的敏感度。
【示例】
rexseeMagneticField.setAccuracy(1,2,3);
rexseeDialog.toast('设置完毕。');
【函数】 float getAccuracyX()
【说明】 读取X方向的敏感度。
【返回】 X方向的敏感度，单位是特斯拉（micro-Tesla, uT），小于零表示忽略X方向的变化。
【示例】
alert(rexseeMagneticField.getAccuracyX());
【函数】 float getAccuracyY()
【说明】 读取Y方向的敏感度。
【返回】 Y方向的敏感度，单位是特斯拉（micro-Tesla, uT），小于零表示忽略Y方向的变化。
【示例】
alert(rexseeMagneticField.getAccuracyY());
【函数】 float getAccuracyZ()
【说明】 读取Z方向的敏感度。
【返回】 Z方向的敏感度，单位是特斯拉（micro-Tesla, uT），小于零表示忽略Z方向的变化。
【示例】
alert(rexseeMagneticField.getAccuracyZ());
利用如上的函数可以很快的实现一个指南针实例开发：先找罗盘图片；打开传感器rexseeOrientation.start()；把方向改变时触发的事件写上：然后是处理图片。搞定~~查看原帖：http://www.rexsee.com/CN/bbs/thread/2011-10-09/78.html
function onOrientationChanged(){ //方向传感器事件,即当方向发生改变时触发的动作
var x = rexseeOrientation.getLastKnownX();
x = 90 - x;
document.getElementById('oriDiv').style.webkitTransform = 'rotate('+x+"deg)";
}
如下是Rexsee针对于磁场传感功能的扩展API源码，rexseeMagneticField.java
/*
* Copyright (C) 2011 The Rexsee Open Source Project
*
* Licensed under the Rexsee License, Version 1.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.rexsee.com/CN/legal/license.html
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package rexsee.sensor;
import rexsee.core.browser.JavascriptInterface;
import rexsee.core.browser.RexseeBrowser;
import android.content.Context;
import android.hardware.Sensor;
import android.hardware.SensorEvent;
import android.hardware.SensorEventListener;
import android.hardware.SensorManager;
public class RexseeSensorMagneticField implements JavascriptInterface {
private static final String INTERFACE_NAME = "MagneticField";
@Override
public String getInterfaceName() {
return mBrowser.application.resources.prefix + INTERFACE_NAME;
}
@Override
public JavascriptInterface getInheritInterface(RexseeBrowser childBrowser) {
return this;
}
@Override
public JavascriptInterface getNewInterface(RexseeBrowser childBrowser) {
return new RexseeSensorMagneticField(childBrowser);
}
public static final String EVENT_ONMAGNETICFIELDCHANGED = "onMagneticFieldChanged";
private final Context mContext;
private final RexseeBrowser mBrowser;
private final SensorManager mSensorManager;
private final SensorEventListener mSensorListener;
private final Sensor mSensor;
private int mRate = SensorManager.SENSOR_DELAY_NORMAL;
private int mCycle = 100; //milliseconds
private int mEventCycle = 100; //milliseconds
private float mAccuracyX = 0;
private float mAccuracyY = 0;
private float mAccuracyZ = 0;
private long lastUpdate = -1;
private long lastEvent = -1;
private float x = -999f;
private float y = -999f;
private float z = -999f;
public RexseeSensorMagneticField(RexseeBrowser browser) {
mContext = browser.getContext();
mBrowser = browser;
browser.eventList.add(EVENT_ONMAGNETICFIELDCHANGED);
mSensorManager = (SensorManager) mContext.getSystemService(Context.SENSOR_SERVICE);
mSensor = mSensorManager.getDefaultSensor(Sensor.TYPE_MAGNETIC_FIELD);
mSensorListener = new SensorEventListener() {
@Override
public void onAccuracyChanged(Sensor sensor, int accuracy) {
}
@Override
public void onSensorChanged(SensorEvent event) {
if (event.sensor.getType() != Sensor.TYPE_MAGNETIC_FIELD) return;
long curTime = System.currentTimeMillis();
if (lastUpdate == -1 || (curTime - lastUpdate) > mCycle) {
lastUpdate = curTime;
float lastX = x;
float lastY = y;
float lastZ = z;
x = event.values[SensorManager.DATA_X];
y = event.values[SensorManager.DATA_Y];
z = event.values[SensorManager.DATA_Z];
if (lastEvent == -1 || (curTime - lastEvent) > mEventCycle) {
if (
(mAccuracyX >= 0 && Math.abs(x - lastX) > mAccuracyX)
|| (mAccuracyY >= 0 && Math.abs(y - lastY) > mAccuracyY)
|| (mAccuracyZ >= 0 && Math.abs(z - lastZ) > mAccuracyZ)
) {
lastEvent = curTime;
mBrowser.eventList.run(EVENT_ONMAGNETICFIELDCHANGED);
}
}
}
}
};
}
public String getLastKnownX() {
return (x == -999) ? "null" : String.valueOf(x);
}
public String getLastKnownY() {
return (y == -999) ? "null" : String.valueOf(y);
}
public String getLastKnownZ() {
return (z == -999) ? "null" : String.valueOf(z);
}
public void setRate(String rate) {
mRate = SensorRate.getInt(rate);
}
public String getRate() {
return SensorRate.getString(mRate);
}
public void setCycle(int milliseconds) {
mCycle = milliseconds;
}
public int getCycle() {
return mCycle;
}
public void setEventCycle(int milliseconds) {
mEventCycle = milliseconds;
}
public int getEventCycle() {
return mEventCycle;
}
public void setAccuracy(float x, float y, float z) {
mAccuracyX = x;
mAccuracyY = y;
mAccuracyZ = z;
}
public float getAccuracyX() {
return mAccuracyX;
}
public float getAccuracyY() {
return mAccuracyY;
}
public float getAccuracyZ() {
return mAccuracyZ;
}
public boolean isReady() {
return (mSensor == null) ? false : true;
}
public void start() {
if (isReady()) {
mSensorManager.registerListener(mSensorListener, mSensor, mRate);
} else {
mBrowser.exception(getInterfaceName(), "Magnetic-field sensor is not found.");
}
}
public void stop() {
if (isReady()) {
mSensorManager.unregisterListener(mSensorListener);
}
}
}
仅对Rexsee的源码和函数事件做了整理，相关的demo或源码解析可以在Rexsee社区了解，目前Rexsee已提供了近2000个扩展，覆盖Android原生功能超过90%，且全部开放： http://www.rexsee.com/