現在的智能手機都配備了各種各樣的傳感器,本文將介紹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; // Next按鈕每按一次加一
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);
}
}
}
實際運行效果圖如下: