ラベル 翻訳 の投稿を表示しています。 すべての投稿を表示
ラベル 翻訳 の投稿を表示しています。 すべての投稿を表示

2014/06/22

Developing a Turn-based Multiplayer Game in Androidの翻訳(途中)

Google Play Game Services — Google Developers
の翻訳です。未完ですが、眠らせておくのももったいないので公開します。

 重要:Play Games services APIは、Google Play servicesのための簡略化したGoogle APIクライアントプログラミングモデルをサポートするように改訂されました。以前のGames clientは2014/02/07から非推奨になりました。既存または新規の開発者は 非推奨の GamesClient(リンクはない模様) に代わりに GoogleApiClientを使用することを強く推奨します。

このガイドは、Androidアプリにおける、Play Games services を使用したターンベースマルチプレイヤーゲームを実装する方法を示します。

はじめる前に

まだ(開発を)行っていない場合、turn-based multiplayer game concepts を見ると参考になるかもしれません。

ターンベースマルチプレイヤーゲームのコードを書く前に:
  • Google Play Developer Console内で、ゲームがターンベースのマルチプレイヤーサポートを有効になっていることを確認してください。
  • ダウンロードページより、ターンベースのマルチプレイヤーゲームのサンプルコードをダウンロードしレビューしてください。
  • ゲーム開発を簡単にするために、Accessing the Game APIsに説明しているように、メインゲームのActivityをBaseGameActivityクラスのサブクラスにすることができる。BaseGameActivityクラスはGoogleApiClient 接続とユーザーログインを操作するラッパーを提供しています。
  • Implementing Sign-In in Androidに説明しているガイドラインを参照するとよいでしょう。
一度、プレイヤーがログインし GoogleApiClientに接続したら、ゲームはターンベースのマルチプレイヤーAPIを使用することができます。

マッチを始める

ターンベースのマッチを始めるには、ゲームは、他の参加者と試合したい相手を指定する方法や、いくつかの規定した基準を使用した試合を構築した方法を選択することをプレイヤーに促すことができます。Play Games servicesは、ゲームにターンベースマッチのオブジェクトを返すためにゲームからマッチコンフィギュレーションデータを使用しています。このオブジェクトは、ターンベースマッチのライフサイクル上の全ての参加者と非同期に更新・共有されます。

試合を始めるには、これらのステップに従います:
  1. アプリ内で、プレイヤーがプレイしたいターンベースマッチの種類の詳細を収集し、試合に参加することができます。
    • ゲームは、SDKが提供する内蔵のプレイヤー選択ユーザーインターフェース(UI)を表示したり、このデータを収集するために独自のカスタムUIを使用することができます。プレイヤー選択UIの使用方法を学ぶには、デフォルトユーザーインターフェースによるプレイヤー選択を参照してください。
    • 別の方法として、ユーザーがプレイヤー選択UIを避けられるようにクイックスタートボタンを実装することができ、いくつかの規定した基準を使用して試合を構築する代わりになります。
  2. TurnBasedConfigObject内のマッチコンフィギュレーションデータを設定するTurnBasedMatchConfig.Builderを使用します。
  3. createMatch() を呼び、生成したTurnBasedConfigObjectを通します。自動マッチングが指定されている場合は、Play Games servicesは既存のゲームにマッチしようとします。詳細は、自動マッチングを実装を参照してください。
ターンベースマッチを生成するにあたり、ゲームはこれらのメソッドを呼ぶことができます:

-->
メソッド詳細
getSelectOpponentsIntent()オプション。デフォルトのプレーヤー選択UIを起動するためのインテントを返します。このUIから、ユーザーはランダムなGoogle+のユーザーと自動マッチする要求したり、他のGoogle+ユーザーをマッチするユーザーとして招待することを選択することができます。
createMatch()新しいターンベースマッチオブジェクトを作成する、または、自動マッチングが要求された場合のユーザーの基準を満たしている既存の試合をロードします。オートマッチングが要求された場合、返される試合は新しい試合または他のプレイヤーがすでにターンを取っている既存の試合のいずれかになります。新しい試合が返された場合、ユーザーは最初のターンを取る必要があります。ゲームは、新規または既存の試合がロードされているかどうかにかかわらず、交替を処理する責任があります。

デフォルトユーザーインターフェースによるプレイヤー選択

Play Games servicesは
public void onStartMatchClicked(View view) {
    Intent intent = 
        Games.TurnBasedMultiplayer.getSelectOpponentsIntent(getApiClient(), 1, 7, true);
    startActivityForResult(intent, RC_SELECT_PLAYERS);
}
以降、未翻訳です。
続きはGoogle Play Game Services — Google Developersを参照してください。


このページのコンテンツはクリエイティブ・コモンズの表示 3.0 ライセンスにより使用許諾されます。サンプル コードは Apache 2.0 ライセンス(リンク先は英語)により使用許諾されます。

2013/05/20

【翻訳】Google Play Game Services の設定をGoogle Play デベロッパーコンソール上で行う

