powermgr_powermgr_cangjie_wrapper/README_zh.md

电源服务仓颉封装（beta特性）

简介

电源服务仓颉封装为OpenHarmony应用开发者提供了电池状态和充放电状态查询的能力的仓颉 API。当前开放的电源服务仓颉接口仅支持standard设备。

图 1 电源管理仓颉架构图

如架构图所示：

接口层说明：

• 电池服务API：提供电池状态和充放电状态查询的仓颉公开接口声明。

框架层说明：

• 电池服务封装：提供电量信息查询、充电器类型、电池状态信息查询。该封装层是基于电源管理服务对电池服务功能进行的仓颉封装实现。

仓颉电源服务依赖部件引入说明：

• 电源管理服务：调用底层电源驱动，提供电源管理服务native基本功能实现。
• cangjie_ark_interop：封装C语言互操作公共接口，并提供仓颉标签类实现用于对仓颉API进行标注，以及提供抛向用户的BusinessException异常类定义。

目录

base/powermgr/powermgr_cangjie_wrapper
├── figures                           # 存放README中的架构图
├── ohos                              # 仓颉电源管理接口实现
│   └── battery_info                  # 电池服务仓颉接口代码目录
├── test                              # 测试用例代码
│   └── battery_info                  # 电池服务测试
└── bundle.json                       # 组件描述文件

使用说明

提供了以下电源服务功能：

• 电池服务：支持充放电状态和电池状态信息显示

电源服务相关使用示例请参见电池信息开发指导。

约束

与ArkTS提供的API能力相比，暂不支持以下功能：

• 系统电源管理：提供重启、关机、查询屏幕状态功能。
• 热管理：提供热档位查询及注册回调功能。

电池服务中不支持电池信息设置查询功能。

参与贡献

欢迎广大开发者贡献代码、文档等，具体的贡献流程和方式请参见参与贡献。

相关仓

powermgr_power_manager

arkcompiler_cangjie_ark_interop