@awarns/human-activity

本模块允许检测和响应用户（或携带手机的物体）执行的活动变化：静止、行走、跑步、骑自行车或处于车内。根据检测机制的粒度，甚至可以检测用户的站立行为。

此插件作为 nativescript-context-apis 插件（来自同一作者）的包装器，提供人类活动变化检测任务。即使在后台也能获取人类活动更新。

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

ns plugin add @awarns/human-activity

用法

安装和设置此插件后，您将可以访问两个任务组，以不同粒度级别开始和停止监听人类活动更新。收到的更新将是下面描述的 HumanActivityChange 记录。

设置

此插件要求您在框架初始化期间注册其加载器，如下所示

// ... platform imports
import { awarns } from '@awarns/core';
import { demoTasks } from '../tasks';
import { demoTaskGraph } from '../graph';
import { registerHumanActivityPlugin } from '@awarns/human-activity';

awarns
  .init(
    demoTasks,
    demoTaskGraph,
    [
      registerHumanActivityPlugin(),
    ]
  )
  // ... handle initialization promise

插件加载器参数

此插件加载器不接收任何参数。

任务

注意：所有任务都需要 物理活动访问权限 才能执行。每个任务将在框架初始化期间自动请求缺少的权限

开始/停止接收粗粒度人类活动变化更新

要注册这些任务以供使用，您只需在应用程序的任务列表中导入它们并调用它们的生成器函数即可

import { Task } from '@awarns/core/tasks';
import {
  startDetectingCoarseHumanActivityChangesTask,
  stopDetectingCoarseHumanActivityChangesTask,
} from '@awarns/human-activity';

export const demoTasks: Array<Task> = [
  startDetectingCoarseHumanActivityChangesTask(),
  stopDetectingCoarseHumanActivityChangesTask(),
];

任务生成器参数

这些任务生成器不接收任何参数

任务输出事件

这些任务在执行完成后不会产生显著事件，除了常规的 {task-name}Finished 事件外，这些事件是：startDetectingCoarseHumanActivityChangesFinished 和 stopDetectingCoarseHumanActivityChangesFinished。

然而，一旦启动任务运行完成，一旦检测到相应的动作，内部监听器将发出相关事件。以下列出了这些事件。

• 用户开始静止
• 用户完成静止
• 用户开始行走
• 用户完成行走
• 用户开始跑步
• 用户完成跑步
• 用户开始骑自行车
• 用户完成骑自行车
• 用户开始乘坐车辆
• 用户完成乘坐车辆

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

on('startEvent', run('startDetectingCoarseHumanActivityChanges'));
on('stopEvent', run('stopDetectingCoarseHumanActivityChanges'));

on('userStartedBeingStill', run('writeRecords'));
on('userFinishedBeingStill', run('writeRecords'));

on('userStartedWalking', run('writeRecords'));
on('userFinishedWalking', run('writeRecords'));

on('userStartedRunning', run('writeRecords'));
on('userFinishedRunning', run('writeRecords'));

on('userStartedRidingABicycle', run('writeRecords'));
on('userFinishedRidingABicycle', run('writeRecords'));

on('userStartedBeingInAVehicle', run('writeRecords'));
on('userFinishedBeingInAVehicle', run('writeRecords'));

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

在中级水平上开始/停止接收人类活动变化更新

要注册这些任务以供使用，您只需在应用程序的任务列表中导入它们并调用它们的生成器函数即可

import { Task } from '@awarns/core/tasks';
import {
  startDetectingIntermediateHumanActivityChangesTask,
  stopDetectingIntermediateHumanActivityChangesTask,
} from '@awarns/human-activity';

export const demoTasks: Array<Task> = [
  startDetectingIntermediateHumanActivityChangesTask(),
  stopDetectingIntermediateHumanActivityChangesTask(),
];

任务生成器参数

这些任务生成器不接收任何参数

任务输出事件

除了常规的{任务名称}Finished事件外，这些任务在执行完成后不会产生显著事件，这些事件是：startDetectingIntermediateHumanActivityChangesFinished和stopDetectingIntermediateHumanActivityChangesFinished。

然而，一旦启动任务运行完成，一旦检测到相应的动作，内部监听器将发出相关事件。以下列出了这些事件。

• 用户开始静止
• 用户完成静止
• 用户开始站立
• 用户完成站立
• 用户开始行走
• 用户完成行走
• 用户开始跑步
• 用户完成跑步
• 用户开始骑自行车
• 用户完成骑自行车
• 用户开始乘坐车辆
• 用户完成乘坐车辆

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

on('startEvent', run('startDetectingCoarseHumanActivityChanges'));
on('stopEvent', run('stopDetectingCoarseHumanActivityChanges'));

on('userStartedBeingStill', run('writeRecords'));
on('userFinishedBeingStill', run('writeRecords'));

on('userStartedStandingUp', run('writeRecords'));
on('userFinishedStandingUp', run('writeRecords'));

on('userStartedWalking', run('writeRecords'));
on('userFinishedWalking', run('writeRecords'));

on('userStartedRunning', run('writeRecords'));
on('userFinishedRunning', run('writeRecords'));

on('userStartedRidingABicycle', run('writeRecords'));
on('userFinishedRidingABicycle', run('writeRecords'));

on('userStartedBeingInAVehicle', run('writeRecords'));
on('userFinishedBeingInAVehicle', run('writeRecords'));

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

事件

记录

HumanActivityChange

许可证

Apache许可证版本2.0