Android 传感器开发

如今的智能手机都配备了各种各样的传感器，本文将介绍Android SDK提供的传感器开发接口，并通过简单实例展示怎样使用这些接口。

Andriod SDK传感器相关类

android SDK提供的与传感器相关的类有(位于android.hardware包)：

Sensor： 表示传感器的类。它保存有传感器名称，厂商，版本号。准确度等信息；

SensorEvent：表示传感器事件。它能够保存传感器的值，传感器类型，时间戳等信息；

SensorEventListener：用于接收传感器来自SensorManager的通知，当传感器发生变化时，它包括两个回调函数。

SensorManager：SensorManager让你能够訪问设备（手机）的所有传感器。

lets you access the device's sensors.

可通过以android.content.Context.SENSOR_SERVICE为參数调用Context.getSystemService()获取一个该类的实例。

注意：应当始终保证在不须要使用传感器的时候禁用传感器。特别是当你的activity暂停的时候。没有这样做将会导致电池仅仅能使用非常少几个小时。

记住。系统不会在屏幕关闭的时候自己主动禁用传感器。

SensorListener：已废除，不再介绍。

SensorEvent API 定义的坐标系统

Android的SensorEvent API定义的坐标系统是：X轴水平向右，Y轴垂直向上。Z轴沿屏幕向外。在这个坐标系统里，屏幕后面的Z值为负。

例如以下图所看到的：

以下介绍Android Sensor相关API怎样使用。

Demo

来自doc的demo

SensorManager的doc里给出了一个简单的demo：

 public class SensorActivity extends Activity, implements SensorEventListener {
     private final SensorManager mSensorManager;
     private final Sensor mAccelerometer;

     public SensorActivity() {
         mSensorManager = (SensorManager)getSystemService(SENSOR_SERVICE);
         mAccelerometer = mSensorManager.getDefaultSensor(Sensor.TYPE_ACCELEROMETER);
     }

     protected void onResume() {
         super.onResume();
         mSensorManager.registerListener(this, mAccelerometer, SensorManager.SENSOR_DELAY_NORMAL);
     }

     protected void onPause() {
         super.onPause();
         mSensorManager.unregisterListener(this);
     }

     public void onAccuracyChanged(Sensor sensor, int accuracy) {
     }

     public void onSensorChanged(SensorEvent event) {
     }
 }

这个demo虽短。但已经给出了一个传感器开发的基本框架。而且在Activity暂停的时禁用了相应的传感器（依照官方的说法能够省电）。

还有一个demo——SensorTest

以下是一个传感器測试demo。能够測试你android手机支持那些传感器，并能实时显示传感器的值。

布局文件例如以下：

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:paddingBottom="@dimen/activity_vertical_margin"
    android:paddingLeft="@dimen/activity_horizontal_margin"
    android:paddingRight="@dimen/activity_horizontal_margin"
    android:paddingTop="@dimen/activity_vertical_margin"
    tools:context="com.example.sensortest.MainActivity" >

    <Button
        android:id="@+id/btnNext"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Next" />

    <Button
        android:id="@+id/btnPause"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_alignBaseline="@+id/btnNext"
        android:layout_alignBottom="@+id/btnNext"
        android:layout_toRightOf="@+id/btnNext"
        android:text="Pause" />

    <TextView
        android:id="@+id/txtInfo"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_alignLeft="@+id/btnNext"
        android:layout_below="@+id/btnNext"
        android:layout_marginLeft="15dp"
        android:layout_marginTop="18dp"
        android:text="Sensor Informations" />

    <TextView
        android:id="@+id/txtDetails"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_alignLeft="@+id/txtInfo"
        android:layout_below="@+id/txtInfo"
        android:layout_marginTop="14dp"
        android:text="Sensor Values" />

</RelativeLayout>

Activity代码例如以下：

package com.example.sensortest;

import java.util.List;
import java.util.concurrent.atomic.AtomicInteger;

import android.app.Activity;
import android.hardware.Sensor;
import android.hardware.SensorEvent;
import android.hardware.SensorEventListener;
import android.hardware.SensorManager;
import android.os.Bundle;
import android.util.Log;
import android.view.Menu;
import android.view.MenuItem;
import android.view.View;
import android.widget.Button;
import android.widget.TextView;

public class MainActivity extends Activity {
    private final String TAG = "SensorTest";

    SensorManager sensorManager;
    SensorEventListener listener;

    List<Sensor> allSensors;
    volatile int currentIndex = -1; // Nextbutton每按一次加一

    Button btnNext;
    Button btnPause;

    TextView txtInfo;
    TextView txtValues;

    AtomicInteger showDetail = new AtomicInteger(1);

    private void init() {
        sensorManager = (SensorManager) getSystemService(SENSOR_SERVICE);
        allSensors = sensorManager.getSensorList(Sensor.TYPE_ALL);
        initViews();
        initSensorsListener();
    }

