プッシュ通知の構成と使用法

プッシュ通知のメッセージ・タイプ

プッシュ通知では、以下のメッセージ・タイプが使用されます。

• EnsLib.PushNotifications.NotificationInfo— モバイル・デバイスに送信される情報が含まれています。

• EnsLib.PushNotifications.NotificationRequest— NotificationInfo が含まれていると共に、オペレーションが NotificationInfo を正しいデバイスに送信することを可能にするルーティング情報が含まれています。

• EnsLib.PushNotifications.NotificationResponse— 通知サーバからの応答が含まれています。

• EnsLib.PushNotifications.IdentityManager.NotificationByIdentityRequest— NotificationInfo と識別情報が含まれています。これにより、Identity Manager がデバイス情報を検出できるようになります。

• EnsLib.PushNotifications.IdentityManager.NotificationByIdentityResponse— Identity Manager からの応答が含まれています。

APNS オペレーションを使用した通知のプッシュ送信

EnsLib.PushNotifications.APNS.OperationOpens in a new tab は、通知要求を APNS サーバに送信して、指定されたデバイスに転送します。APNS サーバは、呼び出しごとに 1 台のデバイスに通知をプッシュ送信します。APNS サーバは通常は何の情報も返しませんが、エラーが発生した場合はその旨を示す情報を返します。

以下の設定を APNS オペレーションについて構成します。

SSL はリモート・アプリと関連付けられていますが、同じ SSL がアプリのすべてのユーザに対して使用されます。お使いのアプリケーションが単一のアプリに通知をプッシュ送信する場合は、プロダクション内で 1 つの SSL と 1 つの APNS オペレーションのみが必要です。お使いのアプリケーションが Apple デバイス上で実行されている複数のアプリに通知をプッシュ送信する場合は、アプリごとに 1 つの SSL が必要であると共に、アプリごとにその SSL を使用して構成された 1 つの対応する APNS オペレーションが必要です。ルータを使用している場合は、各通知を正しい APNS オペレーション宛てに送信する必要があります。例えば、デバイス・トークンを対応するオペレーションに関連付けるルックアップ・テーブルを作成してから、そのルックアップ・テーブルをルーティング・ルール内で使用できます。

APNS プロトコルは、Enhanced プロトコルのエラー・ステータス以外の値を返しません。したがって、Enhanced プロトコル・メッセージでエラーが発生してないことを検知するための唯一の方法は、戻りエラー応答が検知されるまで待つことです。エラー応答が相当の時間内に受信されない場合は、オペレーションはプロトコル・メッセージが正常に処理されたと見なします。エラー応答を待つ時間の長さは、ResponseTimeout 設定で指定します。このタイムアウト値は、APNS サーバからのエラー応答を捕捉するのに十分な長さである必要がありますが、このタイムアウト値が経過するまで APNS サーバは別の要求を処理できなくなるため、このタイムアウト値を必要以上に長くすることは避けてください。デフォルト値の 5 秒を使用した場合は、オペレーション・インスタンスは 5 秒あたり 1 つの要求のみを処理できます。したがって、プール・サイズは、このタイムアウト時間内に通常発生する要求数を処理できる十分な大きさに設定する必要があります。

Simple プロトコルを使用している場合は、エラーが発生した場合でも何の値も返されません。Simple プロトコルの場合は、ResponseTimeout を最小値である 0 秒以外の値に設定することにメリットはありません。

SSL 証明書は Apple サーバによって提供されます。各アプリは固有の SSL を必要とします。

GCM オペレーションを使用した通知のプッシュ送信

以下の設定を GCM オペレーションについて構成します。

Identity Manager へのデバイスの登録

デバイス・トークンとアプリケーションの 1 つ以上のペアを AssociatedIdentity 文字列識別子に登録できます。アプリケーションはこの文字列識別子を使用して、この識別子に関連付けられたすべてのデバイスに通知をプッシュ送信できます。EnsLib.PushNotifications.IdentityManager.DeviceTrackingOpens in a new tab クラスには、以下のメソッドが用意されています。

• AssociateDeviceWithAppToken— デバイス・トークン、AppID、およびサービスを AssociatedIdentity 文字列識別子に関連付けます。

• DisassociateDeviceWithAppToken— デバイス・トークン、AppID、およびサービスと AssociatedIdentity 文字列識別子の関連付けを解除します。

• FindDeviceByAppToken— 指定された AssociatedIdentity 文字列識別子に関連付けられたすべてのデバイスを検出します。DeviceTracking オブジェクトを返します。

• FindDeviceByDeviceAndAppIds— 指定されたデバイス・トークンと AppId を持つすべてのデバイスを検出します。DeviceTracking オブジェクトを返します。

Identity Manager を使用した通知のプッシュ送信

Identity Manager は NotificationByIdentityRequest メッセージを受信すると、以下の処理を実行します。

1. Identity Manager は SQL テーブルに対してクエリを発行して、メッセージ内の AssociatedIdentity に関連付けられたデバイスを検出します。

2. このクエリによって 1 台以上のデバイスが返された場合は、このクエリによって返されたレコードごとに 1 つの NotificationMessage が作成されます。この NotificationMessage 内では、次の処理が実行されます。

   • NotificationInfo が受信 NotationByIdentityRequest 内の NotificationInfo に設定されます。

   • Identities がレコード内のデバイス・トークンに設定されます。

   • AppId がレコード内の AppID (これが設定されている場合) に設定されます。

   • Service がレコード内の Service に設定されます。

3. 各メッセージがターゲット・コンポーネントに送信されます。

AppService を使用した通知のプッシュ送信

Ensemble プロダクション環境外の ObjectScript でプッシュ通知を生成する場合は、プッシュ通知 AppService を使用して通知を Ensemble 環境に送り込むことができます。この AppService は Ensemble へのゲートウェイの役割を果たします。この AppService を呼び出すには、以下の手順を実行します。

1. AppService を Ensemble プロダクションに追加します。

2. ターゲットがメッセージを IdentityManager、ルータ、または直接プッシュ通知オペレーションに送信するように構成します。

3. コード内で、EnsLib.PushNotifications.NotificationRequestOpens in a new tab メッセージを作成してその内容を入力します。

4. NotificationRequest をパラメータとして渡して、AppService の SendSync メソッドを呼び出します。