已关闭
docs(ohbattery_info): 同步电池信息接口中文注释一致性 #4581
cjw123qq创建于 16 天前关闭于 6 天前
openharmony_ci
16 天前 评论：
16 天前 评论：
感谢提交Issue！关于Issue的交互操作，请访问OpenHarmony社区支持命令清单。如果有问题，请联系 [@majiajun518](https://gitcode.com/majiajun518) [@liyiming13](https://gitcode.com/liyiming13) 。如果需要调整订阅PR、Issue的变更状态，请访问链接。
Thanks for submitting the issue. For more commands, please visit OpenHarmony Command List. If you have any questions, please refer to committer gitcode for help. If you need to change the subscription of a Pull Request or Issue, please visit the link.
16 天前 添加了label：waiting_for_assign
16 天前 关联了pull request：docs(ohbattery_info): 同步电池信息接口中文注释一致性
6 天前 关闭了 issue
6 天前 issue状态由 待办的 改变为 已完成
背景\n\ninterface_sdk_c 中 ohbattery_info.h 的中文接口注释（zh-cn/BasicServicesKit/ohbattery_info.h）与 docs 文档描述不一致，需要按 docs 文档内容刷新接口注释，保持资料一致性。\n\n## 修改内容\n\n将 zh-cn/BasicServicesKit/ohbattery_info.h 中电池信息接口的中文注释按 docs 最新描述同步：\n\n- 文件头 @brief：声明电池API以获取设备当前剩余的电池电量百分比和连接的充电器类型，定义电池相关常见事件等。\n- COMMON_EVENT_KEY_CAPACITY：标识剩余电池电量百分比变化后发送的常见事件。\n- COMMON_EVENT_KEY_PLUGGED_TYPE：标识连接的充电器类型更改后发送的常见事件。\n- BatteryInfo_BatteryPluggedType：定义连接的充电器类型。\n- PLUGGED_TYPE_USB / PLUGGED_TYPE_WIRELESS：电源是USB充电 / 电源是无线充电。\n- OH_BatteryInfo_GetCapacity：返回当前电池电量百分比（补充使用场景与取值范围说明）。\n- OH_BatteryInfo_GetPluggedType：返回连接的充电器类型（补充使用场景与返回值说明）。\n\n## 验证\n\n- 仅修改 zh-cn/BasicServicesKit/ohbattery_info.h 注释，无接口签名变更。\n- 英文路径 BasicServicesKit/ohbattery_info.h 不受影响。