Question

PreviewCallback,onPreviewFrame，AsyncTask 的综合应用

很多时候，android 摄像头模块不仅预览，拍照这么简单，而是需要在预览视频的时候，能够做出一些检测，比如最常见的人脸检测。在未按下拍照按钮前，就检测出人脸然后矩形框标示出来，再按拍照。那么如何获得预览帧视频么？

只需要在 Activity 里继承 PreviewCallback 这个接口就行了。示例如下：

public class RectPhoto extends Activity implements SurfaceHolder.Callback, PreviewCallback{} ​。（注意这个 SurfaceHolder.Callback ​是用来预览摄像头视频，参见 我的前贴 ）。

继承这个方法后，会自动重载这个函数： public void onPreviewFrame(byte[] data, Camera camera) {} ​这个函数里的 data 就是实时预览帧视频。一旦程序调用 PreviewCallback 接口，就会自动调用 onPreviewFrame 这个函数。调用 PreviewCallback 的方法有三种，可以参考 这里 ，总共有三种方式调用这个回调。所谓回调就是当条件满足时，自动触发调用这个函数。分别是： .setPreviewCallback, setOneShotPreviewCallback ​、 setPreviewCallbackWithBuffer ​，我一般是使用第二种方式。

这里解释下，如果 Activity 继承了 PreviewCallback 这个接口，只需 Camera.setOneShotPreviewCallback(this); ​就可以了。程序会自动调用主类 Activity 里的 onPreviewFrame 函数。如果 Camera.setOneShotPreviewCallback() ​这个函数是在主类 Activity 里的内部类如 class A 里面，里面的参数应写为 Camera.setOneShotPreviewCallback(YourActivity.this) ​。当然这里，也可以定义一个变量，如 Camera.PreviewCallback mPreviewCallback,在调用的时候用 Camera.setOneShotPreviewCallback(mPreviewCallback) ​来完成。相信很多人都熟悉这点，就不罗嗦了。

按理说只要在 onPreviewFrame（）这个函数里写你的处理程序就可以了。当通常不这么做，因为处理实时预览帧视频的算法可能比较复杂，这就需要借助 AsyncTask 开启一个线程在后台处理数据。这里假设我们定义一个 FaceTask 来进行人脸检测，可以这样写：

/* 自定义的 FaceTask 类，开启一个线程分析数据 */
private class FaceTask extends AsyncTask<Void, Void, Void>{
  private byte[] mData;
  //构造函数
  PalmTask(byte[] data){
    this.mData = data;
  }
  @Override
  protected Void doInBackground(Void... params) {
    // TODO Auto-generated method stub
    Size size = myCamera.getParameters().getPreviewSize(); //获取预览大小
    final int w = size.width; //宽度
    final int h = size.height;
    final YuvImage image = new YuvImage(mData, ImageFormat.NV21, w, h, null);
    ByteArrayOutputStream os = new ByteArrayOutputStream(mData.length);
    if(!image.compressToJpeg(new Rect(0, 0, w, h), 100, os)){
      return null;
    }
    byte[] tmp = os.toByteArray();
    Bitmap bmp = BitmapFactory.decodeByteArray(tmp, 0,tmp.length);
    doSomethingNeeded(bmp); //自己定义的实时分析预览帧视频的算法
    return null;
  }
}

注意上面的 bmp 就是 Bitmap 格式的实时预览帧数据。 doSomethingNeeded(bmp) 就是你要对预览帧视频进行的处理，可以是检测人脸或其他，如分析有无火灾。或者是进行传输。 另外，这里是通过 YuvImage 和 ImageFormat.NV21 来解析数据的。在华为 u9200 上，android4.0.3 的系统运行良好。不同手机上支持的格式可能有所不同。网上也有自己写算法进行转化的，需要的可以自己找，但这里如果支持这个格式就不用自己写转换算法了。
onPreviewFrame() 里可以这样写：

/* 获取预览帧视频 */
public void onPreviewFrame(byte[] data, Camera camera) {
  // TODO Auto-generated method stub
  if(null != mFaceTask){
    switch(mFaceTask.getStatus()){
      case RUNNING:
      return;
      case PENDING:
      mFaceTask.cancel(false);
      break;
    }
  }
  mFaceTask = new PalmTask(data);
  mFaceTask.execute((Void)null);
}

上面的 mFaceTask 是一个全局变量。通过 onPreviewFrame，AsyncTask 的综合应用，让复杂的处理算法执行在后台，也就是 doInBackground 这里，是不是比较绿色？

接下来就是什么时候触发 onPreviewFrame() 这个函数里，可以是按一个按键触发一次，就在按键的监听里写上 myCamera.setOneShotPreviewCallback(RectPhoto.this);便会自动触发一次。有人说想先聚焦，然后再分析预览帧。就在 onAutofocus 里的回调写。如下：

//自动聚焦变量回调
myAutoFocusCallback = new AutoFocusCallback() {
  public void onAutoFocus(boolean success, Camera camera) {
    // TODO Auto-generated method stub
    if(success) //success 表示对焦成功
    {
      Log.i(tag, "myAutoFocusCallback: success...");
      myCamera.setOneShotPreviewCallback(RectPhoto.this);
    }else{
      //未对焦成功
      Log.i(tag, "myAutoFocusCallback: 失败了...");
      //这里也可以加上 myCamera.autoFocus(myAutoFocusCallback)，如果聚焦失败就再次启动聚焦。
    }
  }
};

大多数时候，希望程序自动每隔多长时间，自动进行一次检测预览帧。这也好办，实施如下：

  class ScanThread implements Runnable{

    public void run() {
      // TODO Auto-generated method stub
      while(!Thread.currentThread().isInterrupted()){
        try {
          if(null != myCamera && isPreview)
          {  
//myCamera.autoFocus(myAutoFocusCallback);
            myCamera.setOneShotPreviewCallback(RectPhoto.this);
            Log.i(tag, "setOneShotPreview...");
          }
          Thread.sleep(1500);
        } catch (InterruptedException e) {
          // TODO Auto-generated catch block
          e.printStackTrace();
          Thread.currentThread().interrupt();
        }
      }

    }

  }

在 onCreate 里 new Thread(new ScanThread()).start() 开启扫描线程。如果想手动触发中止这种扫描活动，可以在 ScanThread 里的 while 循环里设置标志位，具体可看我 以前的博文 。

最后提醒的是，如果程序中加入了 previewCallback，在 surfaceDestroy 释放 camera 的时候，最好执行 myCamera.setOneShotPreviewCallback(null); 或者 myCamera.setPreviewCallback(null);中止这种回调，然后再释放 camera 更安全。否则可能会报错。