Google Play Game Servicesに自分のアプリを対応する

今年に入って、Googleが、ゲームのランキングや達成（アチーブメント）などを管理するAPIを公開してくださったようです。

Google Play Game Services - Take your games to the next level
https://developers.google.com/games/services/

嬉しいっ！

過去にも（今でも）こんなサービスやってる会社がいくつかありましたが、どっかに統合されたり、広告が出たりいろいろ問題ありました。

天下のGoogleが無料でこれを公開してくれれば鬼に金棒です。


そういうわけで、早速組み込みを行いました。



「論よりRUN（プログラムを実行）」といいます。（・・と最近は言いませんが）
まずはサンプルの実行です。
https://developers.google.com/games/services/android/quickstart

これは、それほど問題もなくできました。
基本的に英語力だけはそれなりに求められますが、最近は日本語の情報もあちこちあるので、そちらに譲るとします。

でも、、、

これを自分のアプリケーションに組み込むとなると、話は別でした。
Google Play Game Servicesに、自分のアプリケーションを対応させるのは、私はそれなりに苦労しました。


基本的なやりかたは、以下の通りなんです。

組み込み手順（英語）
Initializing Your Games Client in Android
https://developers.google.com/games/services/android/init


で、この通りやったのですが、なかなかうまくいきません。

自分のアプリの MainActivity.java の継承元クラスをActivity から BaseGameActivityクラスに変更するだけで、アプリの起動ができなくなってしまいます。

私は少しずつ修正して問題ないのを確認しながら進めていくタイプなので、ここで止まっていたのですが、他の設定を行わなければ起動できないという状況は改善されないことが、あとになってわかりました。

私の場合は、Google Play Game Services をEclipseにインストールした際、各種ライブラリがアップグレードされ、既存アプリのライブラリのバージョンの不一致による問題と、xmlファイルの設定不足が足かせだったみたいです。


私と同じようにうまくいかない方は、以下を参考に、ひとつずつ確認してみることをオススメします。
ほとんど自分用のメモですが、参考になれば幸いです。


■ビルドパスの調整
Eclipse パッケージエクスプローラで、自分のアプリのプロジェクトを
右クリック - プロパティ - Android
画面下部の「ライブラリ」に　google-play-services、　BaseGameUtils 　を追加
（Is Libraryにチェックをつけない）


■MainActivity.java に importを追加

import com.google.example.games.basegameutils.BaseGameActivity;


■MainActivity　に、参照するクラスを追加

// 継承クラスを変更
before : public class MainActivity extends Activity
after  : public class MainActivity extends BaseGameActivity {


■必須メソッドの自動生成

1. @Override
3. public void onSignInFailed() {
5. // TODO Auto-generated method stub
9. }
11. @Override
13. public void onSignInSucceeded() {
15. // TODO Auto-generated method stub
19. }

■以下メソッドも追加

1. // サインインチェック処理
3. protected boolean isSignedIn() {
5. return mHelper.isSignedIn();
7. }
9. // googleサインインボタン押下時
11. @Override
13. public void onSignInButtonClicked() {
15. // start the sign-in flow
17. beginUserInitiatedSignIn(); // サイン・イン
19. }
21. // googleサインアウトボタン押下時
23. @Override
25. public void onSignOutButtonClicked() {
27. signOut(); // サインアウト
29. }
32. // ゲームクライアント取得
34. protected GamesClient getGamesClient() {
36. return mHelper.getGamesClient();
38. }
40. // 順位表示ボタン押下時処理
42. @Override
44. public void onShowLeaderboardsRequested() {
46. if (isSignedIn()) {
48. startActivityForResult(getGamesClient().getAllLeaderboardsIntent(), RC_UNUSED);
50. } else {
52. showAlert(getString(R.string.leaderboards_not_available));
54. }
56. }
58. // 達成度表示ボタン押下時処理
60. @Override
62. public void onShowAchievementsRequested() {
64. if (isSignedIn()) {
66. startActivityForResult(getGamesClient().getAchievementsIntent(), RC_UNUSED);
68. } else {
70. showAlert(getString(R.string.achievements_not_available));
72. }
74. }

■AndroidManifest.xml の修正

　application セクション内
        <meta-data android:name="com.google.android.gms.games.APP_ID"
            android:value="@string/app_id" />


■ids.xml を記載（そういえば、私はこのファイルを今回初めて作りました）

app_id(Developer Consoleで確認） を、ids.xml に記載します。
その他、必要な値を設定します。
TypeANumberをコピーしてきて修正するのがオススメです。

　values\ids.xml　を準備
    <string name="app_id">789779522XXX</string>


■android-support-v4.jar の最新化
既存のアプリに Google Play Game Services を組み込む場合、ライブラリのバージョンが上がっている場合があります。
その場合、ライブラリを新しくする必要があります。
私の場合、android-support-v4.jar が新しくなっていたので上書きコピー。

■レイアウトにログイン・ログアウトボタンを追加
これも TypeANumberを参考にするのがオススメです。
<!-- sign-in button -->
<com.google.android.gms.common.SignInButton
    android:id="@+id/sign_in_button"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content" />
<!-- sign-out button -->
<Button
    android:id="@+id/sign_out_button"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text="Sign Out"
    android:visibility="gone" />   

■■■
ここまでで、ビルド・実行して、今までの処理が問題なく動くことを確認します。
動いたら、Developer Console の ゲームサービスから、自分のアプリを登録します。
登録の手順は、やっぱり TypeANumberを参考に。

そして、ようやくメインの処理の追記に入ります。

■スコア送信処理の追加
myLeaderBoard_ID : Developer Console の ゲームサービスで登録したときに取得したリーダーボードのID
myScore : 送信したい点数

1. if (isSignedIn()) {
3. getGamesClient().submitScore(myLeaderBoard_ID), myScore);
5. }

■リーダーズボードの表示処理

1. if (isSignedIn()) {
3. startActivityForResult(getGamesClient().getAllLeaderboardsIntent(), RC_UNUSED);
5. }

健闘を祈ります！


蛇足ですが、

私の場合は、project.propertiesも調整しました。手動編集しちゃいけないっぽかったですが、TypeANumberが動いたときの設定と比較した結果、差異があったので、直しちゃいました。

【修正前】
android.library.reference.1=../google-play-services_lib
android.library.reference.2=../BaseGameUtils

【修正後】
android.library.reference.1=../google-play-services_lib
android.library.reference.2=..\\BaseGameUtils