ページの先頭行へ戻る
Interstage Mobile Application Server V1.3.0 アプリケーション開発ガイド
FUJITSU Software

6.5.1 ハイブリッドアプリケーション向けのAPIの開発

ハイブリッドアプリケーション向けのAPIはJavaScriptで提供します。

1.マニフェストファイルの修正と、プッシュクライアント設定ファイルの設定

以下を行います。

保管先
<Cordovaプロジェクトのルート>/plugins/imaps-plugin-push-properties

ファイル

  • IMAPSプッシュ/GCM用:push.properties
  • APNs用:push.plist
  • WNS用:push.xml

2.プッシュハンドラ初期化処理の作成

FJPHandler.initメソッドを呼び出すと初期化され、メッセージの受信を開始します。
以下に使用例を示します。
var jsonText = '{"ext_data":"Extension String"}';
FJPHandler.init("FJ", // プッシュの種類を指定 FJ:IMAPSプッシュ
    JSON.parse(jsonText ), // 初期化時に使用する値を設定。
    function(result) {
        // プッシュを受信可能な状態になった後の処理
    },
    function(result) {
        // エラー発生時のコールバック
    }
);
各プッシュ方式固有の動作、設定は次のとおりです。
観点 IMAPSプッシュ
(Android)
GCM
(Android)
APNs
(iOS)
WNS
(Windows)
init()のoptionsに渡す情報 拡張データ 拡張データ
SENDER_ID(注1)
拡張データ 拡張データ
setNotification Mode() 動作する 一部動作する
(Android4.1以降は端末の通知設定が優先)
動作しない
(端末設定の「通知センター」で設定)
動作する
プッシュを利用するための事前設定 AndroidManifest.xmlに、ネイティブAPIと同様の記述が必要(注2) AndroidManifest.xmlに、ネイティブAPIと同様の記述が必要(注3) ネイティブ層の修正が必要 Package.appxmanifestに機能の追加が必要
errorCallback IMAPSサーバとの通信エラーが返される IMAPSサーバとの通信エラーが返される JavaScript層にエラーを返せないので、ネイティブ層の作り込みが必須(注4) IMAPSサーバとの通信エラーが返される
注1)GCMプッシュの際のSENDER IDです。6.4.2 クライアント側のAPIのAPIのGcmRegister.register()に渡すものと同じです。 以下のように指定します。
JSON{"sender_id":"(GCMの開発者コンソールから入手したSENDER IDの値)"}

注2)"IMAPSプッシュ通知を利用するネイティブアプリケーションの開発"1.マニフェストファイルの修正を参照してください。
注3)"GCMプッシュ通知を利用するネイティブアプリケーションの開発"1. マニフェストファイルの修正を参照してください。
注4)iOSの場合、デバイストークン生成時のエラーやIMAPSサーバとの通信エラーは、FJPAppDelegateを継承したサブクラスの[UIAppliationDelegate application:didFailToRegisterForRemoteNotificationWithError:]にコールバックされるため、このインタフェースをオーバライドしてエラー処理の実装が必要です。
ハイブリッドアプリケーションでログ出力を行う場合、6.5.6 ログ出力のカスタマイズを参照してください。
認証の設定は、6.5.7 認証クラスの定義を参照してください。
拡張データを指定する場合は、6.5.8 拡張データの指定を参照してください。
既読通知機能の利用を行う場合、6.5.13 既読通知機能の利用を参照してください。
受信したメッセージ情報を受け取る場合、ネイティブ層の実装が必要です。6.5.9 IMAPSプッシュの処理結果受け取り6.5.10 GCMプッシュの処理結果受け取り6.5.11 APNsプッシュの処理結果受け取り6.5.12 WNSプッシュの処理結果受け取りを参照してください。

注意

ダウンロード方法により読み込み専用ファイルとなる場合があります。プロジェクト読み込み時にファイルの書き込み権限が必要となるので、その際は権限の付与など必要な対処をしてください。