ウェブのための Playゲームサービスを始める | Google Playゲームサービス和訳 [アプリ・開発]

この記事は、Google Playゲームサービスに関する記事を和訳したものです。
原文: Get Started with Play Games Services for Web
元記事のライセンスは CC-BYで、この和訳記事のライセンスは CC-BYです。
自己責任でご利用ください。
和訳した時期は 2019年7月ころです。

Google Playゲームサービスを用いたウェブゲームの開発へようこそ!

Google Playゲームサービスは、あなたのウェブベースのゲームに、実績、リーダーボードといった人気のあるゲームの機能を簡単に統合することができるクロスプラットフォームな APIを提供します。

このガイドは、あなたのウェブベースのゲームのために Google Playゲームサービスを有効化する方法について説明します。

紹介

Google Playゲームサービスのための REST APIは、あなたに、あなたのウェブゲームからゲームサービスのデータをセットおよび取得するための REST呼び出しを発行できるようにします。ゲームサービスのデータをリセットし、他の管理機能を実行するための REST呼び出しをするための Management APIを使用することもできます。

さらに詳しい情報: REST APIとは何ですか?

RESTは、データをリクエストし修正するための、便利で一貫性のあるアプローチを提供するソフトウェアアーキテクチャのスタイルです。

用語 RESTは "Representational State Transfer" の略です。 Google APIのコンテキストでは、それは、Googleによって格納されたデータの表現を取得し変更するための HTTPの動詞を使用することを意味します。

RESTなシステムでは、リソースはデータストアに格納されています; クライアントは、サーバが特定のアクション(リソースを作成、取得、更新、あるいは削除するといった)を実行するというリクエストを送信します、そして、サーバはアクションを実行し、多くの場合、指定されたリソースの表現の形式でレスポンスを送信します。

Googleの RESTな APIでは、クライアントは POST、GET、PUT、あるいはDELETEといった HTTPの動詞を使用してアクションを指定します。それは次の形式のグローバルに一意な URIによってリソースを指定します:

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

すべての APIリソースは HTTPでアクセス可能なユニークな URIを持っているので、RESTはデータのキャッシュを有効化し、ウェブの分散インフラを用いた動作に最適化されています。

HTTP1.1の標準ドキュメントのメソッド定義が役立つかもしれません; それらは、GET、POST、PUT、および DELETEの仕様を含んでいます。

サンプルコードを見つける

サンプルコードへのリンクは samples downloadページで利用可能です。それらが適切に動作するには、Google Play Consoleにてそれらのゲームのあなた独自のバージョンをセットアップする必要があるでしょう。

Google Playゲームサービスと通信する

あなたが Google Playゲームサービスと通信できる 2つの方法があります。

client-onlyセットアップでは、あなたのゲームは Javascriptを使用してブラウザを介してのみ Google Playゲームサービスと通信します。これは、もしあなたがゲームロジックのためのバックエンドサーバに依存しないシンプルな Flashあるいは HTML5のゲームを作成しているならば、一般的に使用する技術です。

クライアント専用のセットアップで Google Playゲームサービスを有効化するには、クライアント専用のセットアップの手順に従ってください。

client-serverの状況では、あなたのゲームは一般的に Java、Ruby、あるいは PHPといったサーバサイドの言語を使用してあなたのサーバから Google Playゲームサービスと通信しますが、あなたはもし望むならばクライアントサイドと通信することができます。これは、もしあなたがMMOやシミュレーションゲームといった、ゲームロジックの大半の期間、バックエンドサーバを使用するゲームを作成しているならば、一般的に使用する技術です。

クライアントサーバのセットアップで Google Playゲームサービスを有効化するには、クライアントサーバのセットアップの手順に従ってください。

一般的な REST呼び出し

ゲームを作る準備はできましたか? これらは、あなたがする必要があるかもしれない、より一般的な呼び出しの一部です。

プレイヤー

現在のユーザについてもっと知りたいですか? IDを 'me'として Players.getを呼び出してみましょう。

実績

あなたが実績のガイドを参照していることを確認してください、それは、実績をより詳細に説明しています。

現在の実績のリストを取得したいですか? あなたは AchievementDefinitions.listを呼び出すことができます…
…それから、プレイヤーがアンロックしたものを見つけるために Achievements.listへの呼び出しを用いてそれを組み合わせます。
プレイヤーが実績を獲得しましたか? それをアンロックするために Achievements.unlockを使用してください!
プレイヤーが部分的な実績に向けて進展しましたか? 進展を報告するために Achievements.incrementを使用します(そして、プレイヤーがそれをアンロックしたかどうかを調べます)。
あなたはまだ本番環境ではないゲームをデバッグしていますか? 実績を元の状態にリセットするには、Management APIから Achievements.resetあるいは Achievements.resetAllを呼び出してみてください。

リーダーボード

あなたがリーダーボードのガイドを参照していることを確認してください、それは、リーダーボードをより詳細に説明しています。

ゲーム内のすべてのスコアボードの一覧を取得したいですか? Leaderboards.listの呼び出しをします。
あなたは Scores.submitにそれらのスコアを提出し、これが新しいハイスコアかどうかを調べることができます。
リーダーボードを表示したいですか? Scores.listからデータを取得し、それをユーザに表示します。
ユーザのハイスコアに近いスコアの集まりを見つけるには、Scores.listWindowを使用します。
特定のリーダーボード内のプレイヤーのスコアに関する詳細な情報(例えば、プレイヤーがすべてのプレイヤーのトップ 12%内にいるかどうか)を取得するには、Scores.getを呼び出します。
ゲームをデバッグしていますか? 特定のリーダーボードからそのプレイヤーのすべてのスコアをリセットするには、Management APIから Scores.resetを呼び出してみてください。