    private void initViews() {
        btnNext = (Button) findViewById(R.id.btnNext);
        btnPause = (Button) findViewById(R.id.btnPause);

        txtInfo = (TextView) findViewById(R.id.txtInfo);
        txtValues = (TextView) findViewById(R.id.txtDetails);

        btnNext.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                currentIndex = (currentIndex + 1) % allSensors.size();
                Sensor sensor = allSensors.get(currentIndex);
                int type = sensor.getType();
                txtInfo.setText(String.format("%d: %s, %s", currentIndex + 1,
                        sensorTypeToString(sensor.getType()), sensor.toString()));
                Log.d(TAG,
                        String.format("%d: %s, %s", currentIndex + 1,
                                sensorTypeToString(sensor.getType()),
                                sensor.toString()));
            }
        });

        btnPause.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                showDetail.incrementAndGet();
                Log.d(TAG, "showDetails: " + showDetail + ", idx: "
                        + currentIndex);
                if (showDetail.get() % 2 == 1) {
                    btnPause.setText("Pause");
                } else {
                    btnPause.setText("Start");
                }
            }
        });
    }

    private void initSensorsListener() {
        if (allSensors.size() > 0) {
            listener = new SensorEventListener() {
                long lastTime = System.currentTimeMillis();
                long time;

                @Override
                public void onSensorChanged(SensorEvent event) {
                    time = System.currentTimeMillis();
                    if (showDetail.get() % 2 == 1) {
                        Sensor sensor = event.sensor;
                        if (currentIndex >= 0
                                && sensor.getType() == allSensors.get(
                                        currentIndex).getType()) {
                            // 仅仅显示currentIndex相应的Sensor数据
                            StringBuffer str = new StringBuffer();
                            // for (int i=0; i<event.values.length; i++) {
                            // float value = event.values[i];
                            for (float value : event.values) {
                                str.append(value + "\n");
                            }
                            txtValues.setText(str);

                            if (time - lastTime > 1000) { // true ||

                                Log.d(TAG,
                                        "type: "
                                                + sensorTypeToString(event.sensor
                                                        .getType())
                                                + ", values: " + str.toString()
                                                + ", time: " + time);

                            }
                        }
                    }
                    lastTime = time;
                }

                @Override
                public void onAccuracyChanged(Sensor sensor, int accuracy) {
                    Log.d(TAG, "onAccuracyChanged sensor: " + sensor
                            + ", accracy: " + accuracy);
                }
            };

            for (Sensor sensor : allSensors) {
                sensorManager.registerListener(listener, sensor,
                        SensorManager.SENSOR_DELAY_NORMAL);
            }
        }
    }

    String sensorTypeToString(int type) {
        String res = null;
        switch (type) {
        case Sensor.TYPE_ACCELEROMETER:
            res = "ACCELEROMETER";
            break;
        case Sensor.TYPE_AMBIENT_TEMPERATURE:
            res = "AMBIENT_TEMPERATURE";
            break;
        case Sensor.TYPE_GAME_ROTATION_VECTOR:
            res = "GAME_ROTATION_VECTOR";
            break;
        case Sensor.TYPE_GEOMAGNETIC_ROTATION_VECTOR:
            res = "GEOMAGNETIC_ROTATION_VECTOR";
            break;
        case Sensor.TYPE_GRAVITY:
            res = "GRAVITY";
            break;
        case Sensor.TYPE_GYROSCOPE:
            res = "GYROSCOPE";
            break;
        case Sensor.TYPE_GYROSCOPE_UNCALIBRATED:
            res = "GYROSCOPE_UNCALIBRATED";
            break;
        case Sensor.TYPE_HEART_RATE:
            res = "HEART_RATE";
            break;
        case Sensor.TYPE_LIGHT:
            res = "LIGHT";
            break;
        case Sensor.TYPE_LINEAR_ACCELERATION:
            res = "LINEAR_ACCELERATION";
            break;
        case Sensor.TYPE_MAGNETIC_FIELD:
            res = "MAGNETIC_FIELD";
            break;
        case Sensor.TYPE_MAGNETIC_FIELD_UNCALIBRATED:
            res = "MAGNETIC_FIELD_UNCALIBRATED";
            break;
        case Sensor.TYPE_ORIENTATION:
            res = "ORIENTATION";
            break;
        case Sensor.TYPE_PRESSURE:
            res = "PRESSURE";
            break;
        case Sensor.TYPE_PROXIMITY:
            res = "PROXIMITY";
            break;
        case Sensor.TYPE_RELATIVE_HUMIDITY:
            res = "HUMIDITY";
            break;
        case Sensor.TYPE_ROTATION_VECTOR:
            res = "ROTATION_VECTOR";
            break;
        default:
            res = "UNKNOW";
            break;
        }
        return res;
    }

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        init();
    }

    protected void onResume() {
        super.onResume();
        for (Sensor sensor : allSensors) {
            sensorManager.registerListener(listener, sensor,
                    SensorManager.SENSOR_DELAY_NORMAL);
        }
    }

    protected void onPause() {
        super.onPause();
        for (Sensor sensor : allSensors) {
            sensorManager.unregisterListener(listener, sensor);
        }
    }
}

实际执行效果图例如以下：