Android 向け Play ゲームサービスのスタートガイド

注意: このガイドは、Play Games サービス v1 SDK の使用を対象としています。最新の SDK については、Play Games サービス v2 のドキュメントをご覧ください。

ここでは、Google Play Games サービスを使用した Android ゲーム開発について説明します。

Play Games SDK は、タブレットやモバイルゲームに実績、リーダーボード、保存済みゲームなどの人気のゲーム機能を簡単に統合できる、クロス プラットフォームの Google Play Games サービスを提供します。

このトレーニングでは、Android 用のサンプル ゲームアプリをインストールし、独自の Android ゲームの作成をすぐに始める方法について説明します。Type-a-Number Challenge サンプルアプリは、実績とリーダーボードをゲームに統合する方法を示しています。

始める前に

アプリを準備するには、以下のセクションに示す手順を完了します。

アプリの前提条件

アプリのビルドファイルで次の値が使用されていることを確認します。

• minSdkVersion が 19 以上
• compileSdkVersion が 28 以上

Google Play Console でゲームを設定する

Google Play Console では、各ゲーム用に Google Play Games サービスを管理し、ゲームの認可と認証のためのメタデータを構成します。詳細については、Google Play Games サービスのセットアップをご覧ください。

アプリを設定する

プロジェクト レベルの build.gradle ファイルで、buildscript セクションと allprojects セクションの両方に Google の Maven リポジトリと Maven セントラル リポジトリを含めます。

  buildscript {
    repositories {
      google()
      mavenCentral()
    }
  }

  allprojects {
    repositories {
      google()
      mavenCentral()
    }
  }

モジュールの Gradle ビルドファイル（通常は app/build.gradle）に Play Games SDK の Google Play 開発者サービスの依存関係を追加します。

  dependencies {
    implementation 'com.google.android.gms:play-services-games:23.1.0'
  }

サンプルアプリのガイド

このトレーニングでは、Android 用のサンプル ゲームアプリをインストールし、独自の Android ゲームの作成をすぐに開始する方法について説明します。Type-a-Number Challenge サンプルアプリは、実績とリーダーボードをゲームに統合する方法を示しています。

ステップ 1: サンプルアプリをダウンロードする

このデベロッパー ガイドでは、Type-a-Number Challenge のサンプル Android アプリをダウンロードする必要があります。

Android Studio でサンプルアプリをダウンロードしてセットアップするには:

1. Android のサンプルは、サンプル ダウンロード ページからダウンロードしてください。
2. android-basic-samples プロジェクトをインポートします。このプロジェクトには、TypeANumber とその他の Android ゲームサンプルが含まれています。Android Studio でこれを行う手順は次のとおりです。
   1. [File] > [Import Project] をクリックします。
   2. 開発マシンで android-basic-samples をダウンロードしたディレクトリを参照します。android-basic-samples/build.gradle ファイルを選択し、[OK] をクリックします。
3. TypeANumber モジュールで AndroidManifest.xml を開き、パッケージ名を com.google.example.games.tanc から別の独自のパッケージ名に変更します。新しいパッケージ名を com.google、com.example、com.android で始めることはできません。

ステップ 2: Google Play Console でゲームをセットアップする

Google Play Console では、ゲームの Google Play Games サービスを管理し、ゲームの認可と認証のためのメタデータを構成します。

Google Play Console でサンプルゲームをセットアップするには:

1. ウェブブラウザで Google Play Console にアクセスしてログインします。これまでに Google Play Console に登録していない場合は、登録するよう求めるメッセージが表示されます。
2. 次の手順に沿って Google Play Console にゲームを追加します。
   1. アプリで Google API を使用するかどうかを尋ねられたら、[ゲームで Google API をまだ使用していません] を選択します。
   2. このデベロッパー ガイドでは、フォームに独自のゲームの詳細を記入します。利便性を考慮して、ダウンロード ページで提供されているプレースホルダ アイコンとスクリーンショットを使用できます。
3. 次の手順に沿って、Android アプリ用に OAuth 2.0 クライアント ID を生成します。
   1. Android アプリをリンクする場合は、サンプル パッケージの名前を変更するときに、以前に使用したものと同じパッケージ名を指定してください。
   2. 新しいキーストアと署名済み証明書がない場合は、Android Studio の署名付き APK の生成ウィザードを使用して生成できます。署名付き APK 生成ウィザードの実行方法については、Android Studio でアプリに署名するをご覧ください。
