モバイルアプリへのプッシュ通知

Catalyst Cloud Scale Push Notificationsコンポーネントを使用すると、AndroidまたはiOSプラットフォーム上に構築されたモバイルアプリケーションに通知を送信できます。CatalystユーザーIDまたはメールアドレスを使用して、特定のターゲットユーザーにプッシュ通知を送信できます。アラート、更新情報、またはプロモーションコンテンツを含めて、ユーザーがアプリケーションに関与できるようにすることができます。

プッシュ通知を設定するには、以下の前提条件を満たす必要があります:

1. モバイルアプリケーションをCatalystに登録し、設定後にコンソールからApplication ID（appId）をメモする必要があります。ターゲットデバイスにインストールされたアプリケーションの登録は、個別のプラットフォーム固有のCatalyst Mobile SDKメソッド（AndroidおよびiOSで利用可能）またはFlutter SDKを使用して行えます。

   appIdは、Catalystコンソールで直接Android Push Notificationsサービスを設定することで取得できます。

   Android SDKを使用したAndroidアプリの登録について学ぶ。

   iOS SDKを使用したiOSアプリの登録について学ぶ。

   Flutter SDKを使用したモバイルアプリ（AndroidまたはiOS）の登録について学ぶ。

2. モバイルアプリケーションは、Catalyst Serverless Authenticationコンポーネントを必ず使用する必要があります。

すべての設定が完了すると、Catalystユーザーは通知を迅速に受信するためにデバイスにログインしている必要があります。

設定が完了したら、生成されたApplication IDを使用して、以下のNode.js SDKメソッドを呼び出すことで、特定のアプリをターゲットにして通知を送信できます。

モバイル通知インスタンスの取得

モバイル通知インスタンスを作成し、Catalystコンソールに登録された特定のモバイルアプリを参照するために使用できます。これは、pushNotification().mobile()メソッドで生成されたappIDをパラメータとして渡すことで、モバイル通知インスタンスを取得して行います。

このモバイル通知インスタンスを使用して、次のセクションで説明するプッシュ通知の送信など、Node.js SDKメソッドで追加の操作を実行します。

const notification = app.pushNotification().mobile("1234567890");

ここで、1234567890はappIDです。また、アプリケーションがCatalystスコープベースのアクセスを含む場合は、appIDと共にZCProject projectパラメータを渡すことができます。

Catalyst SDKスコープの詳細を学ぶ。

const notification = app.pushNotification().mobile("1234567890", ZCProject project);

Androidプッシュ通知の送信

Androidアプリケーションをプッシュ通知送信用にCatalystに登録した後、sendAndroidNotification()メソッドを使用してアプリケーションにプッシュ通知を送信できます。

sendAndroidNotification()メソッドに2つのパラメータを渡す必要があります:

MobileNotification.sendAndroidNotification(notifyObj: ICatalystPushDetails, recipient: string): Promise

• notifyObj - プッシュ通知メッセージの詳細を含むオブジェクトです。

• recipient - メッセージを配信する受信者のCatalystユーザーIDまたはメールアドレスです。

アプリケーションでsendAndroidNotification()メソッドを呼び出すには、以下のコードスニペットを使用できます:

notification.sendAndroidNotification({
 message: 'This message is to test if the functionality is working fine!',
 badge_count: 1
}, 'emma.b@zylker.com');

badge_countはアプリアイコンの通知バッジカウントを1に設定します。この値は必要に応じて任意の数に変更できます。

iOSプッシュ通知の送信

iOSアプリケーションをプッシュ通知送信用にCatalystに登録した後、sendIOSNotification()メソッドを使用してアプリケーションにプッシュ通知を送信できます。

sendIOSNotification()メソッドに2つのパラメータを渡す必要があります:

MobileNotification.sendIOSNotification(notifyObj: ICatalystPushDetails, recipient: string): Promise

アプリケーションでsendIOSNotification()メソッドを呼び出すには、以下のコードスニペットを使用できます:

notification.sendIOSNotification({
 message: 'This message is to test if the functionality is working fine!',
 badge_count: 1
}, 'emma@zylker.com');