管理者メッセージの受信

プッシュ通知の受信方法は、プッシュ通知の実現方法によって実装が異なります。ここでは、WebSocket 上の MQTT を使ってプッシュ通知を受け取る方法を示します。Cordova アプリでプッシュ通知を受け取る場合は、phonegap-plugin-push を参考に実装してください。

プッシュ通知は、外部ライブラリーを経由して、MQTT の PUBLISH コマンドを処理することで受信できます。PUBLISH コマンドのペイロードには、開発者ポータルで指定したカスタムフィールドを含む JSON 文字列が渡されます。

ペイロードに含まれるパラメーターの詳細は、Kii Cloud SDK for Android の KiiPushSubscription の情報を参考にしてください。

MQTT トピック

PUBLISH コマンドは様々な目的で受信するため、サーバー側からの PUBLISH コマンドを受け取った際には、必ず MQTT トピック名をチェックするように実装してください。また、未知の MQTT トピック名を持つ PUBLISH コマンドは、将来の拡張のため無視するように実装してください。

プッシュ通知で受け取る MQTT トピック名は、初期化の際に SUBSCRIBE コマンドで講読した MQTT トピックの名前です。チュートリアル の実装も参考にしてください。

プッシュメッセージの例

以下は、プッシュメッセージを受け取ったときのペイロードを整形した例です。ここでは、開発者ポータルで mymessage = Hello を指定した場合を想定しています。

{
  "sourceURI":"kiicloud://users/727f20b00022-8d18-5e11-991f-06db2509",
  "mymessage":"Hello",
  "senderURI":"kiicloud://admins/APP_ADMIN"
}