跳转到主要内容
本页面是示例应用:完整的 OneSignal 集成的一部分,该指南从头到尾跟随一个真实应用。这个应用是 Clean Beans,一款面向合租家庭的打扫值日表应用,使用 Expo(React Native)和 Supabase 后端构建。 让推送送达只是第一步。本页面介绍让推送值得信赖的更细致的决定:绝不重复发送同一条推送、让过时的推送自动过期,以及让每种类型的推送都以合适的方式表现。

绝不重复发送同一条提醒 \

计划任务会被重试。任务也可能被误运行两次。如果没有保护,每次重复都会多发一条推送。 OneSignal 的 idempotency_key 可以解决这个问题。如果两个请求带有相同的键,第二个请求不会被发送。该键必须是 UUID,OneSignal 会将其保留 30 天。 计划函数没有地方在多次运行之间保存随机键,因此 Clean Beans 根据发送本身来生成键:类型、接收者和日期。同一次发送总会生成相同的键。
supabase/functions/_shared/idempotency.ts
对于批量发送,键覆盖整个批次。
supabase/functions/send-cleaning-reminder/index.ts
幂等键适用于 Create message 和 Create custom events 端点。Live Activity 请求不接受幂等键,它们通过 activity_id 进行标识。

为每种推送设定各自的行为 \

晚到两小时的打扫提醒还不如没有提醒。Kudos 让人开心,但从不紧急。Clean Beans 在一组投递配置中统一描述这些差异,并将合适的配置展开到每个请求中。
supabase/functions/_shared/delivery.ts
类型列表中的 member_lapsed 配置属于从 Journey Webhook 发送的推送,本指南不涉及。 各项设置的作用:
  • ttl 是为离线设备保留推送的时长。打扫提醒的内容是“1 小时后”,因此一小时后就会被丢弃。
  • thread_id 和 android_group 会在通知列表中将相关推送分组。
  • ios_interruption_level 控制推送的提醒强度。time_sensitive 可以突破专注模式。passive 会静默送达。
  • ios_relevance_score 决定推送在 iOS 通知摘要中的排序。Clean Beans 将 1.0 留给关键消息,并且没有发送这类消息。
应用设置。 只有当应用声明了该 capability 时,iOS 才会遵循 time_sensitive。
app.json
一条经验教训:collapse_id。 Clean Beans 最初为摘要和逾期提醒设置了相同的 collapse_id,让提醒替换摘要。在 iOS 上,如果一条推送替换了仍在通知列表中的推送,它会被原地替换,没有横幅也没有声音。提醒因此被忽视,失去了意义,所以这项设置被移除了。只有在您确实需要静默更新时(例如实时比分),才使用 collapse_id。

在应用图标上显示数量 \

两种任务推送会把应用图标角标设置为标题中的数字。
supabase/functions/send-overdue-reminders/index.ts
带有角标数字的 Clean Beans 应用图标

应用图标角标显示逾期任务的数量。

这里使用 SetTo 而不是 Increase,因为角标表示的是任务数量,而不是未读通知数量。下午的提醒会替换早上的数字。
每次打开应用时,OneSignal SDK 都会自动清除角标,因此应用无需编写重置代码。应用处于打开状态时到达的推送不会显示角标。Android 没有可以通过 API 设置的数字角标。

幂等请求

键的工作方式和有效期。

中断级别

专注模式和四种级别。

角标

各平台的角标行为。