プッシュ通知

はじめに

Catalystプッシュ通知を使用すると、アプリがユーザーデバイスでアクティブに実行されていない場合でも、アプリケーションのユーザーにリモート通知を送信できます。Catalystは、Catalystウェブ、iOS、およびAndroidアプリケーションにプッシュ通知を簡単に統合する方法を提供します。

Flutter SDKを通じてプッシュ通知を実装する場合、アプリを構築するプラットフォームに応じて、iOSまたはAndroidの前提条件を満たす必要があります。これらの前提条件を以下に説明します。

iOSアプリの前提条件

iOSアプリでプッシュ通知を送信する前に、アプリを登録してCatalystプッシュ通知にエンロールするための一連の手順に従う必要があります。以下に手順を順に示します：

1. AppleにiOSアプリを登録する
2. Keychain Accessから証明書を生成する
3. Appleが提供するAPNs証明書を生成してダウンロードする
4. ダウンロードしたAPNs証明書を.p12形式に変換する
5. CatalystでiOSプッシュ通知サービスにエンロールする
6. プッシュ通知用にモバイルデバイスを登録する

Androidアプリの前提条件

プッシュ通知を送信する前に、アプリを登録してCatalystプッシュ通知にエンロールするための一連の手順に従う必要があります。以下に手順を順に示します：

1. FirebaseのAndroid設定ファイルを生成する
2. Firebaseアクセス用の秘密鍵を生成する
3. CatalystでAndroidプッシュ通知サービスを設定する
4. プッシュ通知用にモバイルデバイスを登録する

プッシュ通知用モバイルデバイスの登録

作業しているプラットフォームの上記の前提条件を完了した後、デバイスをCatalystプッシュ通知に登録する以下のコードをアプリのコードベースに実装できます。

Flutterモバイルデバイスをテストデバイスとして登録するには、以下のコードスニペットに示すように、必要なパラメータを指定してregisterNotification()メソッドを呼び出す必要があります：

try {
     var response = await ZCatalystApp.getInstance().registerNotification(deviceToken: deviceToken, notificationAppId: '1624000000074620',isTestDevice: false);
     print(response?.responseJson);
    } on ZCatalystException catch (ex) {
     log("Register Failed: $ex");
}

パラメータ:

• deviceToken: AndroidアプリのFCMから取得したデバイストークン、またはiOSアプリのAPNSにリモートプッシュ通知用にデバイスを登録した後に取得したデバイストークン。

• notificationAppID: Androidの場合、これはCatalystがプッシュ通知でAndroidアプリ用に生成したアプリIDです。Catalystコンソールのプッシュ通知のAndroidセクションで確認できます。iOSの場合、これはCatalystにiOSアプリを登録した際にCatalystがアプリ用に生成したAppConfigurationDevelopment.plist/ AppConfigurationProduction.plistファイルから取得されます。

• testDevice: テストデバイスの場合は値をtrueに設定し、本番デバイスの場合はfalseに設定します。

デバイスが登録されると、アプリユーザーにプッシュ通知を送信できるようになります。ユーザーは、デバイスの許可プロンプトから許可をクリックして、アプリがプッシュ通知を送信する許可を提供する必要があります。

登録済みデバイスへのテストプッシュ通知の送信については、CatalystコンソールからiOSアプリおよびAndroidアプリのそれぞれのヘルプドキュメントで確認できます。また、APIからテスト通知を送信することもできます。

コードベースを通じたプッシュ通知の送信については、Java、Node.js、およびPython SDKドキュメントを参照してください。