このページは Cloud Translation API によって翻訳されました。

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

Google Play Games サービスを使った Android ゲーム開発にようこそ。

Play Games SDK は、クロスプラットフォームの Google Play Games サービスを提供し、一般的なゲーム機能（実績、リーダーボード、タブレットやモバイルゲームの保存済みゲーム。

このトレーニングでは、Android 用のサンプルゲームアプリをインストールする方法を説明します。独自の Android ゲームの作成をすぐに始められます。Type-a-Number サンプルアプリで実績と目標を統合して、追加できます

始める前に

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

アプリの前提条件

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

minSdkVersion が 19 以上
compileSdkVersion が 28 以上

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

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

アプリを設定する

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

  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 サンプルアプリで実績と目標を統合して、追加できます

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

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

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

Android のサンプルをサンプルのダウンロードページ
android-basic-samples プロジェクトをインポートします。このプロジェクトには、TypeANumber と他の Android ゲームが含まれています提供しますAndroid Studio でこれを行う手順は次のとおりです。 <ph type="x-smartling-placeholder">
1. [ファイル] >プロジェクトをインポートする。
2. 開発用の android-basic-samples をダウンロードしたディレクトリに移動します。あります。android-basic-samples/build.gradle ファイルを選択して [OK] をクリックします。
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 でサンプルゲームをセットアップするには:

ウェブブラウザで Google Play Console ログインします。Google Play Console にまだ登録していない場合は、登録を求めるメッセージが表示されます。
以下の手順に沿って操作してください。 Google Play Console にゲームを追加します。
1. アプリで Google API を使用するかどうかを尋ねられたら、[ゲームで Google API をまだ使用していません] を選択します。
2. このデベロッパーガイドでは、このフォームにご自身のサービスアカウント ID をゲームの詳細。便宜上、プレースホルダのアイコンとスクリーンショットをダウンロードページから入手できます。
以下の手順に沿って操作してください。 OAuth 2.0 クライアント ID の生成確認しましょう <ph type="x-smartling-placeholder">
1. Android アプリをリンクする際は、パッケージを正確に指定してください以前にサンプルパッケージの名前を変更したときに使用した名前。
2. Android Studio の Generate Signed APK Wizard を使用して、次のことを行えます。新しいキーストアと署名済み証明書を生成します（まだ作成していない場合）。Google Chat で署名済み APK 生成ウィザードの実行方法については、 Android Studio でアプリに署名する
後で使用できるように、以下の情報を必ず記録してください。 <ph type="x-smartling-placeholder">
1. アプリケーション ID: 文字列。
2. 署名証明書: 設定時に使用した証明書をメモします。 API アクセス（指定した SHA1 フィンガープリントを使用する証明書）。マイページを使用する必要があります。。

Type-a-Number チャレンジの実績を設定: <ph type="x-smartling-placeholder">

Google Play Console で [実績] タブを選択します。

以下の実績のサンプルを追加します。

名前	説明	特別な手順
プライム	素数で表されるスコアを取得します。	なし
謙虚	スコア 0 をリクエストします。	なし
落ち込まないで	どちらのモードでも 9,999 のスコアをリクエストします。	なし
オマエタチバチカン！	スコア 1337 を獲得します。	隠しの実績として設定します。
退屈	ゲームを 10 回プレイします。	10 ステップで達成できる増分実績として設定します。
本当につまらない	ゲームを 100 回プレイします。	100 歩で達成できる増分実績として設定します。

修了した各実績の ID（長い英数字の文字列）を記録する作成されます。
ゲームに適した実績を設定する。詳しくは実績の背後にあるコンセプト Android で実績を実装する方法をご覧ください。

Type-a-Number チャレンジのリーダーボードを設定します。 <ph type="x-smartling-placeholder">
1. Google Play Console で [リーダーボード] タブを選択します。
2. 「Easy High Scores」ともう 1 つのリーダーボードを 2 つ追加します。ハードハイスコアですどちらのリーダーボードも、整数のスコア形式を使用する必要があります。（小数点は 0 桁で、順序タイプは [大きいほど良い] にします）。
3. 作成した各リーダーボードの ID（長い英数字の文字列）を記録します。
4. ゲームに適したリーダーボードを設定する。詳しくはリーダーボードの背後にあるコンセプトと Android でリーダーボードを実装する方法をご覧ください。
ゲームのテストアカウントを追加します。この手順は、Google Chat でまだ公開されていないアプリの場合にのみ必要です。ダウンロードしてくださいアプリが公開されるまでは、リストに表示されたテストアカウントだけがログインできます。ただしアプリケーションを公開するとできます。

で確認できます。

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

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

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

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

ログインに使用するテストアカウントが設定されていることを確認するをアプリに追加します（ステップ 2 を参照）。
APK をエクスポートして、セットアップに使用したのと同じ証明書で署名する Google Play Console でプロジェクトを作成します。Android Studio で署名付き APK をエクスポートするには、 [ビルド] >署名付き APK を生成する。
adb ツールを使用して、署名済みの APK を物理テストデバイスにインストールします。アプリケーションのインストール方法については、デバイスで実行する。