Google I/O 2013にて発表されたGoogle Play Game Services について書かれている下記のサイトを翻訳してみました。

Setting Up Google Play Game Services with the Google Play Developer Console
https://developers.google.com/games/services/console/enabling



この資料は、あなたのAndroid, iOS, またはウェブ上のゲームに向けて、デベロッパーコンソールで ゲームサービスを設定する方法を取り扱っています。


ゲームサービスを設定するには、まずデベロッパーコンソールにあなたのゲームを追加する必要があります。ゲームを登録する際、ゲームの名前や説明などの詳細を指定できます。

また、あなたのゲームがゲームサービスにアクセスするためには、ゲームを認証および許可するために必要な証明書を生成する必要があります。

デベロッパーコンソールに登録したゲームは、Android, iOS, またはウェブ版のゲームを関連付けることができるため、プレイヤー達はこれらのプラットフォームで同じゲームの詳細を見たり、同じゲームサービスを共有することができます。


ステップ1.デベロッパーコンソールにサインインする


再インするためには、Google Playデベロッパーコンソールに行きます。もし、これまでにデベロッパーコンソールを登録していなければ、そうするように(=登録するように)求めるメッセージが表示されます。


ステップ2.デベロッパーコンソールにゲームを追加する


デベロッパーコンソールにゲームを追加するためには:
  1. Google Playゲームサービスページを開き、ゲームを追加します。
    • 左側にあるゲームサービスタブを選択します。
    • Google Play ゲームをセットアップボタンをクリックします。
  2. Google APIを既に使用しているゲームを追加しようとしているかどうかを指定します。
    • ゲームをScratchから作ろうとしている場合、または、以前にGoogle APIを設定したことがない場合、ゲームで Google API をまだ使用していませんタブのままでいいです。あなたのゲームの名前を入力し、カテゴリを選択し、そのあと、次へボタンをクリックします。
    • このゲームが既に一つ以上のGoogle API(例えば、Google+ sign-in)を設定している場合は、ゲームで Google API を既に使用していますタブを選択してください。あなたが開発者としてリストされているGoogle APIコンソールからプロジェクトリストを見れます。このリストからプロジェクトを選択し、ゲームのカテゴリを選択し、そのあと、次へボタンをクリックします。

  3. ゲームの詳細フォーム内で、ゲームの説明、カテゴリ、画像アセットを追加します。テスト目的のためでも表示名だけは必須です。その他の項目は、ゲームを公開するときには記入する必要があります。

    • ゲームの表示名と説明は、同じゲームサービスを共有する全てのバージョンに適用するのに十分な、汎用的なものであるべきです。
    • 画像アセットを作成するガイドラインとして、Google Play for Developers guide 及び Google Play Featured-Image Guidelines を参照してください.

  4. デベロッパーコンソール内にゲームのための新しいエントリーを作成するには、保存ボタンをクリックします。

ステップ3.OAuth 2.0クライアントIDを生成する

ゲームにGoogle PlayゲームサービスSDKを使用できるようにするには、まず初めに、あなたのゲームを認証および許可するOAuth 2.0クライアントIDを設定する必要があります。

過去にGoogle APIを使用している場合、既にGoogle APIコンソールでのOAuth 2.0クライアントIDを作成するために使用されるかもしれません。新しいデベロッパーコンソールでは、Google APIコンソールを開くことなく、OAuth 2.0クライアントIDを生成することができます。これを行うには、デベロッパーコンソール内のゲームをGoogle APIコンソールで自動的に生成された対応するエントリーとリンクする必要があります。
OAuth 2.0クライアントIDの生成する方法の詳細については、Google APIs Console helpを参照してください。

警告:あなたのクライアントIDを直接手作業で追加してGoogle APIコンソールを開かないでください。ゲームサービスにリクエストを送信するときにエラーを引き起こす可能性があります。

ゲームのためにOAuth 2.0クライアントIDを生成するには、以下の手順に従います:

a. リンク済みアプリケーションを作成する

Google APIコンソールプロジェクトにゲームをリンクするには、リンク済みアプリページを開き、そしてプラットフォームごとの手順に従います。

以下の手順はAndroidのみの翻訳です。

  1. Android アプリのリンクボタンをクリックします。
  2. アプリ名はプレイヤーに表示されることがあります。そのため、実際のAndroidゲームの名前と一致する名前を指定します。
  3. アプリのパッケージ名を追加します。
  4. ゲームサービスのリアルタイムマルチプレイヤーサポートを使用するには、マルチプレイヤー設定を許可します。
  5. 著作権侵害対策をオンにするかどうかを選択します。
  6. 保存して次へをクリックし、それから下のクライアントIDの作成するセクションの手順に従います。
ここまで。

