openharmony/distributedhardware_distributed_input
1
0
Fork 0
mirror of https://github.com/openharmony/distributedhardware_distributed_input.git synced 2026-07-23 23:06:09 -04:00
Code Issues Packages Projects Releases Wiki Activity

修改readme

Browse Source 
Signed-off-by: joe49 <liqiao49@huawei.com>
This commit is contained in:
joe49
2023-04-04 11:29:11 +08:00
parent c6b8e25511
commit 8fb144cdac
1 changed files with 39 additions and 44 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README_zh.md
+39 -44
View File
@@ -2,19 +2,19 @@
## **简介**
分布式输入部件提供了跨设备的键鼠外设输入能力，使一台设备可以使用另一台设备的输入外设（如鼠标，键盘，触摸板等）作为本设备的外设使用，在另一台设备上的操作作用于本设备。
分布式输入部件提供了跨设备的键鼠外设输入能力，使一台设备可以使用另一台设备的输入外设（如鼠标，键盘，触摸板等）作为本设备的外设使用，在另一台设备上的操作作用于本设备。分布式输入不提供北向接口，由多模输入子系统提供接口供开发者调用分布式输入的能力。
其系统架构图如下图所示：
![distributedinput_arch](figures/distributedinput_arch.png)
## **概念说明**
### **概念说明**
**主控端(source)**：控制端设备，通过分布式输入向被控端设备发送命令，使用周边被控端设备键鼠输入能力的设备。
**被控端(sink)**：被控制端设备，接受主控端发送的命令并且完成对应操作，提供本地键鼠外设供主控端设备使用的设备。
## **架构说明**
### **架构实现**
其系统架构图如下所示：
![distributedinput_arch](figures/distributedinput_arch.png)
**分布式输入主控端(DInputSource)**：使用周边被控端设备键鼠输入能力的设备，称为分布式输入主控端，周边被控端设备键鼠事件可以在主控端生效。
@@ -40,6 +40,38 @@
**虚拟键鼠驱动(Virtual KeyBoard/Mouse)**：被控端键鼠信息通过分布式硬件管理框架同步信息到主控端后，主控端分布式硬件管理框架调用分布式输入驱动管理功能，在主控端为对应的被控端键鼠创建的虚拟键鼠驱动节点，和被控端键鼠节点对应。
### **流程说明**
#### **1. 分布式输入初始化**
分布式硬件管理框架启动后，查询本机分布式输入的部件配置，如果发现有相关配置，通过配置加载分布式输入实现的部件接入so，进行本地输入外设的信息查询，以及分布式输入source侧和sink侧的初始化；分布式硬件管理框架将查询到的本地外设信息记录到分布式数据库，在可信设备之间同步。
#### **2. 分布式输入驱动的准备**
分布式硬件管理框架监听数据库数据变化，如果从分布式数据获取到上线的被控端设备同步的输入外设信息，会调用分布式输入主控端注册分布式输入驱动接口，为对端设备外设在本地注册对应的分布式外设，作为对端设备外设的代理；本地新注册的分布式输入外设，会被多模输入管理起来，并供外部应用调用。
#### **3. 使用分布式输入能力**
(1) 应用可以通过调用多模输入的能力查询接口，查询到对端可信设备具有的分布式输入能力。
(2) 应用可以通过调用多模输入的键鼠穿越开关接口，打开键鼠穿越的功能开关。
(3) 应用可以通过调用多模输入的键鼠穿越接口，启动键鼠外设的跨设备输入能力：
- 设备间首次进行键鼠穿越时，分布式输入部件会启动相关的资源准备，包括设备间网络连接的建立以及相关资源线程的启动等；
- 键鼠穿越成功后，分布式输入部件会通知主控端设备开始使用被控端设备的输入外设，此时被控端设备的分布式输入服务采集到输入外设原始事件并回传到主控端，主控端分布式输入接收到事件并注入到对应的分布式输入驱动，多模输入模块获取到注入的被控端外设事件，进行事件处理后在本地生效，从而实现了主控端对被控端输入外设的使用。
(4) 如果键鼠不再需要穿越，应用可以通过调用多模输入的停止穿越接口，通知被控端分布式输入服务不再回传被控端的外设事件，被控端外设事件在被控端本地生效。
(5) 如果业务方停止使用键鼠穿越，应用可以通过调用多模输入的接口关闭键鼠穿越开关，停止使用键鼠穿越能力。
备注：关于多模输入分布式输入相关接口的使用，参见多模输入相关文档。
#### **4. 设备下线**
设备下线后，分布式硬件管理框架去使能下线设备的输入外设，移除分布式输入驱动，此时下线设备的分布式输入外设不可用。
## **目录**
```
@@ -76,43 +108,6 @@
**操作系统限制**：OpenHarmony标准操作系统。
## **接口说明**
分布式输入不提供北向接口，由多模输入子系统提供接口供开发者调用分布式输入的能力。
## **流程说明**
#### **1. 分布式输入初始化**
分布式硬件管理框架启动后，查询本机分布式输入的部件配置，如果发现有相关配置，通过配置加载分布式输入实现的部件接入so，进行本地输入外设的信息查询，以及分布式输入source侧和sink侧的初始化；分布式硬件管理框架将查询到的本地外设信息记录到分布式数据库，在可信设备之间同步。
#### **2. 分布式输入驱动的准备**
分布式硬件管理框架监听数据库数据变化，如果从分布式数据获取到上线的被控端设备同步的输入外设信息，会调用分布式输入主控端注册分布式输入驱动接口，为对端设备外设在本地注册对应的分布式外设，作为对端设备外设的代理；本地新注册的分布式输入外设，会被多模输入管理起来，并供外部应用调用。
#### **3. 使用分布式输入能力**
(1) 应用可以通过调用多模输入的能力查询接口，查询到对端可信设备具有的分布式输入能力。
(2) 应用可以通过调用多模输入的键鼠穿越开关接口，打开键鼠穿越的功能开关。
(3) 应用可以通过调用多模输入的键鼠穿越接口，启动键鼠外设的跨设备输入能力：
- 设备间首次进行键鼠穿越时，分布式输入部件会启动相关的资源准备，包括设备间网络连接的建立以及相关资源线程的启动等；
- 键鼠穿越成功后，分布式输入部件会通知主控端设备开始使用被控端设备的输入外设，此时被控端设备的分布式输入服务采集到输入外设原始事件并回传到主控端，主控端分布式输入接收到事件并注入到对应的分布式输入驱动，多模输入模块获取到注入的被控端外设事件，进行事件处理后在本地生效，从而实现了主控端对被控端输入外设的使用。
(4) 如果键鼠不再需要穿越，应用可以通过调用多模输入的停止穿越接口，通知被控端分布式输入服务不再回传被控端的外设事件，被控端外设事件在被控端本地生效。
(5) 如果业务方停止使用键鼠穿越，应用可以通过调用多模输入的接口关闭键鼠穿越开关，停止使用键鼠穿越能力。
备注：关于多模输入分布式输入相关接口的使用，参见多模输入相关文档。
#### **4. 设备下线**
设备下线后，分布式硬件管理框架去使能下线设备的输入外设，移除分布式输入驱动，此时下线设备的分布式输入外设不可用。
## **相关仓**
****