1# **分布式相机组件** 2 3## **简介** 4 5分布式相机是多个设备的相机同时协同使用的能力。分布式相机组件是为分布式硬件子系统提供这一能力的组件。本组件不直接对接应用，只向分布式硬件框架子系统提供C++接口。应用可以通过相机框架的接口使用分布式相机组件操作其他设备的Camera，使用方式与本地相机一致。 6 7其系统架构图如下图所示： 8 9 10 11**分布式相机接口(DistributedCameraSDK)**：为分布式硬件管理框架提供超级终端虚拟Camera使能/去使能能力，以及相机状态。 12 13**分布式相机主控端生命周期管理(DistributedCameraSourceMgr)**：通过状态机管理主控端Camera状态，负责主控端相关对象的创建销毁，以及两端的参数协商。 14 15**分布式相机被控端生命周期管理(DistributedCameraSinkMgr)**：管理被控端Camera状态，负责被控端相关对象的创建销毁，以及两端的参数协商。 16 17**通道模块(Channel)**：通过软总线连接主控端与被控端，接收发送主控端的相机指令或被控端的图像信息。 18 19**数据处理器(DataProcess)**：对相机框架返回的图像数据做处理（编解码、色彩空间转换、分辨率缩放、帧率调整，角度调整等）。 20 21**分布式相机客户端(CameraClient)**：被控端调用多媒体接口查询操作本地相机（查询相机数量及相关信息；打开、关闭、获取流等操作）。 22 23**虚拟相机HDF层实现(VirtualCameraHdf)**：在HDF层建立的虚拟Camera硬件，能够被多媒体框架发现和加载，像使用本地的Camera一样被使用 24 25## **目录** 26 27``` 28/foundation/distributedhardware/distributedcamera 29├── camera_hdf # 分布式相机HAL功能 30├── common # 分布式相机公共模块 31├── interfaces # 分布式相机对外接口模块 32├── sa_profile # 分布式相机SA配置模块 33├── services # 服务模块 34│ └── cameraservice # 相机服务模块 35│ ├── base # 分布式相机两端公共部分 36│ ├── cameraoperator # 分布式相机相机操作模块 37│ ├── sinkservice # 分布式相机被控端服务模块 38│ └── sourceservice # 分布式相机主控端服务模块 39│ ├── channel # 分布式相机通道模块 40│ └── data_process # 分布式相机数据处理模块 41``` 42 43## **约束** 44**语言限制**：C++语言。 45**组网环境**：必须确保设备在同一个局域网中。 46**操作系统限制**：OpenHarmony操作系统。 47 48## **说明** 49### **概念说明** 50#### 主控端（source）：控制端，通过调用分布式相机能力，使用被控端的摄像头进行预览、拍照、录像等功能。 51#### 被控端（sink）：被控制端，通过分布式相机接收主控端的命令，使用本地摄像头为主控端提供图像数据。 52#### Metadata：又叫元数据，是用于控制相机各种属性的参数。 53 54### **接口说明** 55分布式相机组件实现分布式硬件管理框架提供的接口，分布式硬件管理框架统一调用接口实现虚拟硬件驱动注册等功能。 56 57### **场景说明** 58被控端设备上线之后，主控端可以使能该设备相机并像使用本地相机一样使用被控端相机，直到被控端设备下线。 59 60### **流程说明** 61#### **1. 设备开机启动** 62系统拉起分布式相机的SA服务，Source侧被初始化，相关模块被初始化。 63 64#### **2. 设备组网上线** 65设备上线后，分布式硬件管理框架同步到上线设备的相机硬件信息并使能，使能成功后在系统中会新增分布式相机驱动并通知到相机框架，相机框架统一管理本地相机和分布式相机驱动；上层应用通过相机框架接口可以查询到分布式相机，并按照和本地相机相同的接口使用分布式相机。 66 67#### **3. 设备下线** 68设备下线后，分布式硬件管理框架去使能下线设备的相机硬件，本地移除分布式相机驱动并通知到相机框架，此时下线设备的分布式相机不可用。 69 70## **涉及仓** 71**** 72**分布式硬件子系统：** 73 74设备管理 75[device_manager](https://gitee.com/openharmony/device_manager) 76 77分步式硬件管理框架 78[distributed_hardware_fwk](https://gitee.com/openharmony/distributed_hardware_fwk) 79 80**分布式相机 81[distributed_camera](https://gitee.com/openharmony/distributed_camera)** 82 83分布式屏幕 84[distributed_screen](https://gitee.com/openharmony/distributed_screen)
