相機Camera

Camera是直接操作攝像頭硬體的工具類。常用的方法如下：

getNumberOfCameras : 獲取本機的攝像頭數目
open : 開啟攝像頭，預設開啟後置攝像頭。如果有多個攝像頭，那麼open(0)表示開啟後置攝像頭，open(1)表示開啟前置攝像頭。
以上兩個方法是靜態方法。

getParameters : 獲取攝像頭的拍照引數。
setParameters : 設定攝像頭的拍照引數。
--setPreviewSize : 設定預覽介面的尺寸。
--setPictureSize : 設定儲存圖片的尺寸。
--setPictureFormat : 設定圖片格式。一般使用ImageFormat.JPEG表示jpg格式，
--setFocusMode : 設定對焦模式。一般使用FOCUS_MODE_AUTO表示自動對焦。
以上是Camera.Parameters的引數設定方法。

setPreviewDisplay : 設定預覽介面，引數為SurfaceHolder型別。
startPreview : 開始預覽。該方法在setPreviewDisplay之後呼叫。
stopPreview : 停止預覽
unlock : 錄影時需要對攝像頭解鎖，這樣攝像頭才能持續錄影。該方法在startPreview之後呼叫。
lock : 錄影完畢對攝像頭加鎖。該方法在stopPreview之後呼叫。
setDisplayOrientation : 設定預覽的角度。因為Android的0角度都在三點鐘位置，而手機畫面都是六點鐘的垂直位置，所以從三點鐘到六點鐘需要旋轉90度。
autoFocus : 設定對焦事件，引數為AutoFocusCallback型別。比如說在對焦成功時顯示一個圖片提示使用者可以拍照了。
takePicture : 拍照。第一個引數ShutterCallback用來控制按下快門時的事件，我們可在此播放拍照聲音，預設就是咔嚓一聲；後面的幾個回撥介面PictureCallback分別對應原始影象、縮放和壓縮影象和JPG影象，影象資料可以在介面中的onPictureTaken方法中獲得，通常我們只關心最後一個的JPG影象資料，所以前面的介面引數可以直接傳null。
release : 釋放攝像頭。每次退出拍照都要釋放，因為攝像頭不能重複開啟，要麼就是把Camera物件做成單例模式。

預覽檢視SurfaceView/預覽持有者SurfaceHolder

SurfaceView是Android中的一種特殊檢視，它擁有獨立的繪圖表面，即它不與其宿主頁面共享同一個繪圖表面。由於擁有獨立的繪圖表面，因此SurfaceView的介面就可以在一個獨立的執行緒中進行繪製，我們稱之為渲染執行緒。因為它不佔用主執行緒資源，所以一方面可以實現複雜而高效的UI，另一方面也會及時響應使用者輸入。鑑於SurfaceView具備如上特性，故而它可用於拍照以及錄影的預覽介面，也可用於遊戲的畫面。


不過SurfaceView自身主要完成繪圖功能，其他功能設定以及事件處理還有待於SurfaceHolder來操作。SurfaceView的getHolder方法把二者關聯了起來，可獲取預覽介面當前幹活的操縱者。SurfaceHolder應與SurfaceView配合使用，下面是SurfaceHolder的常用方法：
addCallback : 添加回調介面
removeCallback : 移除回撥介面
isCreating : 判斷預覽介面是否有效
setFormat : 設定預覽格式。PixelFormat.TRANSPARENT表示透明，PixelFormat.TRANSLUCENT表示半透明，PixelFormat.OPAQUE表示不透明。
setFixedSize : 設定預覽介面的尺寸
setSizeFromLayout : 設定預覽介面的尺寸為佈局檔案中的配置
getSurfaceFrame : 獲取預覽介面的尺寸
getSurface : 獲取預覽檢視的物件。主要用於播放視訊。

拍照的相關事件

下面是幾個拍照用到的回撥事件介面：

預覽變化事件 
監聽器類名 : SurfaceHolder.Callback
設定監聽器的方法 : 
Camera.setPreviewDisplay : 新增預覽持有者SurfaceHolder。該方法用於關聯Camera和SurfaceHolder
SurfaceHolder.addCallback : 添加回調介面Callback。該方法用於關聯SurfaceView和SurfaceHolder，它與Camera.setPreviewDisplay最終聯合完成SurfaceView與Camera的關聯，即攝像頭的畫面展示在預覽介面上。
SurfaceHolder.removeCallback : 移除回撥介面Callback
監聽器需要重寫的方法 : 
surfaceCreated : 預覽建立。不管是拍照還是錄影，通常在該方法中設定拍照預覽Camera.setPreviewDisplay。
surfaceChanged : 預覽變化
surfaceDestroyed : 預覽結束。注意SurfaceView的渲染執行緒只在surfaceCreated和surfaceDestroyed之間有效，所以如果在別處操作SurfaceView畫面，得判斷當前預覽介面是否有效，也就是呼叫SurfaceHolder.isCreating方法來判斷。

