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

Google Play ゲームサービスで Android ゲームを開発しましょう。

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

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

始める前に

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

アプリの前提条件

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

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

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

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

アプリを構成する

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

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

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

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

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

サンプルアプリのガイド

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

ステップ 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 ゲームサービスを管理し、ゲームの認可と認証のためのメタデータを構成します。

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 の [Generate Signed APK] ウィザードを使用して生成できます。署名済み APK の生成ウィザードを実行する方法については、Android Studio でアプリに署名するをご覧ください。
  4. 後で使用できるように、次の情報を必ず記録してください。
    1. アプリケーション ID: クライアント ID の先頭の数字（通常は 12 桁以上）のみで構成される文字列です。
    2. 署名証明書: API アクセスの設定時に使用した証明書（SHA1 フィンガープリントを指定した証明書）。アプリのテストやリリースを行う際には、同じ証明書を使用してアプリに署名する必要があります。
  5. Type-a-Number チャレンジの実績を構成します。
    1. Google Play Console で [実績] タブを選択します。
    2. 次の実績を追加します。
      氏名 説明 特記事項
      プライム 素数であるスコアを取得します。 なし
      謙虚 スコア 0 をリクエストします。 なし
      お子様に気を配らないでください どちらのモードでも 9999 のスコアをリクエストします。 なし
      OMG U R TEH UBER LEET！ 1337 点を獲得 これを非公開の実績にします。
      退屈だった ゲームを 10 回プレイします。 これは 10 ステップの増分実績です。
      本当に退屈 ゲームを 100 回プレイします。 これは 100 ステップの増分実績です。
    3. 作成した各実績の ID（長い英数字の文字列）を記録します。
    4. ゲームに適した実績を構成します。詳しくは、実績の背後にあるコンセプトと Android に実績を実装する方法をご覧ください。
  6. Type-a-Number チャレンジでリーダーボードを設定します。
    1. Google Play Console で [リーダーボード] タブを選択します。
    2. 「Easy High Scores」と「Hard High Scores」という 2 つのサンプル リーダーボードを追加します。どちらのリーダーボードも、小数点以下 0 桁と、順序タイプ [Larger better] の整数スコア形式を使用する必要があります。
    3. 作成したリーダーボードごとに ID（英数字の長い文字列）を記録します。
    4. ゲームに適したリーダーボードを設定します。詳しくは、リーダーボードの概念と Android でリーダーボードを実装する方法をご覧ください。
  7. ゲームのテスト アカウントを追加します。 この手順は、Google Play Console でまだ公開されていないアプリにのみ必要です。アプリを公開する前にログインできるのは、Google Play Console に表示されているテスト アカウントのみです。ただし、アプリが公開されると、誰でもログインできます。

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

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

  1. res/values/ids.xml を開き、プレースホルダ ID を置き換えます。Android ゲームをゼロから作成する場合は、最初にこのファイルを作成する必要があります。
    1. app_id リソースでアプリケーション ID を指定します。
    2. 対応する achievement_* リソースで、以前に作成した各実績 ID を指定します。
    3. 対応する leaderboard_* リソース内で、以前作成した各リーダーボード ID を指定します。
  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 ゲームサービスをゲームで正しく機能させるには、アプリを Google Play で公開する前にテストします。

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

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