4. 後で使用できるように、次の情報を記録します。
   1. アプリケーション ID: クライアント ID の先頭にある、数字（通常は 12 桁以上）のみで構成される文字列です。
   2. 署名証明書: API アクセスの設定時に使用した証明書（SHA1 フィンガープリントを指定した証明書）をメモします。アプリのテストやリリースを行う際は、同じ証明書を使用してアプリに署名する必要があります。
5. Type-a-Number Challenge の実績を設定します。
   1. Google Play Console で [実績] タブを選択します。
   2. 次のようなサンプルの実績を追加します。

      Name	説明	特別な手順
      プライム	素数のスコアを出す。	なし
      謙虚	スコア 0 をリクエストします。	なし
      調子はどう？	どちらのモードでも 9999 のスコアをリクエストします。	なし
      オマエタチ オマエタチ！	スコアは 1337 点です。	非公開の実績に設定します。
      つまらない	ゲームを 10 回プレイします。	10 ステップで達成できる増分実績にします。
      本当につまらない	ゲームを 100 回プレイします。	100 歩達成できる増分実績にします。

   3. 作成した各実績の ID（長い英数字の文字列）を記録します。
   4. ゲームに適した実績を設定します。詳しくは、実績の背後にあるコンセプトと Android で実績を実装する方法をご覧ください。
6. Type-a-Number Challenge のリーダーボードを構成します。
   1. Google Play Console で [リーダーボード] タブを選択します。
   2. サンプル リーダーボードを 2 つ追加します。1 つは「Easy High Scores」、もう 1 つは「Hard High Scores」という名前です。どちらのリーダーボードも、小数点以下が 0 の整数のスコア形式を使用し、順序付けタイプを [大きいほど良い] にします。
   3. 作成した各リーダーボードの ID（長い英数字の文字列）を記録します。
   4. ゲームに適したリーダーボードを構成します。詳しくは、リーダーボードのコンセプトと Android でリーダーボードを実装する方法をご覧ください。
7. ゲームのテスト アカウントを追加します。この手順は、Google Play Console でまだ公開されていないアプリの場合にのみ必要です。アプリの公開前は、Google Play Console に登録されているテスト アカウントのみがログインできます。ただし、アプリが公開されると、すべてのユーザーがログインできるようになります。

警告: テスト アカウントとしてリストされていないアカウントを使用して未公開のゲームに対する Play Games SDK の呼び出しを行おうとすると、Google Play Games サービスはゲームが存在しないかのように動作し、ConnectionResult.SIGN_IN_REQUIRED 戻りコードを返します。ConnectionResult.startResolutionForResult() を起動しようとすると、GamesActivityResultCodes.RESULT_SIGN_IN_FAILED が返されます。

ステップ 3: コードを変更する

ゲームを実行するには、Android プロジェクトのリソースとしてアプリケーション ID を構成する必要があります。また、AndroidManifest.xml にゲームのメタデータを追加する必要もあります。

1. res/values/ids.xml を開き、プレースホルダ ID を置き換えます。Android ゲームをゼロから作成する場合は、まずこのファイルを作成する必要があります。
   1. app_id リソースでアプリケーション ID を指定します。
   2. 先ほど作成した各実績 ID を、対応する achievement_* リソースに指定します。
   3. 先ほど作成した各リーダーボード ID を、対応する leaderboard_* リソースに指定します。
2. 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"/>
   

ステップ 4: ゲームをテストする

ゲーム内で Google Play Games サービスが正しく機能していることを確認するには、Google Play で公開する前にアプリをテストします。

注: 実際の Android デバイスでテストすることをおすすめします。実機がない場合は、Android Emulator を使用してテストできます。そのためには、Google Play 開発者サービスを含むエミュレータのシステム イメージを、Android 4.2.2 で SDK Manager からダウンロードします。

物理的なテストデバイスでゲームを実行するには:

1. アプリへのログインに使用するテスト アカウントを設定していることを確認します（ステップ 2 を参照）。
2. APK をエクスポートし、Google Play Console でプロジェクトを設定したときに使用した証明書と同じ証明書で署名します。署名付き APK を Android Studio でエクスポートするには、[Build] > [Generate Signed APK] をクリックします。
3. adb ツールを使用して、署名済み APK を実機のテストデバイスにインストールします。アプリをインストールする方法については、デバイスで実行するをご覧ください。

警告: Android Studio から直接アプリを実行すると、Android Studio はデフォルトでデバッグ証明書を使用してアプリに署名します。Google Play Console でアプリを設定する際にこのデバッグ証明書を使用しなかった場合は、エラーが発生します。Google Play Console でアプリを設定したときに使用した証明書のいずれかと一致する証明書で署名し、エクスポートした APK を実行するようにしてください。