鸿蒙OS开发文档 鸿蒙OS 相机概述

2024-02-25 开发教程 鸿蒙OS开发文档 匿名 2

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

基本概念

  • 相机静态能力

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

  • 物理相机

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

  • 逻辑相机

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

  • 帧捕获

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

  • 单帧捕获

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

  • 多帧捕获

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

  • 循环帧捕获

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

约束与限制

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