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/

转载于:https://my.oschina.net/u/194999/blog/52495

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值