学步园

public class

Camera

extends
Object

    本类主要用于和 camera service 建立及断开连接、设置拍照功能 、开启及关闭 预览 、拍照、检索 frames 编码成 video 。本类没有默认的构造函数，你可以通过 open() 函数获得一个 Camera 对象。

       首先要使用硬件 camera ，必须要在 manifest 文件中声明使用权限，例如应用中要使用 camera 及自动对焦功能，那么 manifest 文件中包含下列几行声明：

<uses-permission android:name="android.permission.CAMERA" />
<uses-feature android:name="android.hardware.camera" />
<uses-feature android:name="android.hardware.camera.autofocus" />

   通过该类实现照相功能，一般需要下列几个步骤
:

1 通过函数open(int)获得一个camera
对象

2 通过函数getParameters()得到一个已有的(
默认的 )
设置

3 如果有需要，可以通过函数setParameters(Camera.Parameters)，修改第二步返回的Camera.Parameters对象.

4 通过函数setDisplayOrientation(int)来设置屏幕的水平或垂直

5 重要：传递一个已经初始化好了的SurfaceHolder
对象给函数setPreviewDisplay(SurfaceHolder)，如果没有
surface，
carema 是无法打开预览功能。

6 重要:
调用函数 startPreview()
更新预览的 surface
，开始照相之前必须开启预览功能

7 通过函数l
takePicture(Camera.ShutterCallback,
Camera.PictureCallback, Camera.PictureCallback, Camera.PictureCallback)实现照相功能.
在回调函数中可以得到实际的相片数据.

8         每完成一次照相，预览功能会停止。如果要照更多像，需要再次调用startPreview().

9 调用stopPreview() 停止预览
.

10 重要:
调用release()以便其他应用可以方便使用camera.
使用 camera
的应用程序应该在 onPause()(并且在
onResume()中重新re-
open()),立即释放
camera.

 

按照以下步骤快速切换
video recording 模式
:

1         如上所述得到一个初始化的Camera
，并开启预览功能.

2         调用unlock()使得media
进程可以访问camera.

3         将camera
传递给函数setCamera(Camera).查看关于
video recording的
MediaRecorder信息
.

4         完成了recording
，调用reconnect()来re-acquire
and re-lock the camera.

5         如果有需要，可以重新开启预览，照更多的相、录更多视频.

6         最后如上所述调用函数stopPreview()andrelease()来停止预览.

     这个类不是线程安全的，这意味着是通过event thread使用该类。在绝大多数需要长时间运行的操作(预览、聚焦、照相等)都是非同步的，只要有需求就会立刻唤醒相关回调函数。而这些回调函数是由调用 open(int)的event thread来调用的。故这些类方法一定不能同时在多个线程中运行。

      注意：不同性能的android设备有不同的硬件规格，如兆像素等级和自动对焦性能，为了使你的应用和更多设备兼容，最好不要限制camera规格。

 

P ublic Methods
public final void addCallbackBuffer (byte[] callbackBuffer)
Since: API Level 8
     给callback buffer queue添加一个已分配好内存的buffer。应用程序可以添加一个或多个buffers到该队列中. 当一个preview frame产生并且该队列还有至少一个可用的buffer，那么该buffer将被移除队列使用。这时会唤醒preview callback。如果preview frame产生但是该队列中没有可用的buffer，那么这个frame就会被丢弃。应用程序应该在处理完buffer中数据后，再将buffer重新添加进队列。
     Buffer的大小是由该preview image的宽，高，及每个像素的bytes三者的乘积来决定的. 通过函数getPreviewSize()来得到该preview image的 width and height.通过函数getBitsPerPixel(int) / 8可以得到每个像素包含的 Bytes ,通过函数getPreviewFormat() 可以得到该image采用的格式.
     只有通过函数setPreviewCallbackWithBuffer(PreviewCallback)设置预览回调的时候，才会用到本函数。当通过函数setPreviewCallback(PreviewCallback) 或setOneShotPreviewCallback(PreviewCallback)设置预览回调时,所需的buffer由系统自动分配。
Parameters
callbackBuffer，添加到队列中的buffer。该buffer的大小应该是width * height * bits_per_pixel / 8.

 

public final voidautoFocus
(Camera.AutoFocusCallbackcb)

Since:
API Level 1

