鸿蒙应用开发之媒体(相机)

一、概述

HarmonyOS相机模块支持相机业务的开发，开发者可以通过已开放的接口实现相机硬件的访问、操作和新功能开发，最常见的操作如：预览、拍照、连拍和录像等。

1、基本概念

• 相机静态能力

  用于描述相机的固有能力的一系列参数，比如朝向、支持的分辨率等信息。

• 物理相机

  物理相机就是独立的实体摄像头设备。物理相机ID是用于标志每个物理摄像头的唯一字串。

• 逻辑相机

  逻辑相机是多个物理相机组合出来的抽象设备，逻辑相机通过同时控制多个物理相机设备来完成相机某些功能，如大光圈、变焦等功能。逻辑摄像机ID是一个唯一的字符串，标识多个物理摄像机的抽象能力。

• 帧捕获

  相机启动后对帧的捕获动作统称为帧捕获。主要包含单帧捕获、多帧捕获、循环帧捕获。

• 单帧捕获

  指的是相机启动后，在帧数据流中捕获一帧数据，常用于普通拍照。

• 多帧捕获

  指的是相机启动后，在帧数据流中连续捕获多帧数据，常用于连拍。

• 循环帧捕获

  指的是相机启动后，在帧数据流中一直捕获帧数据，常用于预览和录像。

2、约束与限制

• 在同一时刻只能有一个相机应用在运行中。
• 相机模块内部有状态控制，开发者必须按照指导文档中的流程进行接口的顺序调用，否则可能会出现调用失败等问题。
• 为了开发的相机应用拥有更好的兼容性，在创建相机对象或者参数相关设置前请务必进行能力查询。

3、开发流程

二、开发前的一些说明及必要步骤

1、三个重要接口

包名	功能
ohos.media.camera.CameraKit	相机功能入口类。获取当前支持的相机列表及其静态能力信息，创建相机对象。
ohos.media.camera.device	相机设备操作类。提供相机能力查询、相机配置、相机帧捕获、相机状态回调等功能。
ohos.media.camera.params	相机参数类。提供相机属性、参数和操作结果的定义。

2、权限申请

相机涉及到的权限有如下四个

权限名称	权限属性值	是否必选
相机权限	ohos.permission.CAMERA	必选
录音权限	ohos.permission.MICROPHONE	可选（需要录像时申请）
存储权限	ohos.permission.WRITE_USER_STORAGE	可选（需要保存图像及视频到设备的外部存储时申请）
位置权限	ohos.permission.LOCATION	可选（需要保存图像及视频位置信息时申请）

在配置文件中声明权限，这里图方便，我把以上四个权限都请求了，做Demo的时候就不用一个一个加了

"reqPermissions": [
  {
   
    "name": "ohos.permission.CAMERA",
    "name": "ohos.permission.MICROPHONE",
    "name": "ohos.permission.LOCATION",
    "name": "ohos.permission.WRITE_USER_STORAGE"
  }

在MainAbility的OnStart方法中对权限进行请求

public class MainAbility extends Ability {
   
    @Override
    public void onStart(Intent intent) {
   
        super.onStart(intent);
        super.setMainRoute(MainAbilitySlice.class.getName());
        String[] permissions = {
   "ohos.permission.CAMERA"
                , "ohos.permission.MICROPHONE"
                , "ohos.permission.LOCATION"
                , "ohos.permission.WRITE_USER_STORAGE"};
        requestPermissionsFromUser(permissions, 0);
    }
}

三、相机设备的创建

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)	注销相机使用状态回调。

基于HarmonyOS实现一个相机应用，无论将来想应用到哪个或者哪些设备上，都必须先创建一个独立的相机设备，然后才能继续相机的其他操作。

流程