跳到正文

本页内容为机器翻译 (查看原文)

HTTP API

BlinkEasy 可以很方便地与您自己的应用程序对接。例如,您可以搭建自己的数据分析工具,或者控制物联网设备,比如根据眨眼频率调节灯光。

在设置页面填写回调 URL,即可启用这项高级功能。 可参考 ESP32 示例代码。

  • 为保护隐私,HTTP 模块只会发送概要数据,无法发送视频画面或可识别个人身份的信息。
  • 事件发生时会立即发送请求;此外还会定期发送请求,上报当前眨眼频率等统计数据。
  • 支持自定义参数,可用于附带凭据或区分不同设备。

每次请求都会附带的参数:

event事件 ID。可能的取值:BLINK、START、END、BPM、ALERT、BREAK
timestamp自 1970 年 1 月 1 日(UTC)起经过的毫秒数。
Example:
http://localhost:3000/myscript.php?event=START&timestamp=1723321032811

事件类型:

BLINK

检测到一次眨眼时发送。

参数:
duration 眨眼持续时间,单位为毫秒
bpm 当前眨眼频率(每分钟眨眼次数)
Example:
http://localhost:3000/myscript.php?event=BLINK&bpm=13.2&duration=185&timestamp=1723321032811

START

首次检测到人脸时发送,表示一次会话开始。

Example:
http://localhost:3000/myscript.php?event=START&timestamp=1723321032811

END

连续 timeout 毫秒未检测到人脸时发送,表示当前会话结束。

参数:
timeout 当前会话的超时时间,单位为毫秒。用事件的 timestamp 减去 timeout,即为最后一次识别到人脸的时间。
Example:
http://localhost:3000/myscript.php?event=END&timeout=60&timestamp=1723321032811

BPM

定期发送的事件。

参数:
bpm 当前眨眼频率,单位为每分钟眨眼次数。
Example:
http://localhost:3000/myscript.php?event=BPM&bpm=13.2&timestamp=1723321032811

ALERT

用户的眨眼频率低于设定的阈值时发送。即使关闭了眨眼提醒,也会发送此事件。

参数:
bpm 当前眨眼频率,单位为每分钟眨眼次数。
target 当前眨眼频率跌破的阈值。
duration 发出提醒前,眨眼频率持续低于目标值的毫秒数。
Example:
http://localhost:3000/myscript.php?event=ALERT&bpm=13.2&target=15.0&duration=12&timestamp=1723321032811

BREAK

发出休息提醒时发送。

参数:

无

Example:
http://localhost:3000/myscript.php?event=BREAK&timestamp=1723321032811