メインコンテンツへスキップ
このページは、1つの実在アプリを最初から最後まで追うサンプルアプリ:OneSignalの完全な統合の一部です。アプリはClean Beansという共同生活の家のための掃除当番表アプリで、Expo(React Native)とSupabaseバックエンドで構築されています。 ほかのすべては、次の4点が正しく設定されていることを前提とします。SDKがインストールされていること、アプリの起動時にSDKが起動すること、各デバイスがユーザーに結び付いていること、そしてユーザーが受け取る内容を管理できることです。

Expoプラグインでインストールする \

onesignal-expo-pluginは、ビルド時にiOSとAndroidのネイティブプロジェクトを設定します。画像、バッジ、配信確認のためにOneSignalが必要とするプッシュのcapability、App Group、Notification Service Extensionを追加します。
app.json

ルートで一度だけ初期化する \

Clean BeansはルートレイアウトでOneSignalを初期化するため、起動のたびに、どの画面が表示されるよりも前に一度だけ実行されます。
app/_layout.tsx
初回起動時に許可をリクエストするのが最も簡単な方法です。先にメリットを説明したい場合は、システムのプロンプトの前にアプリ内メッセージを表示します。Clean Beansには既製のものがあります。プッシュ許可の事前プロンプトを参照してください。

各デバイスをユーザーに結び付ける \

ユーザーがサインインすると、アプリはSupabaseのユーザーIDをOneSignal.login()に渡します。このIDがExternal IDになります。サインアウトすると、logout()がデバイスの紐付けを解除し、次にサインインした人が前のユーザーのメッセージを引き継がないようにします。
app/_layout.tsx
どちらのメソッドを呼び出す場合も、保存されたセッションが読み込まれるまで待ってください。コールドスタート時には、サインイン中のユーザーが一瞬不明になります。その瞬間にアプリがlogout()を呼び、直後にlogin()を呼ぶと、デバイスのプッシュサブスクリプションが匿名ユーザーに残り、External ID宛てのプッシュが端末に届かなくなることがあります。logout()は実際にサインアウトしたときだけ呼び出してください。
このガイドでのバックエンドからの送信はすべて、この1回の呼び出しによって可能になります。ユーザーのデータベースIDを知っている関数は、そのユーザーのデバイスについて何も知らなくてもメッセージを送れます。

メールチャネルを追加する \

アプリは登録時から各ユーザーのメールアドレスを把握しているため、サインイン時にそれをメールサブスクリプションとして登録します。OneSignalは同じアドレスでの重複した呼び出しを無視します。
src/lib/onesignalSync.ts
SMSも同じようにaddSms()で追加しますが、番号の認証が済んでからに限ります。SMS:認証コードと招待を参照してください。

受け取る内容をユーザーが管理できるようにする \

通知設定画面には、マスタースイッチと、メッセージの種類ごとのスイッチがあります。
マスタートグルと種類ごとのトグルがある通知設定画面

通知設定:マスタースイッチ、種類ごとのスイッチ、毎日のリマインダー時刻。

マスタースイッチはプッシュサブスクリプションに対してoptOut()とoptIn()を呼び出すため、OneSignalはそのデバイスへの配信を停止・再開します。
app/notification-settings.tsx
各スイッチはユーザーのプロフィール行にも保存されます。バックエンドは送信前にこれらの列を読み取ります。これにより種類ごとの設定が適用されます。
src/lib/database.ts
設定を自分のデータベースに保存し、送信のたびに確認すると、ロジックを1か所にまとめられます。別の方法として、設定をタグとして保存し、OneSignalでタグによって絞り込むこともできます。この方法はセグメントに送信する場合に適しています。Clean Beansは特定のユーザーに送信するため、データベースを確認するほうが簡単です。

モバイルSDKリファレンス

このガイドで使用するすべてのクライアントメソッド。

ユーザーとExternal ID

IDがチャネルとデバイスをまたいでサブスクリプションを結び付ける仕組み。