OPhone Camera教程 -- 如何在程序中使用照相机
在本教程中将介绍如何在程序中使用OPhone手机的摄像头来拍照,有些程序是需要使用手机摄像头作为输入设备的,例如二维码识别软件。
OPhone Camera 介绍
在OPhone手机中通过android.hardware.Camera类来控制摄像头设备,通过Camera类可以与摄像头服务取得(断开)链接、可以设置摄像头的各种属性、开始(结束)图像预览、拍照或则录像。要使用Camera只有通过调用Camera的open() 函数来得到一个Camera对象。另外OPhone系统还提供了一些接口来控制Camera的状态:
- android.hardware.Camera.AutoFocusCallback :当摄像头自动对焦的时候调用,该接口具有一个函数 voidonAutoFocus(boolean success, Camera camera);当自动对焦成功的时候success参数的值为true,否则为false。
- android.hardware.Camera.ErrorCallback :当摄像头出错的时候调用,该接口具有一个函数 void onError(interror, Camera camera); 参数error为错误类型,其取值为Camera类中的常量CAMERA_ERROR_UNKNOWN或CAMERA_ERROR_SERVER_DIED;前者表明错误类型不明确,后者表明服务已关闭,在这种情况下必须释放当前的Camera对象然后重新初始化一个。
- android.hardware.Camera.PreviewCallback :在图像预览时候调用,该接口具有一个函数voidonPreviewFrame(byte[] data, Camera camera); 参数data为每帧图像的数据流。
- android.hardware.Camera.ShutterCallback :当摄像头快门关闭的时候调用,该接口具有一个函数voidonShutter(); 可以在该函数中通知用户快门已关闭,例如播放一个声音。
- android.hardware.Camera.PictureCallback :当拍摄照片的时候调用,该接口具有一个函数voidonPictureTaken(byte[] data, Camera camera); 参数data为拍摄照片的数据流。
当取得照片的数据流后可以通过BitmapFactory的 decodeByteArray() 函数来解析图片。
另外还可以通过Camera对象的getParameters()函数得到一个android.hardware.Camera.Parameters对象,Parameters提供了一些接口来设置Camera的属性:
- setPictureFormat(int pixel_format):设置图片的格式,其取值为PixelFormat.YCbCr_420_SP、PixelFormat.RGB_565或则PixelFormat.JPEG。
- setPreviewFormat(int pixel_format):设置图片预览的格式,取值同上。
- setPictureSize(int width, int height):设置图片的高度和宽度,单位为像素。
- setPreviewSize(int width, int height):设置图片预览的高度和宽度,取值同上。
- setPreviewFrameRate(int fps):设置图片预览的帧速。
在设置好Camera的参数后,可以通过函数void startPreview()开始预览图像、void stopPreview()结束预览,通过autoFocus(AutoFocusCallback cb)来自动对焦,最后可以通过takePicture(ShutterCallback shutter, PictureCallback raw, PictureCallback jpeg)函数来拍照。该函数有三个参数,分别为快门回调接口、原生图像数据接口和压缩格式图片数据接口。如果数据格式不存在的话数据流为空,如果不需要实现这些接口则这些参数取值可以为null。
以上就是关于OPhone Camera的基础知识和相关的API介绍,下面来具体看看如何在程序中拍照并使用照片。
OPhone Camera 实战
这个示例将显示预览图像,在图像上点击则触发拍照操作,拍照成功后显示所拍的照片,然后点击Start菜单可以继续拍照。
首先通过OPhone开发工具(ODT)创建一个OPhone项目,填写基本信息后ODT会自动创建一个/src/org/goodev/camera/CameraActivity.java文件和res/layout/main.xml文件。
把main.xml文件内容修改为如下:
- <?xml version="1.0" encoding="utf-8"?>
- <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
- android:orientation="vertical"
- android:layout_width="fill_parent"
- android:layout_height="fill_parent"
- >
- <SurfaceView android:id="@+id/camera"
- android:layout_width="fill_parent"
- android:layout_height="fill_parent"/>
- <ImageView android:id="@+id/image"
- android:layout_width="fill_parent"
- android:layout_height="fill_parent"/>
- </LinearLayout>
SurfaceView 用来预览图像,ImageView 用来显示所拍的照片。这里也需读者会问,为什么要使用SurfaceView 来预览图像?使用其他的View不可以吗?要回答这个问题,需要了解下SurfaceView 的作用,关于SurfaceView 的详细介绍已超出了本教程的范围,我们会在后续教程中来详细介绍SurfaceView ,这里只做简要介绍。
在通常情况下,OPhone程序中的View都是在同一个GUI线程中绘制的,该线程也是接收用户交互事件的线程(例如:按钮点击事件)。从另外的线程修改GUI元素是不可以的,如果要迅速的更新UI显示该如何办?显然在主线程中还需要处理其他事件,不适合做这件事情,所以OPhone提供了SurfaceView 来满足这种需求。一个SurfaceView 包装一个Surface对象(通过SurfaceHolder操作该对象)而不是Canvas对象,这就是关键所在,Surface可以在其他线程中绘制,这对于周期性更新和要求高帧率的场景来说是很有用的,特别是在游戏开发中。Surface中包含了当前UI的原生数据(raw data),在不同的软件和硬件条件下对这些数据的处理是不一样的,这就可以通过一些设置来加速图形的绘制,可以通过SurfaceHolder的setType函数来设置,目前接收如下的参数:
- SURFACE_TYPE_NORMAL:用RAM缓存原生数据的普通Surface
- SURFACE_TYPE_HARDWARE:适用于DMA(Direct memory access )引擎和硬件加速的Surface
- SURFACE_TYPE_GPU:适用于GPU加速的Surface
- SURFACE_TYPE_PUSH_BUFFERS:表明该Surface不包含原生数据,Surface用到的数据由其他对象提供,在Camera图像预览中就使用该类型的Surface,有Camera负责提供给预览Surface数据,这样图像预览会比较流畅。如果在这里设置了上面三种类型则可以发现不会出现预览图像,在和Camera底层的预览机制实现有关,如果对预览有特殊要求的可以现实PreviewCallback 接口来自己处理。
关于SurfaceView先简单介绍到这里,下面来继续看看如何在代码中实现。
修改CameraActivity类使其实现如下接口:
- android.view.SurfaceHolder.Callback
- android.view.View.OnClickListener
在CameraActivity的onCreate函数中初始化相关资源:
- public void onCreate(Bundle savedInstanceState) {
- super.onCreate(savedInstanceState);
- requestWindowFeature(Window.FEATURE_NO_TITLE);
- getWindow().setFormat(PixelFormat.TRANSLUCENT);
- getWindow().setFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN,
- WindowManager.LayoutParams.FLAG_FULLSCREEN);
- setContentView(R.layout.main);
- mSurfaceView = (SurfaceView) findViewById(R.id.camera);
- mImageView = (ImageView) findViewById(R.id.image);
- mImageView.setVisibility(View.GONE);
- mSurfaceView.setOnClickListener(this);
- mSurfaceHolder = mSurfaceView.getHolder();
- mSurfaceHolder.addCallback(this);
- mSurfaceHolder.setType(SurfaceHolder.SURFACE_TYPE_PUSH_BUFFERS);
上面的代码首先设置窗口为全屏幕无标题的窗口,然后取得SurfaceView和ImageView对象并设置mSurfaceView的OnClickListener和mSurfaceHolder 的回调函数,最后设置mSurfaceHolder的类型为SurfaceHolder.SURFACE_TYPE_PUSH_BUFFERS。
当surface创建后初始化Camera对象,代码如下:
- public void surfaceCreated(SurfaceHolder holder) {
- mCamera = Camera.open();
- }
当surface摧毁的时候释放Camera对象,代码如下:
- public void surfaceDestroyed(SurfaceHolder holder) {
- mCamera.stopPreview();
- mPreviewRunning = false;
- mCamera.release();
- mCamera = null;
- }
当surface状态改变的时候,重置Camera的状态,代码如下:
- public void surfaceChanged(SurfaceHolder holder, int format, int width,
- int height) {
- if (mPreviewRunning) {
- mCamera.stopPreview();
- }
- Parameters params = mCamera.getParameters();
- params.setPreviewSize(width, height);
- mCamera.setParameters(params);
- try {
- mCamera.setPreviewDisplay(holder);
- } catch (IOException e) {
- e.printStackTrace();
- }
- mCamera.startPreview();
- mPreviewRunning = true;
- }
当在surface上点击的时候拍照,代码如下:
- public void onClick(View v) {
- mCamera.takePicture(mShutterCallback, null, mPictureCallback);
- }
在mPictureCallback中读取所拍的照片并显示:
- PictureCallback mPictureCallback = new PictureCallback() {
- public void onPictureTaken(byte[] data, Camera camera) {
- Log.d("PictureCallback", "...onPictureTaken...");
- if (data != null) {
- Bitmap bitmap = BitmapFactory.decodeByteArray(data, 0,
- data.length);
- mImageView.setImageBitmap(bitmap);
- mImageView.setVisibility(View.VISIBLE);
- mSurfaceView.setVisibility(View.GONE);
- if (mPreviewRunning) {
- mCamera.stopPreview();
- mPreviewRunning = false;
- }
- }
- }
- };
最后不要忘记使用Camera是需要权限的,在AndroidManifest.xml文件中添加如下设置:
- <uses-permission android:name="android.permission.CAMERA"/>
总结:通过以上示例程序可以看出在OPhone中使用设备的Camera是相当简单的,现在你就可以通过Camera来实现各种新奇的应用了,是否已经想跃跃欲试了?那就开始吧!
附录:CameraActivity完整代码
- package org.goodev.camera;
- import java.io.IOException;
- import android.app.Activity;
- import android.graphics.Bitmap;
- import android.graphics.BitmapFactory;
- import android.graphics.PixelFormat;
- import android.hardware.Camera;
- import android.hardware.Camera.Parameters;
- import android.hardware.Camera.PictureCallback;
- import android.hardware.Camera.ShutterCallback;
- import android.os.Bundle;
- import android.util.Log;
- import android.view.Menu;
- import android.view.MenuItem;
- import android.view.SurfaceHolder;
- import android.view.SurfaceView;
- import android.view.View;
- import android.view.Window;
- import android.view.WindowManager;
- import android.view.SurfaceHolder.Callback;
- import android.view.View.OnClickListener;
- import android.widget.ImageView;
- public class CameraActivity extends Activity
- implements Callback, OnClickListener {
- private static final int MENU_START = 1;
- private SurfaceView mSurfaceView;
- private SurfaceHolder mSurfaceHolder;
- private Camera mCamera;
- private boolean mPreviewRunning;
- private ImageView mImageView;
- /**
- * 拍照的回调接口
- */
- PictureCallback mPictureCallback = new PictureCallback() {
- public void onPictureTaken(byte[] data, Camera camera) {
- Log.d("PictureCallback", "...onPictureTaken...");
- if (data != null) {
- Bitmap bitmap = BitmapFactory.decodeByteArray(data, 0,
- data.length);
- mImageView.setImageBitmap(bitmap);
- mImageView.setVisibility(View.VISIBLE);
- mSurfaceView.setVisibility(View.GONE);
- if (mPreviewRunning) {
- mCamera.stopPreview();
- mPreviewRunning = false;
- }
- }
- }
- };
- /**
- * 在相机快门关闭时候的回调接口,通过这个接口来通知用户快门关闭的事件,
- * 普通相机在快门关闭的时候都会发出响声,根据需要可以在该回调接口中定义各种动作,
- * 例如:使设备震动
- */
- ShutterCallback mShutterCallback = new ShutterCallback() {
- public void onShutter() {
- //just log ,do nothing
- Log.d("ShutterCallback", "...onShutter...");
- }
- };
- /** Called when the activity is first created. */
- @Override
- public void onCreate(Bundle savedInstanceState) {
- super.onCreate(savedInstanceState);
- requestWindowFeature(Window.FEATURE_NO_TITLE);
- getWindow().setFormat(PixelFormat.TRANSLUCENT);
- getWindow().setFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN,
- WindowManager.LayoutParams.FLAG_FULLSCREEN);
- setContentView(R.layout.main);
- mSurfaceView = (SurfaceView) findViewById(R.id.camera);
- mImageView = (ImageView) findViewById(R.id.image);
- mImageView.setVisibility(View.GONE);
- mSurfaceView.setOnClickListener(this);
- mSurfaceHolder = mSurfaceView.getHolder();
- mSurfaceHolder.addCallback(this);
- mSurfaceHolder.setType(SurfaceHolder.SURFACE_TYPE_PUSH_BUFFERS);
- }
- @Override
- public boolean onCreateOptionsMenu(Menu menu) {
- super.onCreateOptionsMenu(menu);
- menu.add(0, MENU_START, 0, R.string.menu_start);
- return true;
- }
- @Override
- public boolean onOptionsItemSelected(MenuItem item) {
- if (item.getItemId() == MENU_START) {
- mImageView.setVisibility(View.GONE);
- mSurfaceView.setVisibility(View.VISIBLE);
- if (mPreviewRunning) {
- mCamera.stopPreview();
- }
- mCamera.startPreview();
- mPreviewRunning = true;
- return true;
- }
- return super.onOptionsItemSelected(item);
- }
- public void surfaceChanged(SurfaceHolder holder, int format, int width,
- int height) {
- if (mPreviewRunning) {
- mCamera.stopPreview();
- }
- Parameters params = mCamera.getParameters();
- params.setPreviewSize(width, height);
- mCamera.setParameters(params);
- try {
- mCamera.setPreviewDisplay(holder);
- } catch (IOException e) {
- e.printStackTrace();
- }
- mCamera.startPreview();
- mPreviewRunning = true;
- }
- public void surfaceCreated(SurfaceHolder holder) {
- mCamera = Camera.open();
- }
- public void surfaceDestroyed(SurfaceHolder holder) {
- mCamera.stopPreview();
- mPreviewRunning = false;
- mCamera.release();
- mCamera = null;
- }
- public void onClick(View v) {
- mCamera.takePicture(mShutterCallback, null, mPictureCallback);
- }
- }