b. クライアントIDの作成する

  1. ステップ2:アプリの承認画面で、今すぐアプリの承認ボタンをクリックすると、OAuth 2.0クライアントIDを生成する処理が始まります。
  1. オプションとして製品ロゴのほかプロジェクト名を入力するプロンプトが表示されます。この情報は、ユーザーがあなたのゲームを許可するよう求められたとき、OAuth 2.0パーミッションダイアログボックスに表示されます。デフォルトでは、ゲームの名前はプロジェクト名のフィールドに置かれます。
  2. Continueをクリックし、それから下のクライアントID設定を指定するセクションの手順に従います。

c. クライアントID設定を指定する

次に、プラットフォームごとの手順に従って、クライアントID設定を指定します。

以下の手順はAndroidのみの翻訳です。

  1. Application typeとしてInstalled applicationを選び、Installed application typeとしてAndroidを選択します(これらは唯一の選択肢でなければなりません)。
  2. Package nameフィールドには、アンドロイドアプリのパッケージ名を入力します。
  3. ターミナルを開き、SHA-1 フィンガープリント証明書を取得するためにKeytool utilityを実行します。
  4. keytool -exportcert -alias androiddebugkey -keystore <path-to-debug-or-production-keystore> -list -v
    注意:Eclipse用のデバッグキーストアは通常 ~/.android/debug.keystore にあります。

  5. keytoolはキーストアのためのパスワード入力するプロンプトを表示します。デバッグキーストアのデフォルトパスワードは android です。keytoolはターミナルにフィンガープリントを出力します。
  6. 例:
    Certificate fingerprint: SHA1: DA:39:A3:EE:5E:6B:4B:0D:32:55:BF:EF:95:60:18:90:AF:D8:07:09
  7. SHA-1フィンガープリントをSigning certificate fingerprintフィールド内に貼り付けます。
  8. Create clientボタンをクリックし、それから下の資格情報を収集するセクションの手順に従います。
Android上のOAuth 2.0についてさらなる情報については、Authenticating to OAuth2 Services
を参照してください。

注意:あなたのアプリを公開する準備ができたら、デベロッパーコンソール内で新しいクライアントIDを作成する必要があります。次に、リリースに証明書に署名すると、再度次の手順を実行しなければなりません。証明書の署名については、Signing your Applicationを参照してください。

警告:パッケージ名およびこの手順で設定した署名証明書を記録していることを確認してください。アプリケーション内の別の証明書またはパッケージ名を使用すると、認証失敗の原因となります。

注意:デベロッパーコンソール内に同じゲームエントリに複数のAndroidアプリを追加することができます。とはいえ、同じゲームの別のバージョン(例えば、無料版と有料版)がある場合に行われるべきです。このケースでは、常に有料版を無料版(またはデモ/体験版の前にフルバージョン)の前にリストアップします。これは将来のリリースで不正な動作を引き起こす可能性があるので、別のゲームを同じプロジェクトにリンクしないでください。代わりに、デベロッパーコンソールで公開するゲーム毎にゲームエントリを分けて作成します。


ここまで。

d. 認証と承認のための資格情報を収集する

あなたが開発しているプラットフォームに応じて、次の資格情報を見つけて記録する必要があるかもしれません。

クライアントID

Create Clientボタンをクリックすると、このアプリのために新しいクライアントIDが表示されるはずです。後でこの情報が必要になるので、クライアントIDをメモしておいてください。あなたはプラットフォームごとに異なるクライアントIDを持つことになります。



注意:Androidでは、アプリケーションIDから自動的に取得されるように、アプリケーション内の全てのクライアントIDを含める必要はありません。

リンク済みアプリページを再訪問し、あなたのプラットフォームのクライアントIDと関連付けられているリンク済みアプリをクリックすることで、いつでもこの情報を見つけることができます。


クライアントIDはページの下部に記載されています。


Client secret(Webベースのゲームのみ)

webベースのアプリケーションを構築する場合、サーバーベースのAPIクライアントを認証するために、Client secretもまた必要とするかもしれません。Webアプリケーションのリンク済みアプリのエントリーをクリックして、client secretを見つけることができます。

アプリケーションID

また、適切にサインインをセットアップするにはアプリケーションIDを知っておく必要があるかもしれません。それは、ページの上部にゲームの表示名の隣に12または13桁の番号を探すことで、見つけることができます。


e. (オプション)マルチクライアントIDを生成する

マルチプラットフォームで動作するゲームを作っている場合、それぞれのプラットフォーム毎(Web, Android, iOS)のクライアントIDを分けて生成する必要があります。これらを行うには、リンク済みアプリページの別のアプリをリンクボタンをクリックし、リンク済みアプリケーションを作成するセクションから始まる手順を繰り返します。

次の手順

さらに進む前に、テスト用アカウントを有効にするで説明しているように、あなたのゲームにテストアカウントを追加するべきでしょう。許可されたテストアカウントを持つユーザーは、Google Playに未公開のゲームにアクセスし、設定したゲームサービスが正しく機能していることをテストすることができます。

一度上記の初期設定タスクを完了したら、リーダーボードや実績など、あなたのゲームにゲームサービスを構成する手順に進むことができます。、詳しくは、Configuring Google Play Game Serviesを参照してください。