メインコンテンツまでスキップ

ログインユーザーの情報を表示する

次に RESTful API を利用してテストユーザーの情報をスタートページに表示するプログラムを開発していきます。

事前準備​

このチュートリアルでは、サーバー側のプログラムは PHP を使って開発していきます。ゲームサーバー上で PHP が動作するようにゲームサーバーを設定しておいてください。他の開発言語をご使用の場合は、各言語環境に併せて読み替えてください。

また、このプログラムでは、Gadget サーバーからのリクエストの妥当性検証や RESTful API の認証のために OAuth のライブラリーを使用します。OAuth.php を以下の URL から取得して、 http://dev.gameserver.com/OAuth.php となるように配置してください。

Gadget サーバーからのリクエストの妥当性検証​

まずはじめに、Gadget サーバーからゲームサーバーへのリクエストの妥当性を検証するプログラムを開発します。
この処理は、Gadget サーバーからリクエストされるすべてのプログラムで実施すべきものですので、共通のクラスとして、以下のような validator.php を開発します。

<?php
require_once ("OAuth.php");

class RequestValidator {

public static function validate() {
// Consumer Key from DevPortal
$consumer_key = 'YourConsumerKey';
// Consumer Secret from DevPortal
$consumer_secret = 'YourConsumerSecret';
// OAuth Consumer
$consumer = new OAuthConsumer($consumer_key, $consumer_secret, NULL);
// Request from Gadget Server
$request = OAuthRequest::from_request(NULL, NULL, NULL);
// Token from Gadget Server
$token = new OAuthToken($request -> get_parameter('oauth_token'), $request -> get_parameter('oauth_token_secret'));
// Signature from Gadget Server
$signature = $request -> get_parameter('oauth_signature');

// Signature Method (HMAC-SHA1)
$sign_method = new OAuthSignatureMethod_HMAC_SHA1();
// Validate Request from Gadget Server
$valid = $sign_method -> check_signature($request, $consumer, $token, $signature);
return $valid;
}

}
?>

プログラムの処理を説明をしてきます。
この RequestValidator クラスの validate 関数は、Gadget サーバーからのリクエストから、OAuth のトークンと署名を取得し、ゲームサーバー側でも同様の手順で生成した署名と比較して、一致すれば true を返し、不一致であれば false を返します。

Gadget サーバーとゲームサーバーのみがお互いにこのアプリケーションの Consumer Secret を共通鍵として知っているために、署名の検証をすることでリクエストの改ざんを防ぐことが可能になります。

Consumer KeyとConsumer Secretの値は、デベロッパーサイト上の「アプリケーション詳細」画面の「Mobage共通」タブ下部に設定されていますので、その値をプログラムに設定してください。

警告

Consumer Secret の値は、外部に漏洩しないように厳重に管理する必要があります。
万が一外部に漏洩した可能性がある場合には、デベロッパーサイトのお問い合わせ窓口からお問い合わせください。

// Consumer Key from DevPortal (or DevPortal)
$consumer_key = 'YourConsumerKey';
// Consumer Secret from DevPortal (or DevPortal)
$consumer_secret = 'YourConsumerSecret';
// OAuth Consumer
$consumer = new OAuthConsumer($consumer_key, $consumer_secret, NULL);

次に、以下のプログラムで Gadget サーバーから送られるリクエストヘッダーから OAuth のトークン (oauth_token と oauth_token_secret の値) および、署名 (oauth_signatureの値) を取得します。

// Request from Gadget Server
$request = OAuthRequest::from_request(NULL, NULL, NULL);
// Token from Gadget Server
$token = new OAuthToken($request -> get_parameter('oauth_token'), $request -> get_parameter('oauth_token_secret'));
// Signature from Gadget Server
$signature = $request -> get_parameter('oauth_signature');

上記で取得した OAuth のトークンと Consumer Key、Consumer Secret およびリクエスト情報を元に、ゲームサーバー上で署名を再生成し、Gadget サーバーから送付された署名と一致するかを確認します。この一連の処理は、OAuthSignatureMethod_HMAC_SHA1 クラスの check_signature 関数で行うことができます。

// Signature Method (HMAC-SHA1)
$sign_method = new OAuthSignatureMethod_HMAC_SHA1();
// Validate Request from Gadget Server
$valid = $sign_method -> check_signature($request, $consumer, $token, $signature);

完成した validator.php を http://dev.gameserver.com/validator.php となるようにゲームサーバーに配置します。

テストユーザーのニックネームとプロフィールを表示する​

