
锁屏上正在倒计时的打扫提醒。
设置应用 \
跨平台应用可以让 OneSignal 管理 Live Activity 的生命周期。启动时调用一次即可,JavaScript 部分仅此而已。app/_layout.tsx
plugins/withLiveActivityWidget.js
绘制小组件 \
小组件使用 OneSignal 的DefaultLiveActivityAttributes,它可以携带任意格式的数据。一个小组件通过读取 type 值并选择布局来同时支持两种活动。
plugins/widget/CleanBeansWidgetLiveActivity.swift
attributes 在活动启动时确定。state 可以随每次更新而变化。
plugins/widget/CleanBeansWidgetLiveActivity.swift
连续记录警告:从后端启动活动 \
在当地时间晚上 7 点,有连续记录但今天还没打扫的用户会收到一个到午夜的倒计时。每小时运行的函数使用与推送提醒相同的时区匹配找出这些用户,然后为每人启动一个活动。supabase/functions/streak-warning/index.ts

倒计时到午夜的连续记录警告。
打扫提醒:启动、更新、结束 \
打扫提醒会经历三个阶段。每个阶段都是针对同一活动的单独请求。
函数会计算每位用户应处于哪个阶段。
supabase/functions/cleaning-activity/index.ts
supabase/functions/cleaning-activity/index.ts
这些请求使用
priority: 10,因为每个请求都是应立即显示的阶段变化,而且每人每天最多只收到几次。优先级 10 会计入 Apple 为每台设备分配的 Live Activity 更新预算。对于频繁更新的内容(例如比分或进度条),请从 5 开始。为每个活动分配独立的
activity_id,并在活动启动时保存。活动结束后,OneSignal 不再接受针对该 activity_id 的更新,因此如果每位用户使用固定 ID,第一天之后就会失效。跨平台设置
setupDefault 和小组件扩展。启动 Live Activity
push-to-start API。
更新 Live Activity
更新和结束请求。