跳转到主要内容
本页面是示例应用:完整的 OneSignal 集成的一部分,该指南从头到尾跟随一个真实应用。这个应用是 Clean Beans,一款面向合租家庭的打扫值日表应用,使用 Expo(React Native)和 Supabase 后端构建。 只有点击后能把您带到正确位置,通知才有用。Clean Beans 处理四种进入应用的方式:点击推送、点击推送上的按钮、自定义 scheme 链接,以及普通网页链接。

路由被点击的推送 \

每条推送都带有 data.type 字段。应用监听点击,读取类型,然后打开对应的界面。
app/_layout.tsx
其中两种类型来自 Journeys,本指南不涉及。reengagement 设置在仪表板中构建的召回 Journey 的推送上。member_lapsed 是发给家庭所有者和管理员的推送,当该 Journey 报告某位成员已停止打扫时由后端发送。它们和其他推送一样在这里路由。
按您自己控制的类型路由比解析 URL 更可靠。如果某个界面移动了,您只需修改一处 switch 语句,变更前发送的所有推送仍能正确打开。

操作按钮:可点击的不止一处 \

推送可以带有按钮。任务推送提供 Start cleaning 和 Snooze 1h,“室友完成打扫”推送提供 Send kudos。用户展开通知即可看到按钮,在 iOS 上需要长按。
带有 Start cleaning 和 Snooze 1h 按钮的展开推送通知

展开后带有两个操作按钮的提醒。

后端将按钮添加到请求中。每个按钮都有一个 id 和一个标签。
supabase/functions/_shared/buttons.ts
点击按钮会打开应用,上面的点击监听器会以 event.result.actionId 的形式收到按钮的 id。点击通知本身则没有 actionId。应用会先检查是否为按钮,否则回退到常规路由。
src/lib/pushActions.ts
稍后提醒需要后端,因为应用无法发送推送。应用会调用一个函数,用 send_after 安排另一条提醒。OneSignal 会保留消息直到那时,因此不需要任何程序持续运行一小时。
supabase/functions/snooze-reminder/index.ts
每次点击按钮也会记录为自定义事件 push_action_clicked。Journey 无法直接根据按钮分支,但可以等待此事件并根据其 action_id 属性分支。
默认情况下,点击按钮会打开应用。若要在不打开应用的情况下处理点击,需要原生代码:iOS 上需要通知类别,Android 上需要 notification service extension。
来自应用外部的链接使用 /clean 这样的短路径。Expo Router 的 native intent 钩子会在导航发生前将其重写为应用的真实路由,因此应用外部的任何东西都不需要了解界面的组织方式。
app/+native-intent.tsx
像 cleaning-rota:// 这样的自定义 scheme 只有在应用已安装时才有效,而且许多应用不会让它变成可点击的链接。iOS 上的 Universal Links 和 Android 上的 App Links 解决了这个问题。它们是普通的 https:// 链接,已安装应用时打开应用,未安装时打开网站。因此它们是邮件、短信和分享消息中链接的合适选择。 设置它们需要两端各做一次声明:应用声明自己属于哪个域名,网站声明哪个应用可以打开它的链接。
1

在应用中声明域名

app.json
2

发布 Apple 关联文件

将其托管在 /.well-known/apple-app-site-association,通过 HTTPS 以 JSON 格式提供。应用 ID 是您的 Apple Team ID 后接 bundle identifier。
website/.well-known/apple-app-site-association
3

发布 Android 关联文件

将其托管在 /.well-known/assetlinks.json。指纹来自应用的签名证书。使用 EAS 时,运行 eas credentials -p android 即可找到它。
website/.well-known/assetlinks.json
4

使用链接

家庭界面会分享邀请链接。点击该链接会打开加入界面,并自动填好邀请码。
app/household.tsx
app/join-household.tsx
Clean Beans 只声明应用能够显示的路径。首页不在其中,因此营销网站仍然在浏览器中打开。iOS 会在安装或更新应用时读取关联文件,因此请在发布构建之前发布该文件。

深度链接

OneSignal 在各平台上如何处理 URL。

通知负载

点击监听器中可用的所有字段。

操作按钮

平台限制、图标和点击处理。