-
把预览类放到布局中
Camera的预览类,如上文所示的示例,必须要跟用户界面控件一起放到一个Activity的布局中,以便拍照或录像。本段向你显示如果构建一个基本的用于预览的Activity布局。
下面的布局代码提供了一个很基本的View,它能够用于显示Camera的预览图像。在这个示例中,FrameLayout元素被用于Camera预览类的容器。使用这个布局类型可以让额外的图像信息或控件能够覆盖在实时的Camera预览图像之上。
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:orientation="horizontal"
android:layout_width="fill_parent"
android:layout_height="fill_parent"
>
<FrameLayout
android:id="@+id/camera_preview"
android:layout_width="fill_parent"
android:layout_height="fill_parent"
android:layout_weight="1"
/>
<Button
android:id="@+id/button_capture"
android:text="Capture"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_gravity="center"
/>
</LinearLayout>
在大多数设备上,Camera预览的默认方向是横向。这个示例布局指定了一个水平(横向)布局,并且下面的代码把应用程序固定为横向。为了简化Camera预览中的展现,你应该通过在你的清单文件中添加以下设置,把应用程序的预览Activity的方向改变为横向的:
<activity android:name=".CameraActivity"
android:label="@string/app_name"
android:screenOrientation="landscape">
<!-- configure this activity to use landscape orientation -->
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
注意:Camera的预览不一定就是横屏模式。从Android2.2(API Level8)开始,你能够使用setDisplayOrientation()方法来设置预览图像的旋转。为了重新定位用户手的预览方向,在你的预览类的surfaceChanged()方法中,首先要用Camera.stopPreview()方法停止预览,然后改变方向,再用Camera.startPreview()方法启动预览。
在Camera View的Activity中,把你的预览类添加到上例所示的FrameLayout元素中。你的Camera Activity还必须确保在它被挂起或关闭时,要释放Camera对象。以下示例显示如何把上文中创建的预览类添加到Camera的Activity中:
public class CameraActivity extends Activity {
private Camera mCamera;
private CameraPreview mPreview;
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
// Create an instance of Camera
mCamera = getCameraInstance();
// Create our Preview view and set it as the content of our activity.
mPreview = new CameraPreview(this, mCamera);
FrameLayout preview = (FrameLayout) findViewById(R.id.camera_preview);
preview.addView(mPreview);
}
}
注意:上例中的getCameraInstance()方法引用了上文“访问Camera”中的示例方法。
采集图片
一旦你构建了一个预览类,并把它放到了一个View中,你就可以开始用你的应用程序来采集应用程序了。在你的应用程序代码中,必须建立用于响应用户拍照操作的用户界面控件的监听器。
要使用Camera.takePicture()方法来获取一张图片。这个方法需要3个参数来接收来自Camera的数据。为了接收JPEG格式的数据,你必须实现接收图片数据的Camera.PictureCallback接口,并把接收到数据写到一个文件中。下面的代码显示了一个Camera.PictureCallback接口的基本实现,它把从Camera接收到的数据保存到一个图片文件中:
private PictureCallback mPicture = new PictureCallback() {
@Override
public void onPictureTaken(byte[] data, Camera camera) {
File pictureFile = getOutputMediaFile(MEDIA_TYPE_IMAGE);
if (pictureFile == null){
Log.d(TAG, "Error creating media file, check storage permissions: " +
e.getMessage());
return;
}
try {
FileOutputStream fos = new FileOutputStream(pictureFile);
fos.write(data);
fos.close();
} catch (FileNotFoundException e) {
Log.d(TAG, "File not found: " + e.getMessage());
} catch (IOException e) {
Log.d(TAG, "Error accessing file: " + e.getMessage());
}
}
};
通过调用Camera.takePicture()方法来触发采集图片的操作。下面的示例代码显示了如何从一个按钮的View.OnClickListener中调用这个方法:
// Add a listener to the Capture button
Button captureButton = (Button) findViewById(id.button_capture);
captureButton.setOnClickListener(
new View.OnClickListener() {
@Override
public void onClick(View v) {
// get an image from the camera
mCamera.takePicture(null, null, mPicture);
}
}
);
注意:代码中的mPicture成员变量会在下面的示例代码中引用。
警告:记住,在应用程序使用完Camera对象后,一定要调用Camera.release()方法来释放Camera对象。
采集视频
使用Android框架采集视频需要认真的管理Camera对象,以及跟MediaRecorder类的协调。当使用Camera对象记录视频时,除了Camera.open()和Camera.release()方法的调用以外,还必须管理Camera.lock()和Camera.unlock()方法的调用,从而允许MediaRecorder对象访问Camera硬件。
注意:从Android4.0(API Level 14)开始,Camera.lock()和Camera.unlock()方法调用系统会为你自动管理。
跟拍照不一样,采集视频需要非常特殊的调用顺序,必须按照一个特定执行顺序来准备和采集视频,详细如下:
1. 打开Camera:使用Camera.open()方法来获得一个Camera对象的实例。
2. 连接预览:使用Camera.setPreviewDisplay()方法把SurfaceView跟Camera连接起来,准备一个实时的Camera图像预览界面。
3. 启动预览:调用Camera.starPreview()方法开始显示实时的Camera图像。
4. 启动视频录像:为了成功的记录视频,必须完成以下步骤。
a. 给Camera对象解锁:通过调用Camera.unlock()方法给由MediaRecorder对象使用的Camera对象解锁。
b. 配置MediaRecorder对象:在这一步中要调用以下MediaRecorder方法。更多信息,请看MediaRecorder参考文档。
1. setCamera():使用应用程序当前的Camera实例,把它设置成用于视频采集;
2. setAudiioSource():使用MediaRecorder.AudioSource.CAMCORDER,设置音频源;
3. setVideoSource():使用MediaRecorder.VideoSource.CAMERA来设置视频源;
4. 设置视频的输出格式和编码。对于Android2.2以上的版本,要使用MediaRecorder.setProfile方法,并且要私用CamcorderProfile.get()方法来获得一个Profile的示例。对于Android2.2以前的版本,必须要设置视频输出的格式和编码参数:
I. setOutputFormat():设置输出格式,指定默认设置,或者是MediaRecorder.OutputFormat.MPEG_4;
II. setAudioEncoder():设置声音的编码类型,指定默认设置,或者是MediaRecorder.AudioEncoder.AMR_NB;
III.setVideoEncoder():设置视频的编码类型,指定默认设置,或者是MediaRecorder.VideoEncoder.MPEG_4_SP;
5. setOutputFile():设置输出文件,可以使用下文“保存媒体文件”中的示例代码中的getOutputMediaFile(MEDIA_TYPE_VIDEO).toString()方法来获取输出文件路径。
6. setPreviewDisplay():给应用程序指定SurfaceView的预览布局。要使用与连接预览相同的对象。
警告:这步中必须要调用MediaRecorder的配置方法,否则你的应用程序将会发生错误,并且录像也会失败。
c. 准备MediaRecorder对象:通过调用MediaRecorder.prepare()方法,准备给MediaRecorder对象提供的配置设置。
d. 启动MediaRecorder对象:通过调用MediaRecorder.star()方法来记录视频。
5. 停止视频录像:在这步中要调用以下方法来成功完成视频记录:
a. 停止MediaRecorder对象:通过调用MediaRecorder.stop()方法来停止视频采集
b. 重置MediaRecorder对象:可选操作,通过调用MediaRecorder.reset()方法来删除记录器的配置设置。
c. 释放MediaRecorder对象:调用MediaRecorder.release()方法来释放MediaRecorder对象。
d. 锁定Camera对象:调用Camera.lock()方法来锁定Camera对象,以便MediaRecorder会话能够继续使用它。从Android4.0(API Level 14)开始,这个调用不再需要了,除非MediaRecorder.prepare()方法调用失败。
6. 停止预览:当Activity使用完Camera对象时,要使用Camera.stopPreview()方法来停止预览。
7. 释放Camera对象:调用Camera.release()方法来释放Camera对象,以便其他应用程序能够使用它。
注意:使用MediaRecorder对象,不首先创建Camera预览,并跳过这个过程开始的几步是可能的。但是,因为典型的在开始视频采集之前,要给用户看到图像预览,所以跳过的步骤It is possible to use MediaRecorder without creating a camera preview first and skip the first few steps of this process.在此就不讨论了。
提示:如果你的应用程序被用于典型的视频记录,那么在启动预览期间,把setRecordingHint(boolean)方法设置为true,这样有助于减少启动采集所需要的时间。
配置MediaRecorder对象
在使用MediaRecorder类来采集视频时,必须按照指定的顺利来执行配置处理,并且要调用MediaRecorder.prepare()方法来检查和实现配置。下面的示例代码演示了如何为采集视频配置和准备MediaRecorder类:
private boolean prepareVideoRecorder(){
mCamera = getCameraInstance();
mMediaRecorder = new MediaRecorder();
// Step 1: Unlock and set camera to MediaRecorder
mCamera.unlock();
mMediaRecorder.setCamera(mCamera);
// Step 2: Set sources
mMediaRecorder.setAudioSource(MediaRecorder.AudioSource.CAMCORDER);
mMediaRecorder.setVideoSource(MediaRecorder.VideoSource.CAMERA);
// Step 3: Set a CamcorderProfile (requires API Level 8 or higher)
mMediaRecorder.setProfile(CamcorderProfile.get(CamcorderProfile.QUALITY_HIGH));
// Step 4: Set output file
mMediaRecorder.setOutputFile(getOutputMediaFile(MEDIA_TYPE_VIDEO).toString());
// Step 5: Set the preview output
mMediaRecorder.setPreviewDisplay(mPreview.getHolder().getSurface());
// Step 6: Prepare configured MediaRecorder
try {
mMediaRecorder.prepare();
} catch (IllegalStateException e) {
Log.d(TAG, "IllegalStateException preparing MediaRecorder: " + e.getMessage());
releaseMediaRecorder();
return false;
} catch (IOException e) {
Log.d(TAG, "IOException preparing MediaRecorder: " + e.getMessage());
releaseMediaRecorder();
return false;
}
return true;
}
在Android2.2(API Level8)之前,必须要直接设置输出格式和编码格式参数,而不是使用CamcorderProfile类。下面的代码演示了这种方法:
// Step 3: Set output format and encoding (for versions prior to API Level 8)
mMediaRecorder.setOutputFormat(MediaRecorder.OutputFormat.MPEG_4);
mMediaRecorder.setAudioEncoder(MediaRecorder.AudioEncoder.DEFAULT);
mMediaRecorder.setVideoEncoder(MediaRecorder.VideoEncoder.DEFAULT);
以下是给MediaRecorder对象设置的默认的视频采集参数,但是你可以在你的应用程序中来调整这些设置:
1. setVideoEncodingBitRate()
2. setVideoSize()
3. setVideoFrameRate()
4. setAudioEncodingBitRate()
5. setAudioChannels()
6. setAudioSamplingRate()
启动和停止MediaRecorder对象
在使用MediaRecorder类来启动和停止视频采集时,必须按照以下顺序来执行:
1. 用Camera.unlock()方法来解锁Camera对象;
2. 向上面代码中显示的那样来配置MediaRecorder;
3. 使用MediaRecorder.start()方法来启动采集;
4. 记录视频;
5. 使用MediaRecorder.stop()方法来停止采集;
6. 使用MediaRecorder.release()方法来释放媒体记录器;
7. 使用Camera.lock()方法来锁定Camera对象。
以下示例代码演示了如何触发一个按钮正确的使用Camera和MediaRecorder类来启动和停止视频采集。
注意:当完成视频采集时,不要释放Camera,否则你的预览将会被停止。
private boolean isRecording = false;
// Add a listener to the Capture button
Button captureButton = (Button) findViewById(id.button_capture);
captureButton.setOnClickListener(
new View.OnClickListener() {
@Override
public void onClick(View v) {
if (isRecording) {
// stop recording and release camera
mMediaRecorder.stop(); // stop the recording
releaseMediaRecorder(); // release the MediaRecorder object
mCamera.lock(); // take camera access back from MediaRecorder
// inform the user that recording has stopped
setCaptureButtonText("Capture");
isRecording = false;
} else {
// initialize video camera
if (prepareVideoRecorder()) {
// Camera is available and unlocked, MediaRecorder is prepared,
// now you can start recording
mMediaRecorder.start();
// inform the user that recording has started
setCaptureButtonText("Stop");
isRecording = true;
} else {
// prepare didn't work, release the camera
releaseMediaRecorder();
// inform user
}
}
}
}
);
注意:在上面的例子中,prepareVideoRecorder()方法引用了“配置MediaRecorder”一节中的示例代码。这个方法要锁定Camera,然后配置和准备MediaRecorder示例。
释放Camera
Camera是一种由应用程序共享的设备资源。在获得一个Camera实例之后,你的应用程序才能够使用Camera,并且要特别小心,在应用程序停止使用它的时候,即使是是应用程序被挂起(Activity.onPause()),一定要释放Camera对象。如果应用程序没有正确的释放Camera,所有后续的访问Camera的尝试,包括你自己的应用程序,都会因访问失败而导致应用程序被关闭。
像下面的示例代码那样,使用Camera.release()方法来释放Camera对象:
public class CameraActivity extends Activity {
private Camera mCamera;
private SurfaceView mPreview;
private MediaRecorder mMediaRecorder;
...
@Override
protected void onPause() {
super.onPause();
releaseMediaRecorder(); // if you are using MediaRecorder, release it first
releaseCamera(); // release the camera immediately on pause event
}
private void releaseMediaRecorder(){
if (mMediaRecorder != null) {
mMediaRecorder.reset(); // clear recorder configuration
mMediaRecorder.release(); // release the recorder object
mMediaRecorder = null;
mCamera.lock(); // lock camera for later use
}
}
private void releaseCamera(){
if (mCamera != null){
mCamera.release(); // release the camera for other applications
mCamera = null;
}
}
Android Camera
最新推荐文章于 2024-03-18 13:11:08 发布