Rexsee API介绍：Android传感器系列之 - 磁场传感器Magnetic Field源码 - android

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/

Rexsee API介绍：Android传感器系列之 - 磁场传感器Magnetic Field源码

更多相关文章

随机推荐