@awarns/battery
AwarNS 框架包,提供访问当前电池电平的功能
npm i --save @awarns/battery

@awarns/battery

npm (scoped) npm

此框架模块包括一个任务,允许按需访问手机的电池电平。

使用以下命令行指令安装插件

ns plugin add @awarns/battery

用法

安装并设置此插件后,您将能够访问一个任务,允许获取当前手机的电池电平以及按需输出的 BatteryLevel 记录。

任务

任务名称 描述
acquirePhoneBatteryLevel 获取手机当前电池电平

获取手机电池电平

要注册此任务以供使用,您只需将其导入并在应用程序的任务列表中调用其生成函数即可

import { Task } from '@awarns/core/tasks';
import { acquireBatteryLevelTask } from '@awarns/battery';

export const demoTasks: Array<Task> = [
// ... other tasks
acquireBatteryLevelTask(),
// ...
];

任务生成器参数

任务生成器不接收任何参数。

任务输出事件

在应用程序任务图中的应用示例

on('startEvent', run('acquirePhoneBatteryLevel')
.every(1, 'minutes')
.cancelOn('stopEvent'));

on('batteryLevelAcquired', run('writeRecords'))

注意:要使用 writeRecords 任务,必须安装并配置持久化包。请参阅 持久化包文档

事件

名称 负载 描述
batteryLevelAcquired BatteryLevel 指示已获取新的电池电平快照(记录)

记录

BatteryLevel

属性 类型 描述
id string 记录的唯一ID
type string 始终为 battery-level
change 变更 始终为 none。永不开始或结束,始终存在
timestamp Date 获取电池电平时的本地时间
value number 电池电平。始终为整数。范围从0到100

许可证

Apache许可证版本2.0