注) GoogleCloudMessaging.register()に渡すSENDER_IDは、作成したプロジェクトの「Project Number」を指定します。
詳細は、Google Developers Consoleを参照してください。
GCMプッシュ通知を利用するネイティブアプリケーション向けのAPIはJavaで提供します。IMAPSプッシュ通知を利用するネイティブアプリケーション向けのAPIと同様に準備します。
android.permission.ACCESS_WIFI_STATE
android.permission.READ_PHONE_STATE
注意
インストール先の端末がAndroid6.0以上の場合、パーミッションの確認が必要です。詳細は3.3.7 パーミッションを参照してください。<permission android:name="[package].permission.C2D_MESSAGE"android:protectionLevel="signature" />
<uses-permission android:name="[package].permission.C2D_MESSAGE" />
<uses-permission android:name="com.google.android.c2dm.permission.RECEIVE" />
<uses-permission android:name="android.permission.WAKE_LOCK"/>
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.GET_ACCOUNTS"/>
... <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /><uses-permission android:name="android.permission.READ_PHONE_STATE" /> <permission android:name="[package].permission.C2D_MESSAGE" android:protectionLevel="signature" /><uses-permission android:name="[package].permission.C2D_MESSAGE" /><uses-permission android:name="com.google.android.c2dm.permission.RECEIVE" /><uses-permission android:name="android.permission.WAKE_LOCK" /><uses-permission android:name="android.permission.INTERNET" /><uses-permission android:name="android.permission.GET_ACCOUNTS" /> <application ...> ... <receiver android:name="com.fujitsu.imaps.push.gcm.GcmBroadcastReceiver" android:permission="com.google.android.c2dm.permission.SEND" > <intent-filter> <action android:name="com.google.android.c2dm.intent.RECEIVE" /> <category android:name="[packge]" /> </intent-filter> </receiver> <meta-data android:name="com.google.android.gms.version" android:value="@integer/google_play_services_version" /> <service android:name="com.fujitsu.imaps.push.gcm.GcmIntentService" /> </application> ...
プッシュハンドラに渡すパラメータを、プッシュクライアント設定ファイル(push.properties)に設定します。プッシュクライアント設定ファイルについては、付録D プッシュクライアント設定ファイルを参照してください。
プッシュクライアント設定ファイル情報は、プッシュハンドラを利用する前に設定します。
// プッシュサーバとの接続先をプッシュクライアント設定ファイルに設定する push.ServerAddress=https://example.com/push/ push.SelfCertificate = true push.gcm.SenderID=1234567890 // SENDER_IDは、Googleの開発者向けのWebサイトで入手
// com.fujitsu.imaps.push.gcm.GcmRegisterによるプッシュハンドラの初期化 GcmRegister gcm = GcmRegister.getInstance(Activity.this); gcm.register();
GCMプッシュ通知を受信するためには、Google Play開発者サービス(4.4.52以降)が必要です。Google Play開発者サービスがインストールされていない場合、プッシュハンドラ初期化処理が失敗し、GCMのプッシュ通知を受信できません。Google Play開発者サービスはGoogle Playから入手できます。
注意
Google Play開発者サービスは、開発したアプリケーションを実行するAndroidへインストールする必要があります。
android {
・・・
defualtConfig {
applicationId 'com.sample.app'
}
}
注意
ビルドを行うGradle version によっては、上記設定が行われていない場合、プッシュクライアント設定ファイルの参照に失敗し、実行時にエラーとなる場合があります。ログ出力を行う場合、6.5.6 ログ出力のカスタマイズを参照してください。
認証の設定は、6.5.7 認証クラスの定義を参照してください。
拡張データを指定する場合は、6.5.8 拡張データの指定の指定を参照してください。
エラー通知受け取りを行う場合、6.5.10 GCMプッシュの処理結果受け取りを参照してください。
既読通知機能の利用を行う場合、6.5.13 既読通知機能の利用を参照してください。
参考
以下の方法で設定します。
手順1の設定に従い、GCMから取得したregistrationIDがIMAPSサーバに登録されます。
注意
push.ServerConnectRetryCountおよびpush.ServerConnectRetryWaitは開発中の動作確認用として提供しています。運用向け環境では指定しないでください。
注意
build.gradleのcompileSdkVersionに23を指定して、プッシュ通知のAPIの以下のメソッドを使用する場合、android {
.....
useLibrary 'org.apache.http.legacy' //この行を追加
.....
}