- この記事は、Google Playゲームサービスに関する記事を和訳したものです。
- 原文: Get Started with Play Games Services for Android
- 元記事のライセンスは CC-BYで、この和訳記事のライセンスは CC-BYです。
- 自己責任でご利用ください。
- 和訳した時期は 2019年7月ころです。
Google Playゲームサービスを用いた Androidゲーム開発へようこそ!
Play Game SDKは、実績、リーダーボード、セーブドゲーム、リアルタイム型マルチプレイヤー(Android上で)といった人気のあるゲームの機能を、あなたのタブレットやモバイルのゲームに簡単に統合させる、クロスプラットフォームの Google Playゲームサービスを提供します。
このトレーニングは、Androidのサンプルゲームアプリケーションをインストールするし、すぐに独自の Androidゲームを作成できるよう案内するでしょう。 The Type-a-Number Challengeサンプルアプリは、あなたがどのように実績とリーダーボードをあなたのゲームに統合するのかをデモンストレーションします。
始める前に
- Android開発環境をセットアップします。 もし Androidアプリケーションの開発に慣れていなければ、Building Your First Appを参照してください。
- Android 4.0 (Ice Cream Sandwich) あるいはそれ以上を実行している Android端末を、テスト用に所有している必要があります。
Step 1: サンプルアプリをダウンロードする
この開発者ガイドでは、Type-a-Number Challengeというサンプルの Androidアプリケーションをダウンロードする必要があるでしょう。
Android Studioにてサンプルアプリケーションをダウンロードし、セットアップするには:
- samples download pageから Androidのサンプルをダウンロードします。
-
android-basic-samples
プロジェクトをインポートします。 このプロジェクトは、TypeANumber
や他の Androidゲームのサンプルを含んでいます。 Android Studioにてこれを行うには:- File > Import Projectをクリックします。
-
あなたの開発マシン上の
android-basic-samples
をダウンロードしたディレクトリに移動します。android-basic-samples/build.gradle
というファイルを選択し、OKをクリックします。
-
TypeANumber
モジュールにてAndroidManifest.xml
を開き、パッケージ名をcom.google.example.games.tanc
から独自の異なるパッケージ名に変更します。 新しいパッケージ名は、com.google
、com.example
、あるいはcom.android
で始めてはなりません。
Step 2: Google Play Consoleにてゲームをセットアップする
Google Playの Google Play Consoleは、あなたのゲームのための Google Playゲームサービスを管理し、あなたのゲームを認可し、認証するためのメタデータを設定する場所です。
Google Play Consoleにてサンプルゲームをセットアップするには:
- あなたのウェブブラウザをGoogle Play Consoleにポイントし、サインインします。 もし以前に Google Play Consoleに登録していなければ、そうするよう促されます。
-
あなたのゲームを Google Play Consoleに追加するには、以下の手順に従ってください。
- あなたのアプリで Google APIを使用しているかどうか尋ねられたとき、I don’t use any Google APIs in my game yetを選択します。
- 開発者ガイドの目的のため、独自のゲームの詳細を用いてフォームを満たすことができます。 便利が良いように、ダウンロードページにて提供されるプレイスホルダーのアイコンとスクリーンショットを使用することができます。
-
あなたの Androidアプリ用の OAuth 2.0 クライアント IDを生成するために、以下の手順に従ってください。
- あなたの Androidアプリをリンクするとき、以前にサンプルパッケージをリネームしたときに使用した正確なパッケージ名を指定してください。
- もしまだそれを持っていなければ、新しいキーストアと署名された証明書を生成するために、Android Studioにて Generate Signed APK Wizardを使用することができます。 Generate Signed APK Wizardを実行する方法については、Signing Your App in Android Studioを参照してください。
-
後のために以下の情報を記録するようにしてください:
- あなたのアプリケーション ID: これは、あなたのクライアント IDの先頭にある、数字のみ(一般的には12桁以上)で構成される文字列です。
- あなたの署名した証明書: あなたの APIアクセスをセットアップするときにどの証明書を使用したか注意してください(あなたが提供した SHA1フィンガープリントを持つ証明書)。 あなたのアプリをテストあるいはリリースするとき、あなたのアプリを署名するために、同じ証明書を使用する必要があります。
-
Type-a-Number Challengeの実績を構成します:
- Google Play Consoleにて Achievementsタブを選択します。
-
次のサンプルの実績を追加します:
名前 説明 特記事項 Prime 素数のスコアを取得した。 None Humble スコア 0をリクエストした。 None Don't get cocky, kid いずれかのモードでスコア 9999をリクエストした。 None OMG U R TEH UBER LEET! スコア 1337を受信した。 これを非表示の実績とします。 Bored ゲームを 10回プレイした。 これを、アンロックするために 10ステップを伴う増分実績とします。 Really Really Bored ゲームを 100回プレイした。 これを、アンロックするために 100ステップを伴う増分実績とします。 - 作成したそれぞれの実績 ID(長い英数字の文字列)を記録します。
- あなたのゲームに適した実績を構成します。 詳細については、実績の背後にあるコンセプトおよび Androidにて実績を実装する方法を参照してください。
-
Type-a-Number Challengeのリーダーボードを構成します:
- Google Play Consoleの Leaderboardsタブを選択します。
- 2つのサンプルのリーダーボードを追加します: ひとつは “Easy High Scores” と命名され、もう一方は “Hard High Scores” と命名されます。 両方のリーダーボードは、小数点以下の桁数を 0の形式とした整数型のスコアと、Larger is betterのオーダー型を使用する必要があります。
- 作成したそれぞれのリーダーボード ID(長い英数字の文字列)を記録します。
- あなたのゲームに適したリーダーボードを構成します。 詳細については、リーダーボードの背後にあるコンセプトとAndroidにてリーダーボードを実装する方法を参照してください。
- あなたのゲーム用にテストアカウントを追加します。 このステップは、Google Play Consoleにて公開されていないアプリのためにのみ必要とされます。 アプリを公開する前は、Google Play Consoleにリストされたアカウントのみがログインできます。 しかしながら、ひとたびアプリケーションが公開されたならば、誰もがログインを許可されます。
Step 3: あなたのコードを修正する
ゲームを実行するには、あなたの Androidプロジェクトにてリソースとしてアプリケーション IDを構成する必要があります。
さらには、AndroidManifest.xml
にゲームのメタデータを追加する必要もあるでしょう。
-
res/values/ids.xml
を開き、プレイスホルダー IDを置換します。 もし一から Androidゲームを作成するならば、このファイルを最初に作成する必要があるでしょう。-
あなたのアプリケーション IDを
app_id
リソースに指定します。 -
以前に
achievement_*
リソースにて作成したそれぞれの実績 IDを指定します。 -
以前に
leaderboard_*
リソースにて作成したそれぞれのリーダーボード IDを指定します。
-
あなたのアプリケーション IDを
-
AndroidManifest.xml
を開き、<manifest
>要素のpackage
属性にあなたのパッケージ名を入力します。 もし一から Androidゲームを作成しているならば、さらに <application
>要素に次のコードを追加することも確認してください:<meta-data android:name="com.google.android.gms.games.APP_ID" android:value="@string/app_id" /> <meta-data android:name="com.google.android.gms.version" android:value="@integer/google_play_services_version"/>
Step 4: あなたのゲームをテストする
Google Playゲームサービスがあなたのゲームで正しく機能していることを確認するために、Google Play上に公開する前にアプリケーションをテストします。
あなたの物理的なテスト端末上でゲームを実行するには:
- アプリにログインするために使用しているテストアカウントをセットアップしたことを確認します(Step 2で記述したように)。
- APKをエクスポートし、Google Play Consoleにてプロジェクトをセットアップするために使用したものと同じ証明書を用いて、それを署名します。 Android Studioにて署名された APKをエクスポートするには、Build > Generate Signed APKをクリックします。
-
adb
ツールを使用することによって、あなたの物理的なテスト端末上に署名された APKをインストールします。 アプリケーションをインストールする方法の詳細については、Running on a Deviceを参照してください。