次に、API サーバーの People API を利用して、ログインしているユーザーのニックネームとプロフィール画像を表示するプログラムを開発します。以下のような mypage.php を開発します。

<?php
require_once ('OAuth.php');
require_once ('validator.php');

// Validate Request from Gadget Server
$valid = RequestValidator::validate();
if (!$valid) {
// Respond Error Page
print('<html><body><p>Invalid Request from Gadget Server</p></body></html>');
exit ;
}

// Consumer Key from DevSite (or DevPortal)
$consumer_key = 'YourConsumerKey';
// Consumer Secret from DevSite (or DevPortal)
$consumer_secret = 'YourConsumerSecret';
// OAuth Consumer
$consumer = new OAuthConsumer($consumer_key, $consumer_secret, NULL);

// Request from Gadget Server
$request_from_gadget = OAuthRequest::from_request(NULL, NULL, NULL);
// opensocial_viewer_id from Gadget Server
$user_id = $request_from_gadget -> get_parameter('opensocial_viewer_id');
// Token from Gadget Server
$token_from_gadget = new OAuthToken($request_from_gadget -> get_parameter('oauth_token'), $request_from_gadget -> get_parameter('oauth_token_secret'));

// EndPoint URL for People API
$url = "http://sb.sp.app.mbga.jp/api/restful/v1/people/@me/@self?xoauth_requestor_id=$user_id";
// HTTP Method
$method = 'GET';
// Parse Parameters
parse_str(parse_url($url, PHP_URL_QUERY), $param);
// Request to API Server
$request_to_API = OAuthRequest::from_consumer_and_token($consumer, $token_from_gadget, $method, $url, $param);
// Generate OAuth Signature
$request_to_API -> sign_request(new OAuthSignatureMethod_HMAC_SHA1(), $consumer, $token_from_gadget);
// Create Authorization Header
$auth_header = $request_to_API -> to_header();
// Execute HTTP Request to API Server
$curl = curl_init($url);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_FAILONERROR, false);
curl_setopt($curl, CURLOPT_ENCODING, "gzip");
curl_setopt($curl, CURLOPT_HTTPHEADER, array($auth_header));
$response = curl_exec($curl);
$status_code = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

// Check Response from API Server
if ($status_code != 200) {
// Respond Error Page
print("<html><body><p>Got an error from API Server ($status_code, $response)</p></body></html>");
exit ;
}

// Parse JSON in Response
$person = json_decode($response);
$id = $person -> {'person'} -> {'id'};
$nickname = $person -> {'person'} -> {'nickname'};
$thumbnailUrl = $person -> {'person'} -> {'thumbnailUrl'};
$profileUrl = $person -> {'person'} -> {'profileUrl'};
?>
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="viewport" content="width=device-width" />
</head>
<body style="margin:0; text-align:center;">
<p>Hello!! <?=$nickname ?></p>
<a href="<?=$profileUrl ?>">
<img src="<?= $thumbnailUrl ?>">
</a>
</body>
</html>

プログラムの処理を説明をしてきます。

まず、先ほど作成した Gadget サーバーからのリクエストの妥当性を検証するための validator.php の利用を宣言します。

require_once ('OAuth.php');
require_once ('validator.php');

次に、validate.php の RequestValidator クラスの validate 関数を呼び出して、Gadget サーバーからのリクエストが改ざんされていないことを確認します。もし、署名が一致せずに不正なリクエストである場合はエラーページを返すようにしておきます。

// Validate Request from Gadget Server
$valid = RequestValidator::validate();
if (!$valid) {
// Respond Error Page
print('<html><body><p>Invalid Request from Gadget Server</p></body></html>');
exit ;
}

次は、API サーバーへのアクセスの準備をします。まずは、API サーバー OAuth のパラメーターに必要な、Consumer KeyとConsumer Secretを準備します。

// Consumer Key from DevSite (or DevPortal)
$consumer_key = 'YourConsumerKey';
// Consumer Secret from DevSite (or DevPortal)
$consumer_secret = 'YourConsumerSecret';
// OAuth Consumer
$consumer = new OAuthConsumer($consumer_key, $consumer_secret, NULL);

People API へのアクセスは Proxy モデル (OAuth のトークンを利用するモデル) を使用しますので、Gadget サーバーから渡される、OAuth のトークンと opensocial_viewer_id (ページを閲覧しているログインユーザーのID) を取得します。

// Request from Gadget Server
$request_from_gadget = OAuthRequest::from_request(NULL, NULL, NULL);
// opensocial_viewer_id from Gadget Server
$user_id = $request_from_gadget -> get_parameter('opensocial_viewer_id');
// Token from Gadget Server
$token_from_gadget = new OAuthToken($request_from_gadget -> get_parameter('oauth_token'), $request_from_gadget -> get_parameter('oauth_token_secret'));

