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×tamp=1723321032811
事件类型:
BLINK
检测到一次眨眼时发送。
参数:
| duration | 眨眼持续时间,单位为毫秒 |
| bpm | 当前眨眼频率(每分钟眨眼次数) |
Example:
http://localhost:3000/myscript.php?event=BLINK&bpm=13.2&duration=185×tamp=1723321032811
START
首次检测到人脸时发送,表示一次会话开始。
Example:
http://localhost:3000/myscript.php?event=START×tamp=1723321032811
END
连续 timeout 毫秒未检测到人脸时发送,表示当前会话结束。
参数:
| timeout | 当前会话的超时时间,单位为毫秒。用事件的 timestamp 减去 timeout,即为最后一次识别到人脸的时间。 |
Example:
http://localhost:3000/myscript.php?event=END&timeout=60×tamp=1723321032811
BPM
定期发送的事件。
参数:
| bpm | 当前眨眼频率,单位为每分钟眨眼次数。 |
Example:
http://localhost:3000/myscript.php?event=BPM&bpm=13.2×tamp=1723321032811
ALERT
用户的眨眼频率低于设定的阈值时发送。即使关闭了眨眼提醒,也会发送此事件。
参数:
| bpm | 当前眨眼频率,单位为每分钟眨眼次数。 |
| target | 当前眨眼频率跌破的阈值。 |
| duration | 发出提醒前,眨眼频率持续低于目标值的毫秒数。 |
Example:
http://localhost:3000/myscript.php?event=ALERT&bpm=13.2&target=15.0&duration=12×tamp=1723321032811
BREAK
发出休息提醒时发送。
参数:
无
Example:
http://localhost:3000/myscript.php?event=BREAK×tamp=1723321032811