一、简介
① 概念
- HarmonyOS 相机模块支持相机业务的开发,开发者可以通过已开放的接口实现相机硬件的访问、操作和新功能开发,最常见的操作如:预览、拍照、连拍和录像等。
- 相机静态能力:用于描述相机的固有能力的一系列参数,比如朝向、支持的分辨率等信息。
- 物理相机:物理相机就是独立的实体摄像头设备。物理相机ID是用于标志每个物理摄像头的唯一字串。
- 逻辑相机:逻辑相机是多个物理相机组合出来的抽象设备,逻辑相机通过同时控制多个物理相机设备来完成相机某些功能,如大光圈、变焦等功能。逻辑摄像机ID是一个唯一的字符串,标识多个物理摄像机的抽象能力。
- 帧捕获:相机启动后对帧的捕获动作统称为帧捕获。主要包含单帧捕获、多帧捕获、循环帧捕获。
- 单帧捕获:指的是相机启动后,在帧数据流中捕获一帧数据,常用于普通拍照。
- 多帧捕获:指的是相机启动后,在帧数据流中连续捕获多帧数据,常用于连拍。
- 循环帧捕获:指的是相机启动后,在帧数据流中一直捕获帧数据,常用于预览和录像。
② 使用限制
- 在同一时刻只能有一个相机应用在运行中。
- 相机模块内部有状态控制,开发者必须按照指导文档中的流程进行接口的顺序调用,否则可能会出现调用失败等问题。
- 为了开发的相机应用拥有更好的兼容性,在创建相机对象或者参数相关设置前请务必进行能力查询。
二、相机使用流程
- 相机模块主要工作是给相机应用开发者提供基本的相机 API 接口,用于使用相机系统的功能,进行相机硬件的访问、操作和新功能开发。
- 相机的开发流程如图所示:
三、相机 API
- 相机模块为相机应用开发者提供了3个包的内容,包括方法、枚举、以及常量/变量,方便开发者更容易地实现相机功能。
- 相机 API 如下所示:
包名 | 功能 |
---|
ohos.media.camera.CameraKit | 相机功能入口类。获取当前支持的相机列表及其静态能力信息,创建相机对象 |
ohos.media.camera.device | 相机设备操作类。提供相机能力查询、相机配置、相机帧捕获、相机状态回调等功能 |
ohos.media.camera.params | 相机参数类。提供相机属性、参数和操作结果的定义 |
四、相机权限申请
① 应用权限
- HarmonyOS 根据接口所涉数据的敏感程度或所涉能力的安全威胁影响,定义了不同开放范围与授权方式的权限来保护数据。
- 当前权限的开放范围分为:
-
-
-
-
- 应用在使用对应服务的能力或数据时,需要申请对应权限:
-
- 已在 config.json 文件中声明的非敏感权限,会在应用安装时自动授予,该类权限的授权方式为系统授权(system_grant)。
-
- 敏感权限需要应用动态申请,通过运行时发送弹窗的方式请求用户授权,该类权限的授权方式为用户授权(user_grant)。
- 当应用调用服务时,服务会对应用进行权限检查,如果没有对应权限则无法使用该服务。
- 敏感权限的申请需要按照动态申请流程向用户申请授权,敏感权限说明如下:
权限分类名称 | 权限名 | 说明 |
---|
位置 | ohos.permission.LOCATION | 允许应用在前台运行时获取位置信息。如果应用在后台运行时也要获取位置信息,则需要同时申请ohos.permission.LOCATION_IN_BACKGROUND权限 |
---|
ohos.permission.LOCATION_IN_BACKGROUND | 允许应用在后台运行时获取位置信息,需要同时申请ohos.permission.LOCATION权限 |
---|
相机 | ohos.permission.CAMERA | 允许应用使用相机拍摄照片和录制视频 |
---|
麦克风 | ohos.permission.MICROPHONE | 允许应用使用麦克风进行录音 |
---|
日历 | ohos.permission.READ_CALENDAR | 允许应用读取日历信息 |
---|
ohos.permission.WRITE_CALENDAR | 允许应用在设备上添加、移除或修改日历活动 |
---|
健身运动 | ohos.permission.ACTIVITY_MOTION | 允许应用读取用户当前的运动状态 |
---|
健康 | ohos.permission.READ_HEALTH_DATA | 允许应用读取用户的健康数据 |
---|
分布式数据管理 | ohos.permission.DISTRIBUTED_DATASYNC | 允许不同设备间的数据交换 |
---|
ohos.permission.DISTRIBUTED_DATA | 允许应用使用分布式数据的能力 |
---|
媒体 | ohos.permission.MEDIA_LOCATION | 允许应用访问用户媒体文件中的地理位置信息 |
---|
ohos.permission.READ_MEDIA | 允许应用读取用户外部存储中的媒体文件信息 |
---|
ohos.permission.WRITE_MEDIA | 允许应用读写用户外部存储中的媒体文件信息 |
---|
- 非敏感权限不涉及用户的敏感数据或危险操作,仅需在 config.json 中声明,应用安装后即被授权。
权限名 | 说明 |
---|
ohos.permission.GET_NETWORK_INFO | 允许应用获取数据网络信息 |
ohos.permission.GET_WIFI_INFO | 允许获取WLAN信息 |
ohos.permission.USE_BLUETOOTH | 允许应用查看蓝牙的配置 |
ohos.permission.DISCOVER_BLUETOOTH | 允许应用配置本地蓝牙,并允许其查找远端设备且与之配对连接 |
ohos.permission.SET_NETWORK_INFO | 允许应用控制数据网络 |
ohos.permission.SET_WIFI_INFO | 允许配置WLAN设备 |
ohos.permission.SPREAD_STATUS_BAR | 允许应用以缩略图方式呈现在状态栏 |
ohos.permission.INTERNET | 允许使用网络socket |
ohos.permission.MODIFY_AUDIO_SETTINGS | 允许应用程序修改音频设置 |
ohos.permission.RECEIVER_STARTUP_COMPLETED | 允许应用接收设备启动完成广播 |
ohos.permission.RUNNING_LOCK | 允许申请休眠运行锁,并执行相关操作 |
ohos.permission.ACCESS_BIOMETRIC | 允许应用使用生物识别能力进行身份认证 |
ohos.permission.RCV_NFC_TRANSACTION_EVENT | 允许应用接收卡模拟交易事件 |
ohos.permission.COMMONEVENT_STICKY | 允许发布粘性公共事件的权限 |
ohos.permission.SYSTEM_FLOAT_WINDOW | 提供显示悬浮窗的能力 |
ohos.permission.VIBRATE | 允许应用程序使用马达 |
ohos.permission.USE_TRUSTCIRCLE_MANAGER | 允许调用设备间认证能力 |
ohos.permission.USE_WHOLE_SCREEN | 允许通知携带一个全屏IntentAgent |
ohos.permission.SET_WALLPAPER | 允许设置静态壁纸 |
ohos.permission.SET_WALLPAPER_DIMENSION | 允许设置壁纸尺寸 |
ohos.permission.REARRANGE_MISSIONS | 允许调整任务栈 |
ohos.permission.CLEAN_BACKGROUND_PROCESSES | 允许根据包名清理相关后台进程 |
ohos.permission.KEEP_BACKGROUND_RUNNING | 允许Service Ability在后台继续运行 |
ohos.permission.GET_BUNDLE_INFO | 查询其他应用的信息 |
ohos.permission.ACCELEROMETER | 允许应用程序读取加速度传感器的数据 |
ohos.permission.GYROSCOPE | 允许应用程序读取陀螺仪传感器的数据 |
ohos.permission.MULTIMODAL_INTERACTIVE | 允许应用订阅语音或手势事件 |
ohos.permission.radio.ACCESS_FM_AM | 允许用户获取收音机相关服务 |
ohos.permission.NFC_TAG | 允许应用读写Tag卡片 |
ohos.permission.NFC_CARD_EMULATION | 允许应用实现卡模拟功能 |
ohos.permission.DISTRIBUTED_DEVICE_STATE_CHANGE | 允许获取分布式组网内设备的状态变化 |
ohos.permission.GET_DISTRIBUTED_DEVICE_INFO | 允许获取分布式组网内的设备列表和设备信息 |
- 受限开放的权限通常是不允许三方应用申请的。如果有特殊场景需要使用,请提供相关申请材料到应用市场申请相应权限证书。如果应用未申请相应的权限证书,却试图在 config.json 文件中声明此类权限,将会导致应用安装失败。另外,由于此类权限涉及到用户敏感数据或危险操作,当应用申请到权限证书后,还需按照动态申请权限的流程向用户申请授权。受限开放权限说明如下:
权限分类名称 | 典型场景 | 权限名 | 说明 |
---|
通讯录 | 社交、通讯、备份和恢复用户信息、电话拦截等 | ohos.permission.READ_CONTACTS | 允许应用读取联系人数据 |
通讯录 | 通讯、备份和恢复用户信息等 | ohos.permission.WRITE_CONTACTS | 允许应用添加、移除和更改联系人数据 |
② 相机权限
- 在使用相机之前,需要申请相机的相关权限,保证应用拥有相机硬件及其他功能权限。相机权限列表:
权限名称 | 权限属性值 | 是否必选 |
---|
相机权限 | ohos.permission.CAMERA | 必选 |
录音权限 | ohos.permission.MICROPHONE | 可选(需要录像时申请) |
存储权限 | ohos.permission.WRITE_MEDIA | 可选(需要保存图像及视频到设备的外部存储时申请) |
位置权限 | ohos.permission.MEDIA_LOCATION | 可选(需要保存图像及视频位置信息时申请) |
五、相机设备创建
- CameraKit 类是相机的入口 API 类,用于获取相机设备特性、打开相机,其接口如下表:
接口名 | 描述 |
---|
createCamera(String cameraId, CameraStateCallback callback, EventHandler handler) | 创建相机对象 |
getCameraAbility(String cameraId) | 获取指定逻辑相机或物理相机的静态能力 |
getCameraIds() | 获取当前逻辑相机列表 |
getCameraInfo(String cameraId) | 获取指定逻辑相机的信息 |
getInstance(Context context) | 获取CameraKit实例 |
registerCameraDeviceCallback(CameraDeviceCallback callback, EventHandler handler) | 注册相机使用状态回调 |
unregisterCameraDeviceCallback(CameraDeviceCallback callback) | 注销相机使用状态回调 |
- 在实现一个相机应用之前必须先创建一个独立的相机设备,然后才能继续相机的其他操作。相机设备创建的建议步骤如下:
-
- 通过 CameraKit.getInstance(Context context) 方法获取唯一的 CameraKit 对象(如果此步骤操作失败,相机可能被占用或无法使用,如果被占用,必须等到相机释放后才能重新获取 CameraKit 对象):
private void openCamera() {
// 获取CameraKit对象
CameraKit cameraKit = CameraKit.getInstance(context);
if (cameraKit == null) {
// 处理cameraKit获取失败的情况
}
}
- 通过 getCameraIds() 方法,获取当前使用的设备支持的逻辑相机列表。逻辑相机列表中存储了当前设备拥有的所有逻辑相机 ID,如果列表不为空,则列表中的每个 ID 都支持独立创建相机对象;否则,说明正在使用的设备无可用的相机,不能继续后续的操作:
try {
// 获取当前设备的逻辑相机列表
String[] cameraIds = cameraKit.getCameraIds();
if (cameraIds.length <= 0) {
HiLog.error(LABEL, "cameraIds size is 0");
}
} catch (IllegalStateException e) {
// 处理异常
}
- 还可以继续查询指定相机 ID 的静态信息:
-
- 调用 getDeviceLinkType(String physicalId) 方法获取物理相机连接方式;
-
- 调用 getCameraInfo(String cameraId) 方法查询相机硬件朝向等信息;
-
- 调用 getCameraAbility(String cameraId) 方法查询相机能力信息(比如支持的分辨率列表等)。
- CameraInfo 的主要接口:
接口名 | 描述 |
---|
getDeviceLinkType(String physicalId) | 获取物理相机连接方式 |
getFacingType() | 获取相机朝向信息 |
getLogicalId() | 获取逻辑相机ID |
getPhysicalIdList() | 获取对应的物理相机ID列表 |
接口名 | 描述 |
---|
getSupportedSizes(int format) | 根据格式查询输出图像的分辨率列表 |
getSupportedSizes(Class clazz) | 根据Class类型查询分辨率列表 |
getParameterRange(ParameterKey.Key parameter) | 获取指定参数能够设置的值范围 |
getPropertyValue(PropertyKey.Key property) | 获取指定属性对应的值 |
getSupportedAeMode() | 获取当前相机支持的自动曝光模式 |
getSupportedAfMode() | 获取当前相机支持的自动对焦模式 |
getSupportedFaceDetection() | 获取相机支持的人脸检测类型范围 |
getSupportedFlashMode() | 当前相机支持的闪光灯取值范围 |
getSupportedParameters() | 当前相机支持的参数设置 |
getSupportedProperties() | 获取当前相机的属性列表 |
getSupportedResults() | 获取当前相机支持的参数设置可返回的结果列表 |
getSupportedZoom() | 获取相机支持的变焦范围 |
- 通过 createCamera(String cameraId, CameraStateCallback callback, EventHandler handler) 方法,创建相机对象,此步骤执行成功意味着相机系统的硬件已经完成了上电:
-
- 第一个参数 cameraId 可以是上一步获取的逻辑相机列表中的任何一个相机 ID。
-
- 第二和第三个参数负责相机创建和相机运行时的数据和状态检测,请务必保证在整个相机运行周期内有效。
// 创建相机设备
cameraKit.createCamera(cameraIds[0], cameraStateCallback, eventHandler);
private final class CameraStateCallbackImpl extends CameraStateCallback {
@Override
public void onCreated(Camera camera) {
// 创建相机设备
}
@Override
public void onConfigured(Camera camera) {
// 配置相机设备
}
@Override
public void onPartialConfigured(Camera camera) {
// 当使用了addDeferredSurfaceSize配置了相机,会接到此回调
}
@Override
public void onReleased(Camera camera) {
// 释放相机设备
}
}
// 相机创建和相机运行时的回调
CameraStateCallbackImpl cameraStateCallback = new CameraStateCallbackImpl();
import ohos.eventhandler.EventHandler;
import ohos.eventhandler.EventRunner;
// 执行回调的EventHandler
EventHandler eventHandler = new EventHandler(EventRunner.create("CameraCb"));
- 至此,相机设备的创建已经完成。相机设备创建成功会在 CameraStateCallback 中触发 onCreated(Camera camera) 回调。在进入相机设备配置前,请确保相机设备已经创建成功。否则会触发相机设备创建失败的回调,并返回错误码,需要进行错误处理后,重新执行相机设备的创建。
六、相机设备配置
- 创建相机设备成功后,在 CameraStateCallback 中会触发 onCreated(Camera camera) 回调,并且带回 Camera 对象,用于执行相机设备的操作。
- 当一个新的相机设备成功创建后,首先需要对相机进行配置,调用 configure(CameraConfig) 方法实现配置。相机配置主要是设置预览、拍照、录像用到的 Surface(详见 ohos.agp.graphics.Surface),没有配置过 Surface,相应的功能不能使用。
- 为了进行相机帧捕获结果的数据和状态检测,还需要在相机配置时调用 setFrameStateCallback(FrameStateCallback, EventHandler) 方法设置帧回调。
private void initSurface() {
surfaceProvider = new SurfaceProvider(this);
DirectionalLayout.LayoutConfig params = new DirectionalLayout.LayoutConfig(
ComponentContainer.LayoutConfig.MATCH_PARENT, ComponentContainer.LayoutConfig.MATCH_PARENT);
surfaceProvider.setLayoutConfig(params);
surfaceProvider.pinToZTop(false);
surfaceProvider.getSurfaceOps().get().addCallback(new SurfaceCallBack());
((ComponentContainer)
findComponentById(ResourceTable.Id_surface_container)).addComponent(surfaceProvider);
}
private FrameStateCallback frameStateCallbackImpl = new FrameStateCallback(){
@Override
public void onFrameStarted(Camera camera, FrameConfig frameConfig, long frameNumber, long timestamp) {
...
}
@Override
public void onFrameProgressed(Camera camera, FrameConfig frameConfig, FrameResult frameResult) {
...
}
@Override
public void onFrameFinished(Camera camera, FrameConfig frameConfig, FrameResult frameResult) {
...
}
@Override
public void onFrameError(Camera camera, FrameConfig frameConfig, int errorCode, FrameResult frameResult) {
...
}
@Override
public void onCaptureTriggerStarted(Camera camera, int captureTriggerId, long firstFrameNumber) {
...
}
@Override
public void onCaptureTriggerFinished(Camera camera, int captureTriggerId, long lastFrameNumber) {
...
}
@Override
public void onCaptureTriggerInterrupted(Camera camera, int captureTriggerId) {
...
}
};
private final class CameraStateCallbackImpl extends CameraStateCallback {
@Override
public void onCreated(Camera camera) {
cameraDevice = camera;
previewSurface = surfaceProvider.getSurfaceOps().get().getSurface();
cameraConfigBuilder = camera.getCameraConfigBuilder();
if (cameraConfigBuilder == null) {
HiLog.error(LABEL, "onCreated cameraConfigBuilder is null");
return;
}
// 配置预览的Surface
cameraConfigBuilder.addSurface(previewSurface);
// 配置拍照的Surface
cameraConfigBuilder.addSurface(imageReceiver.getRecevingSurface());
// 配置帧结果的回调
cameraConfigBuilder.setFrameStateCallback(frameStateCallbackImpl, handler);
try {
// 相机设备配置
camera.configure(cameraConfigBuilder.build());
} catch (IllegalArgumentException e) {
HiLog.error(LABEL, "Argument Exception");
} catch (IllegalStateException e) {
HiLog.error(LABEL, "State Exception");
}
}
}
- 相机配置成功后,在 CameraStateCallback 中会触发 onConfigured(Camera camera) 回调,然后才可以执行相机帧捕获相关的操作。
- CameraConfig.Builder 的主要接口:
七、相机帧捕获
① API
- Camera 操作类,包括相机预览、录像、拍照等功能接口。Camera 的主要接口如下:
接口名 | 描述 |
---|
triggerSingleCapture(FrameConfig frameConfig) | 启动相机帧的单帧捕获 |
triggerMultiCapture(List frameConfigs) | 启动相机帧的多帧捕获 |
configure(CameraConfig config) | 配置相机 |
flushCaptures() | 停止并清除相机帧的捕获,包括循环帧/单帧/多帧捕获 |
getCameraConfigBuilder() | 获取相机配置构造器对象 |
getCameraId() | 获取当前相机的ID |
getFrameConfigBuilder(int type) | 获取指定类型的相机帧配置构造器对象 |
release() | 释放相机对象及资源 |
triggerLoopingCapture(FrameConfig frameConfig) | 启动或者更新相机帧的循环捕获 |
stopLoopingCapture() | 停止当前相机帧的循环捕获 |
② 启动预览(循环帧捕获)
- 用户一般都是先看见预览画面才执行拍照或者其他功能,所以对于一个普通的相机应用,预览是必不可少的。
- 启动预览的建议步骤如下:
-
- 通过 getFrameConfigBuilder(FRAME_CONFIG_PREVIEW) 方法获取预览配置模板,常用帧配置项见下表:
接口名 | 描述 | 是否必选 |
---|
addSurface(Surface surface) | 配置预览surface和帧的绑定 | 是 |
setAfMode(int afMode, Rect rect) | 配置对焦模式 | 否 |
setAeMode(int aeMode, Rect rect) | 配置曝光模式 | 否 |
setZoom(float value) | 配置变焦值 | 否 |
setFlashMode(int flashMode) | 配置闪光灯模式。 | 否 |
setFaceDetection(int type, boolean isEnable) | 配置人脸检测或者笑脸检测 | 否 |
setParameter(Key key, T value) | 配置其他属性(如自拍镜像等) | 否 |
setMark(Object mark) | 配置一个标签,后续可以从FrameConfig中通过Object getMark()拿到标签,判断两个是否相等,相等就说明是同一个配置 | 否 |
setCoordinateSurface(Surface surface) | 配置坐标系基准Surface,后续计算Ae/Af等区域都会基于此Surface为基本的中心坐标系,不设置默认使用添加的第一个Surface | 否 |
-
- 通过 triggerLoopingCapture(FrameConfig) 方法实现循环帧捕获(如预览/录像):
private final class CameraStateCallbackImpl extends CameraStateCallback {
@Override
public void onConfigured(Camera camera) {
// 获取预览配置模板
frameConfigBuilder = camera.getFrameConfigBuilder(FRAME_CONFIG_PREVIEW);
// 配置预览Surface
frameConfigBuilder.addSurface(previewSurface);
previewFrameConfig = frameConfigBuilder.build();
try {
// 启动循环帧捕获
int triggerId = camera.triggerLoopingCapture(previewFrameConfig);
} catch (IllegalArgumentException e) {
HiLog.error(LABEL, "Argument Exception");
} catch (IllegalStateException e) {
HiLog.error(LABEL, "State Exception");
}
}
}
- 经过以上的操作,相机应用已经可以正常进行实时预览了。在预览状态下,开发者还可以执行其他操作,比如:当预览帧配置更改时,可以通过 triggerLoopingCapture(FrameConfig) 方法实现预览帧配置的更新;
// 预览帧变焦值变更
frameConfigBuilder.setZoom(1.2f);
// 调用triggerLoopingCapture方法实现预览帧配置更新
triggerLoopingCapture(frameConfigBuilder.build());
- 通过 stopLoopingCapture() 方法停止循环帧捕获(停止预览):
// 停止预览帧捕获
camera.stopLoopingCapture()
③ 实现拍照(单帧捕获)
- 拍照功能属于相机应用的最重要功能之一,而且照片质量对用户至关重要。相机模块基于相机复杂的逻辑,从应用接口层到器件驱动层都已经默认的做好了最适合用户的配置,这些默认配置尽可能地保证用户拍出的每张照片的质量。
- 发起拍照的建议步骤如下:
-
- 通过 getFrameConfigBuilder(FRAME_CONFIG_PICTURE) 方法获取拍照配置模板,并且设置拍照帧配置,如下表:
接口名 | 描述 | 是否必选 |
---|
FrameConfig.Builder addSurface(Surface) | 实现拍照Surface和帧的绑定 | 必选 |
FrameConfig.Builder setImageRotation(int) | 设置图片旋转角度 | 可选 |
FrameConfig.Builder setLocation(Location) | 设置图片地理位置信息 | 可选 |
FrameConfig.Builder setParameter(Key, T) | 配置其他属性(如自拍镜像等) | 可选 |
// 图像帧数据接收处理对象
private ImageReceiver imageReceiver;
// 执行回调的EventHandler
private EventHandler eventHandler = new EventHandler(EventRunner.create("CameraCb"));
// 拍照支持分辨率
private Size pictureSize;
// 单帧捕获生成图像回调Listener
private final ImageReceiver.IImageArrivalListener imageArrivalListener = new ImageReceiver.IImageArrivalListener() {
@Override
public void onImageArrival(ImageReceiver imageReceiver) {
StringBuffer fileName = new StringBuffer("picture_");
fileName.append(UUID.randomUUID()).append(".jpg"); // 定义生成图片文件名
File myFile = new File(dirFile, fileName.toString()); // 创建图片文件
imageSaver = new ImageSaver(imageReceiver.readNextImage(), myFile); // 创建一个读写线程任务用于保存图片
eventHandler.postTask(imageSaver); // 执行读写线程任务生成图片
}
};
// 保存图片, 图片数据读写,及图像生成见run方法
class ImageSaver implements Runnable {
private final Image myImage;
private final File myFile;
ImageSaver(Image image, File file) {
myImage = image;
myFile = file;
}
@Override
public void run() {
Image.Component component = myImage.getComponent(ImageFormat.ComponentType.JPEG);
byte[] bytes = new byte[component.remaining()];
component.read(bytes);
FileOutputStream output = null;
try {
output = new FileOutputStream(myFile);
output.write(bytes); // 写图像数据
} catch (IOException e) {
HiLog.error(LABEL, "save picture occur exception!");
} finally {
if (output != null) {
try {
output.close(); // 关闭流
} catch (IOException e) {
HiLog.error(LABEL, "image release occur exception!");
}
}
myImage.release();
}
}
}
private void takePictureInit() {
List<Size> pictureSizes = cameraAbility.getSupportedSizes(ImageFormat.JPEG); // 获取拍照支持分辨率列表
pictureSize = getpictureSize(pictureSizes) // 根据拍照要求选择合适的分辨率
imageReceiver = ImageReceiver.create(Math.max(pictureSize.width, pictureSize.height),
Math.min(pictureSize.width, pictureSize.height), ImageFormat.JPEG, 5); // 创建ImageReceiver对象,注意create函数中宽度要大于高度;5为最大支持的图像数,请根据实际设置。
imageReceiver.setImageArrivalListener(imageArrivalListener);
}
-
- 通过 triggerSingleCapture(FrameConfig) 方法实现单帧捕获(如拍照):
private void capture() {
// 获取拍照配置模板
framePictureConfigBuilder = cameraDevice.getFrameConfigBuilder(FRAME_CONFIG_PICTURE);
// 配置拍照Surface
framePictureConfigBuilder.addSurface(imageReceiver.getRecevingSurface());
// 配置拍照其他参数
framePictureConfigBuilder.setImageRotation(90);
try {
// 启动单帧捕获(拍照)
cameraDevice.triggerSingleCapture(framePictureConfigBuilder.build());
} catch (IllegalArgumentException e) {
HiLog.error(LABEL, "Argument Exception");
} catch (IllegalStateException e) {
HiLog.error(LABEL, "State Exception");
}
}
- 为了捕获到质量更高和效果更好的图片,还可以在帧结果中实时监测自动对焦和自动曝光的状态,一般而言,在自动对焦完成,自动曝光收敛后的瞬间是发起单帧捕获的最佳时机。
④ 实现连拍(多帧捕获)
- 连拍功能方便用户一次拍照获取多张照片,用于捕捉精彩瞬间。
- 同普通拍照的实现流程一致,但连拍需要使用 triggerMultiCapture(List frameConfigs) 方法。
⑤ 启动录像(循环帧捕获)
- 启动录像和启动预览类似,但需要另外配置录像 Surface 才能使用。
- 录像前需要进行音视频模块的配置:
private Source source; // 音视频源
private AudioProperty.Builder audioPropertyBuilder; // 音频属性构造器
private VideoProperty.Builder videoPropertyBuilder; // 视频属性构造器
private StorageProperty.Builder storagePropertyBuilder; // 音视频存储属性构造器
private Recorder mediaRecorder; // 录像操作对象
private String recordName; // 音视频文件名
private void initMediaRecorder() {
videoPropertyBuilder.setRecorderBitRate(10000000); // 设置录制比特率
int rotation = DisplayManager.getInstance().getDefaultDisplay(this).get().getRotation();
videoPropertyBuilder.setRecorderDegrees(getOrientation(rotation)); // 设置录像方向
videoPropertyBuilder.setRecorderFps(30); // 设置录制采样率
videoPropertyBuilder.setRecorderHeight(Math.min(recordSize.height, recordSize.width)); // 设置录像支持的分辨率,需保证width > height
videoPropertyBuilder.setRecorderWidth(Math.max(recordSize.height, recordSize.width));
videoPropertyBuilder.setRecorderVideoEncoder(Recorder.VideoEncoder.H264); // 设置视频编码方式
videoPropertyBuilder.setRecorderRate(30); // 设置录制帧率
source.setRecorderAudiosource(Recorder.AudioSource.MIC); // 设置录制音频源
source.setRecorderVideoSource(Recorder.VideoSource.SURFACE); // 设置视频窗口
mediaRecorder.setSource(source); // 设置音视频源
mediaRecorder.setOutputFormat(Recorder.OutputFormat.MPEG_4); // 设置音视频输出格式
StringBuffer fileName = new StringBuffer("record_"); // 生成随机文件名
fileName.append(UUID.randomUUID()).append(".mp4");
recordName = fileName.toString();
File file = new File(dirFile, recordName); // 创建录像文件对象
storagePropertyBuilder.setRecorderFile(file); // 设置存储音视频文件名
mediaRecorder.setStorageProperty(storagePropertyBuilder.build());
audioPropertyBuilder.setRecorderAudioEncoder(Recorder.AudioEncoder.AAC); // 设置音频编码格式
mediaRecorder.setAudioProperty(audioPropertyBuilder.build()); // 设置音频属性
mediaRecorder.setVideoProperty(videoPropertyBuilder.build()); // 设置视频属性
mediaRecorder.prepare(); // 准备录制
HiLog.info(LABEL, "initMediaRecorder end");
}
private final class CameraStateCallbackImpl extends CameraStateCallback {
@Override
public void onConfigured(Camera camera) {
// 获取录像配置模板
frameConfigBuilder = camera.getFrameConfigBuilder(FRAME_CONFIG_RECORD);
// 配置预览Surface
frameConfigBuilder.addSurface(previewSurface);
// 配置录像的Surface
mRecorderSurface = mediaRecorder.getVideoSurface();
frameConfigBuilder.addSurface(mRecorderSurface);
previewFrameConfig = frameConfigBuilder.build();
try {
// 启动循环帧捕获
int triggerId = camera.triggerLoopingCapture(previewFrameConfig);
} catch (IllegalArgumentException e) {
HiLog.error(LABEL, "Argument Exception");
} catch (IllegalStateException e) {
HiLog.error(LABEL, "State Exception");
}
}
}
- 通过 camera.stopLoopingCapture() 方法停止循环帧捕获(录像)。
八、相机设备释放
- 使用完相机后,必须通过 release() 来关闭相机和释放资源,否则可能导致其他相机应用无法启动。一旦相机被释放,它所提供的操作就不能再被调用,否则会导致不可预期的结果,或是会引发状态异常。
- 相机设备释放的示例代码如下:
private void releaseCamera() {
if (camera != null) {
// 关闭相机和释放资源
camera.release();
camera = null;
}
// 拍照配置模板置空
framePictureConfigBuilder = null;
// 预览配置模板置空
previewFrameConfig = null;
}