自動對焦事件 
監聽器類名 : Camera.AutoFocusCallback
設定監聽器的方法 : Camera.autoFocus
監聽器需要重寫的方法 : onAutoFocus

快門按下事件 
監聽器類名 : Camera.ShutterCallback
設定監聽器的方法 : Camera.takePicture
監聽器需要重寫的方法 : onShutter

拍照事件 
監聽器類名 : Camera.PictureCallback
設定監聽器的方法 : Camera.takePicture
監聽器需要重寫的方法 : onPictureTaken

變焦事件 
監聽器類名 : Camera.OnZoomChangeListener
設定監聽器的方法 : Camera.setZoomChangeListener
監聽器需要重寫的方法 : onZoomChange

掃描二維碼

這個功能最有名的應用就是微信裡的“掃一掃”了，通過攝像頭拍照從二維碼中獲取相關資訊，然後再進行相應操作（比如說新增好友、下載檔案、訪問頁面等等）。Android中的二維碼掃描可用Google的zxing開源庫，再結合zxing的使用框架MipcaActivityCapture。
下面是zxing+MipcaActivityCapture框架的程式碼整合例子：
1、給工程加入zxing3.2.1.jar；
2、把MipcaActivityCapture原始碼（com.app.zxing）加入到工程；
3、編寫MipcaActivityCapture的佈局檔案activity_capture.xml，主要是加入SurfaceView和com.app.zxing.view.ViewfinderView兩個檢視，前一個檢視是預覽介面，後一個是掃碼介面；
4、如果需要調整掃描介面的UI，則修改ViewfinderView的onDraw方法，可加入新的元素或者調整尺寸。
5、對掃碼結果的處理見MipcaActivityCapture的handleDecode方法，視情況做相應處理，如新增好友、下載檔案、訪問頁面等等。

程式碼示例

下面是相機檢視CameraView的程式碼示例：

import com.example.exmcamera.util.BitmapUtil;
import com.example.exmcamera.util.MetricsUtil;

import android.content.Context;
import android.graphics.Bitmap;
import android.graphics.BitmapFactory;
import android.graphics.ImageFormat;
import android.graphics.PixelFormat;
import android.graphics.Point;
import android.hardware.Camera;
import android.hardware.Camera.PictureCallback;
import android.hardware.Camera.ShutterCallback;
import android.util.AttributeSet;
import android.util.Log;
import android.view.SurfaceHolder;
import android.view.SurfaceView;

public class CameraView extends SurfaceView implements SurfaceHolder.Callback {
	private static final String TAG = "CameraView";
	private Context mContext;
	private Camera mCamera;
    private Bitmap mBitmap = null;
	private SurfaceHolder mHolder = null;
	private boolean isPreviewing = false;
	private Point mCameraSize;
	private int mCameraType = CAMERA_BEHIND;
	public static int CAMERA_BEHIND = 0;
	public static int CAMERA_FRONT = 1;

	public CameraView(Context context, AttributeSet attrs) {
		super(context, attrs);
		mContext = context;
		mHolder = getHolder();
		mHolder.setFormat(PixelFormat.TRANSPARENT);//translucent半透明 transparent透明
		//mSurfaceHolder.setType(SurfaceHolder.SURFACE_TYPE_PUSH_BUFFERS);
		mHolder.addCallback(this);
	}

	public CameraView(Context context) {
		this(context, null);
	}

	public int getCameraType() {
		return mCameraType;
	}
	
	public void setCameraType(int CameraType) {
		mCameraType = CameraType;
	}

	public Bitmap getPhoto() {
		if (mBitmap != null) {
			Log.d(TAG, "mBitmap.size="+(mBitmap.getByteCount()/1024)+"K");
		} else {
			Log.d(TAG, "mBitmap is null.");
		}
		return mBitmap;
	}

	public void doTakePicture() {
		if(isPreviewing && (mCamera != null)) {
			mCamera.takePicture(mShutterCallback, null, mPictureCallback);
		}
	}

	//快門按下的回撥，在這裡我們可以設定類似播放“咔嚓”聲之類的操作。預設的就是咔嚓。
	ShutterCallback mShutterCallback = new ShutterCallback() {
		public void onShutter() {
			Log.d(TAG, "myShutterCallback:onShutter...");
		}
	};
	
	PictureCallback mPictureCallback = new PictureCallback() {
		public void onPictureTaken(byte[] data, Camera camera) {
			Log.d(TAG, "mPictureCallback:onPictureTaken...");
			Bitmap b = null;
			if(null != data) {
				b = BitmapFactory.decodeByteArray(data, 0, data.length);//data是位元組資料，將其解析成點陣圖
				mCamera.stopPreview();
				isPreviewing = false;
			}
			if (mCameraType == CameraView.CAMERA_BEHIND) {
				mBitmap = BitmapUtil.getRotateBitmap(b, 90);
			} else {
				mBitmap = BitmapUtil.getRotateBitmap(b, -90);
			}
			Log.d(TAG, "mBitmap.size="+(mBitmap.getByteCount()/1024)+"K");
			try {
				Thread.sleep(1000);
			} catch (InterruptedException e) {
				e.printStackTrace();
			}
			//再次進入預覽
			mCamera.startPreview();
			isPreviewing = true;
		}
	};

