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

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()
    }
  }

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

  dependencies {
    implementation 'com.google.android.gms:play-services-games:23.2.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 チャレンジの実績を設定します。
    1. Google Play Console で [実績] タブを選択します。
    2. 以下のサンプル実績を追加します。
      名前 説明 特別な手順
      プライム 素数で表されるスコアを取得します。 まったく管理できない
      謙虚 スコア 0 をリクエストします。 まったく管理できない
      落ち込まないで どちらのモードでも 9,999 のスコアをリクエストします。 まったく管理できない
      オマエタチ バチカン！ スコア 1337 を獲得します。 隠しの実績として設定します。
      退屈 ゲームを 10 回プレイします。 10 ステップで達成できる増分実績として設定します。
      本当につまらない ゲームを 100 回プレイします。 100 歩で達成できる増分実績として設定します。
    3. 作成した各実績の ID（長い英数字の文字列）を記録します。
    4. ゲームに適した実績を設定する。詳しくは、実績の背後にあるコンセプトと Android で実績を実装する方法をご覧ください。
  6. Type-a-Number チャレンジのリーダーボードを設定します。
    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 に表示されているテスト アカウントのみです。ただし、アプリが公開されると、すべてのユーザーがログインできるようになります。

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

ゲームを実行するには、アプリケーション ID を Android プロジェクトのリソースとして構成する必要があります。また、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 に公開する前にテストします。

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

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