打开
camera 的自动对焦功能并且注册一个当
camera 对焦时的回调函数。这个函数只在
preview 激活的时候有效
( 即在 startPreview()and
before stopPreview()之间。

调用者应该通过函数
getFocusMode() 来查看是否可以使用
autoFocus()函数，如果
camera并不支持
auto-focus,那么该函数不做任何处理，立即调用
onAutoFocus(Boolean ,Camera)函数。如果你的应用不能安装在没有自动对焦的设备上，你需要在你的应用程序中通过
<uses-feature>manifest 元素声明需要使用自动对焦功能。

如果当前的
flash mode 不是
FLASH_MODE_OFF ，
flash 将在自动对焦过程中启动，具体依赖于驱动及
camera 硬件。

public final voidcancelAutoFocus
()

Since:
API Level 5

取消任何当前正在运行的
auto-focus. 该方法将
focus position 重置为默认的值。如果
camera 不支持
auto-focus ，该方法不做任何操作。

See Also

autoFocus(Camera.AutoFocusCallback)

public static voidgetCameraInfo
(int cameraId,Camera.CameraInfocameraInfo)

Since:
API Level 9

返回某一特定
camera 的信息

如果
getNumberOfCameras()返回N
，有效 id
从 0到
N-1 。

public static intgetNumberOfCameras
()

Since:
API Level 9

返回本设备上的所有可用的物理
camera 个数

publicCamera.ParametersgetParameters()

Since:
API Level 1

返回当前
Camera service 的设置，如果要修改参数，必须将返回的
Parameters 对象传递给函数
setParameters(Camera.Parameters)实现.

See Also

setParameters(Camera.Parameters)

public final voidlock
()

Since:
API Level 5

Re-locks the camera to prevent other processes from accessing it. Camera objects are locked by default unlessunlock()is
called. Normally reconnect()is
used instead.

If you are not recording video, you probably do not need this method.

给 camera 加锁以防止其他进程的访问，默认情况下 camera 是被锁的，除非调用 unlock() 函数解锁。通常可以通过函数reconnect()代替。如果你不需要
recording viedo 功能，你不需要使用该方法。

Throws

RuntimeException

if the camera cannot be re-locked (for example, if the camera is still in use by another process).

public staticCameraopen(int
cameraId)

Since:
API Level 9

创建一个新的
camera 对象以使用
camera 硬件

当你使用了
camera 后，一定要调用
release(), 否则
camera 将被一直锁住，无法被其他应用程序使用。

应用程序同时只能存在一个激活的
camera

其他方法的
callback 函数会传递给调用
open() 函数的线程的
event loop 。如果该线程没有
event loop ，那么回调函数就会被传递给
main application event loop ，如果没有
main application event loop ，
callback 函数不会传递

Parameters

cameraId

the hardware camera to access, between 0 andgetNumberOfCameras()-1.

Returns

返回一个
connected locked 并
ready for use 的
Camera objecte.

Throws

RuntimeException

if connection to the camera service fails (for example, if the camera is in use by another process).

public staticCameraopen()

Since:
API Level 1

创建一个新的访问设备上第一个 back-facing camera 的 Camera 类对象，如果设备没有 back-facing camera ，则该函数返回 null 。

See Also

open(int)

public final voidreconnect
()

Since:
API Level 8

在另一个进程使用之后，重新与
camera 建立连接。进程
unlock() 之后，该进程可能仍在使用
camera( 这里理解不知是否恰当
) ，当其使用完毕后，你一定要与
camera 重新建立连接，这样可重新获得锁以继续使用
camera 。

如果调用了
setCamera(Camera) ，该接口一定要在
MediaRecorder 之后调用。

当然如果你不需要使用
recording video ，你不用使用该函数

 

Throws

IOException

if a connection cannot be re-established (for example, if the camera is still in use by another process).

public final voidrelease
()

Since:
API Level 1

断开和释放
Camera 对象资源，当使用完了
camera ，你要尽快调用该函数。

public final voidsetDisplayOrientation
(int degrees)

Since:
API Level 8

设置
preview 的顺时针旋转角度。这将影响
preview frames 和拍照之后的相片显示。该方法主要用于垂直模式的应用。注意在旋转之前，front-facing cameras
的
preview 显示是水平
flip 的，这就是说，
image 是沿着
camera sensor 的垂直中心轴来反射的
（无法理解其意思）。所以用户可以像照镜子一样看到他们自己。这不会影响传入函数onPreviewFrame(byte[],
Camera)的、
JPEG 相片的、或记录的
video 的 byte array的顺序。在
preview期间是不允许调用该方法的。如果你想要是你的照片和显示出来的角度一致，你可以参考下列代码：

 

Parameters

degrees

the angle that the picture will be rotated clockwise. Valid values are 0, 90, 180, and 270. The starting position is 0 (landscape).

See Also

·     setPreviewDisplay(SurfaceHolder)

public final voidsetErrorCallback
(Camera.ErrorCallbackcb)

Since:
API Level 1

Registers a callback to be invoked when an error occurs.

Parameters

cb	The callback to run

public final voidsetOneShotPreviewCallback
(Camera.PreviewCallback cb)

Since:
API Level 3

Installs a callback to be invoked for the next preview frame in addition to displaying it on the screen.一次调用后，该回调函数就会被清除，该函数可在任何时候调用，即使是正在预览，调用该函数将覆盖以前的回调。

Parameters

cb	a callback object that receives a copy of the next preview frame, or null to stop receiving callbacks.

public voidsetParameters
(Camera.Parameters params)

Since:
API Level 1

Changes the settings for this Camera service.

Parameters

params

the Parameters to use for this Camera service

Throws

RuntimeException

if any parameter is invalid or not supported.

See Also

·     getParameters()

public final voidsetPreviewCallback
(Camera.PreviewCallback cb)

Since:
API Level 1

该函数为每个
preview frame 安装一个
callback ，并将每个
preview frame 显示到屏幕上，只要
preview 处在激活状态，这些回调函数就会被重复调用
. 该方法可以在任何时候调用，即使
preview is live. 调用该函数将覆盖一起设置的其他的回调
.

Parameters

cb	a callback object that receives a copy of each preview frame, or null to stop receiving callbacks.

public final voidsetPreviewCallbackWithBuffer
(Camera.PreviewCallback cb)

Since:
API Level 8

安装一个会被每个
preview frame 激活的回调函数，这些回调函数使用由
addCallbackBuffer(byte[])提供的
buffer，并将每个
preview frame显示到屏幕上。只要
preview是激活的
buffer是足够的，这些回调就会不断重复被调用
, 并覆盖其他的回调。

该方法目的是要通过复用
preview frame memory 来提高
preview 的性能和帧率。在调用该方法前后或没有回调注册时，需要调用函数
addCallbackBuffer(byte[]).
如果传一个空的callback
给该函数，那么buffer queue
将被清除.
将调用 setPreviewCallback(Camera.PreviewCallback)或
setOneShotPreviewCallback(Camera.PreviewCallback).

Parameters

cb	获得了 preview frame 数据拷贝的回调对象，如果 cb 为空，该函数将停止接受 callbacks 并清空 buffer queue.

See Also

·     addCallbackBuffer(byte[])

public final voidsetPreviewDisplay
(SurfaceHolder holder)

Since:
API Level 1

为
live preview 设置
surface ，对于
preview ， surface是必要
; 对于拍照
preview 是必要的。相同的
surface 可以被无损重置。

在调用该方法时
SurfaceHolder必须已经包含了一个
surface.如果使用
SurfaceView，必须通过函数
addCallback(SurfaceHolder.Callback)注册一个
SurfaceHolder.Callback并且在调用
setPreviewDisplay()或开启
preview.之前，等待
surfaceCreated(SurfaceHolder) 

在调用
startPreview()函数之前，必须调用该函数。不过有一个例外，那就是如果调用
startPreview() 之前，没有设置
preview surface 或者设为
null ，该函数可能被传入一个非空
parameter ，调用一次已设置的
preview surface (
这就是得camera
的启动和 surface 的创建可以并行，节省了时间
) ，在
preview运行的时候，这个
preview surface不可更改。
.

Parameters

holder

包含放置 preview 的 surface，可能为空以移除原来的 preview surface

Throws

IOException

if the method fails (for example, if the surface is unavailable or unsuitable).

public final voidsetZoomChangeListener
(Camera.OnZoomChangeListener listener)

Since:
API Level 8

Registers a listener to be notified when the zoom value is updated by the camera driver during smooth zoom.

设置监听器监听
smooth zoom 期间，
camera 驱动对
zoom value 的值的更改

Parameters

listener

the listener to notify

See Also

·