	@Override
	public void surfaceCreated(SurfaceHolder mHolder) {
		// 當預覽檢視建立的時候開啟相機
		mCamera = Camera.open(mCameraType);
		try {
			// 設定預覽
			mCamera.setPreviewDisplay(mHolder);
			mCameraSize = MetricsUtil.getCameraSize(mCamera.getParameters(), MetricsUtil.getSize(mContext));
			Log.d(TAG, "width="+mCameraSize.x+", height="+mCameraSize.y);
		    Camera.Parameters parameters = mCamera.getParameters();
			// 設定預覽大小
		    parameters.setPreviewSize(mCameraSize.x, mCameraSize.y);
			// 設定圖片儲存時的解析度大小
			parameters.setPictureSize(mCameraSize.x, mCameraSize.y);
			// 設定格式
			parameters.setPictureFormat(ImageFormat.JPEG);
			// 設定自動對焦。前置攝像頭似乎無法自動對焦
			if (mCameraType == CameraView.CAMERA_BEHIND) {
				parameters.setFocusMode(Camera.Parameters.FOCUS_MODE_AUTO);
			}
		    mCamera.setParameters(parameters);
		} catch (Exception e) {
			Log.d(TAG, "setPreviewDisplay error: "+e.getMessage());
			// 釋放相機資源並置空
			mCamera.release();
			mCamera = null;
		}
		return;
	}

	@Override
	public void surfaceChanged(SurfaceHolder mHolder, int format, int width, int height) {
		Log.d(TAG, "surfaceChanged");
		mCamera.setDisplayOrientation(90);
		// 開始預覽
		mCamera.startPreview();
		isPreviewing = true;
		mCamera.autoFocus(null);
	}

	@Override
	public void surfaceDestroyed(SurfaceHolder mHolder) {
		Log.d(TAG, "surfaceDestroyed");
		mCamera.stopPreview();
		mCamera.release();
		mCamera = null;
	}

}

下面是拍照頁面CameraActivity的程式碼示例：

import java.text.SimpleDateFormat;
import java.util.Date;

import com.example.exmcamera.R;
import com.example.exmcamera.util.BitmapUtil;
import com.example.exmcamera.util.MetricsUtil;
import com.example.exmcamera.widget.CameraView;

import android.app.Activity;
import android.content.Intent;
import android.graphics.Bitmap;
import android.graphics.Point;
import android.os.Bundle;
import android.util.Log;
import android.view.View;
import android.view.Window;
import android.view.View.OnClickListener;
import android.view.ViewGroup.LayoutParams;
import android.widget.ImageButton;

public class CameraActivity extends Activity implements OnClickListener {
	private static final String TAG = "CameraActivity";
	private CameraView cameraView;
	private ImageButton shutterBtn;
	private int mCameraType;
	
	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
        requestWindowFeature(Window.FEATURE_NO_TITLE);
		setContentView(R.layout.item_camera);
		mCameraType = getIntent().getIntExtra("type", CameraView.CAMERA_BEHIND);
		cameraView = (CameraView)findViewById(R.id.camera_view);
		cameraView.setCameraType(mCameraType);
		shutterBtn = (ImageButton)findViewById(R.id.btn_shutter);
		shutterBtn.setOnClickListener(this);
		initViewParams();
	}

	private void initViewParams(){
		LayoutParams paramsLayout = cameraView.getLayoutParams();
		Point size = MetricsUtil.getSize(this);
		paramsLayout.width = size.x;
		paramsLayout.height = size.y;
		cameraView.setLayoutParams(paramsLayout);

		LayoutParams paramsButton = shutterBtn.getLayoutParams();
		paramsButton.width = MetricsUtil.dip2px(this, 60);
		paramsButton.height = MetricsUtil.dip2px(this, 60);
		shutterBtn.setLayoutParams(paramsButton);
	}

	@Override
	public void onBackPressed() {
        Intent intent = new Intent();
		Bundle bundle = new Bundle();
		Bitmap bitmap = cameraView.getPhoto();
		if (bitmap == null) {
			bundle.putString("is_null", "yes");
		} else {
			bundle.putString("is_null", "no");
			String path = String.format("%s%s.jpg", BitmapUtil.getCachePath(this),getNowDateTime());
			BitmapUtil.saveFile(cameraView.getPhoto(), path);
			bundle.putString("path", path);
		}
		intent.putExtras(bundle);
        setResult(Activity.RESULT_OK, intent);
        finish();
	}

	private String getNowDateTime() {
		SimpleDateFormat s_format = new SimpleDateFormat("yyyyMMddHHmmss");
		Date d_date = new Date();
		String s_date = "";
		s_date = s_format.format(d_date);
		return s_date;
	}

	@Override
	public void onClick(View v) {
		if (v.getId() == R.id.btn_shutter) {
			cameraView.doTakePicture();
		}
	}

}

點此檢視Android開發筆記的完整目錄