これで、People API へアクセスするために必要な情報が揃ったので、OAuth のヘッダー情報を生成します。
ログインユーザーの情報を取得するためのパスである /people/@me/@self を Sandbox 用の Endpoint URL を基準に作成します。Proxy モデルの場合は、リクエストパラメーターの xoauth_requester_id に 上記で取得した opensocial_viewer_id の値を設定します。

// EndPoint URL for People API
$url = "http://sb.sp.app.mbga.jp/api/restful/v1/people/@me/@self?xoauth_requestor_id=$user_id";
// HTTP Method
$method = 'GET';
// Parse Parameters
parse_str(parse_url($url, PHP_URL_QUERY), $param);
// Request to API Server
$request_to_API = OAuthRequest::from_consumer_and_token($consumer, $token_from_gadget, $method, $url, $param);
// Generate OAuth Signature
$request_to_API -> sign_request(new OAuthSignatureMethod_HMAC_SHA1(), $consumer, $token_from_gadget);
// Create Authorization Header
$auth_header = $request_to_API -> to_header();

上記で生成された OAuthの Authorization ヘッダーを利用して API サーバーへのリクエストを実行します。API サーバーからのレスポンスデータと HTTP ステータスコードを取得しておきます。

// Execute HTTP Request to API Server
$curl = curl_init($url);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_FAILONERROR, false);
curl_setopt($curl, CURLOPT_ENCODING, "gzip");
curl_setopt($curl, CURLOPT_HTTPHEADER, array($auth_header));
$response = curl_exec($curl);
$status_code = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

People API の GET メソッドでは、成功時には HTTP ステータスコードは 200 が返ります。ここでは、200 以外の場合はエラーページを返すようにしておきます。

// Check Response from API Server
if ($status_code != 200) {
// Respond Error Page
print("<html><body><p>Got an error from API Server ($status_code, $response)</p></body></html>");
exit ;
}

HTTP ステータスが 200 の場合は、レスポンスデータに含まれる JSON データを解析して、 id, nickname, thumbnailUrl と profileUrlの値を取り出し、HTMLに埋め込みます。

// Parse JSON in Response
$person = json_decode($response);
$id = $person -> {'person'} -> {'id'};
$nickname = $person -> {'person'} -> {'nickname'};
$thumbnailUrl = $person -> {'person'} -> {'thumbnailUrl'};
$profileUrl = $person -> {'person'} -> {'profileUrl'};
?>
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="viewport" content="width=device-width" />
</head>
<body style="margin:0; text-align:center;">
<p>Hello!! <?=$nickname ?></p>
<a href="<?=$profileUrl ?>">
<img src="<?= $thumbnailUrl ?>">
</a>
</body>
</html>

ガイドライン上 thumbnailUrl の プロフィール画像がタップされた時には、ユーザーのプロフィールページを表示しなければなりません。profileUrl で指定されたページに遷移させるようにするため、下記のようなアンカータグの実装をします。

<a href="<?=$profileUrl ?>">
<img src="<?= $thumbnailUrl ?>">
</a>

では、この mypage.php を http://dev.gameserver.com/mypage.php となるように、ゲームサーバーに配置します。

また、前章で作成した index.html に mypage.php へのリンクを以下のように追加して再配置してください。コンテンツ内での画面遷移に利用するリンクは全て Gadget サーバーを通す必要がありますので、以下のように ?url={URLエンコードされたゲームサーバーの絶対パス} という形で指定する必要があります。

<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="viewport" content="width=device-width" />
</head>
<body style="margin:0; text-align:center;">
<p>Welcome To My First Broweser Game!</p>
<a href="?url=http%3A%2F%2Fdev.gameserver.com%2Fmypage.php">My Page</a>
</body>
</html>

実機で確認する​

さて、前章と同様の手順でアプリケーションにアクセスしてください。以下のように、My Page へのリンクが追加されています。

My Page のリンクをタップして、以下のようにログインユーザーのニックネームとプロフィール画像が表示されていれば成功です。

参考資料​

People API では、ユーザーID指定で他ユーザーの情報を取得することや、友達のコレクションデータも取得可能です。詳しくは、こちらを参照してください。

更新履歴​

  • 2012/03/01
    • 新規作成
  • 事前準備
  • Gadget サーバーからのリクエストの妥当性検証
  • テストユーザーのニックネームとプロフィールを表示する
  • 実機で確認する
  • 参考資料
  • 更新履歴