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

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

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

1. モバイルアプリケーションをCatalystに登録し、設定後にコンソールからアプリケーション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 Cloud Scale Authenticationコンポーネントを必ず使用する必要があります。

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

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

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

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

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

サンプルコードスニペット

import com.zc.component.notifications.ZCMobileNotification;

ZCMobileNotification mobile = ZCMobileNotification.getInstance(1234567890l);

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

ZCMobileNotification mobile = ZCMobileNotification.getInstance(1234567890l, ZCProject project);

Androidプッシュ通知の送信

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

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

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

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

サンプルコードスニペット

import com.zc.component.notifications.ZCMobileNotification;
import com.zc.component.notifications.ZCPush;
import com.zc.component.notifications.ZCPushMessage;

ZCPushMessage notificationRes = mobile.sendAndroidPushNotification(new ZCPush() {
{
setMessage("This message is to test if the functionality is working fine!");
setBadgeCount(1);							
}
}, "emma.b@zylker.com");

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

iOSプッシュ通知の送信

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

サンプルコードスニペット

import com.zc.component.notifications.ZCMobileNotification;
import com.zc.component.notifications.ZCPush;
import com.zc.component.notifications.ZCPushMessage;

ZCPushMessage notificationRes = mobile.sendIOSPushNotification(new ZCPush() {
{
setMessage("This message is to test if the functionality is working fine!");
setBadgeCount(1);	      
}
}, "emma.b@zylker.com");