跳到主要内容

ゲームサーバーから Gadget サーバーへのレスポンス

画面遷移​

コンテンツ内での画面遷移に利用するリンクは全て Gadget サーバーを通す必要があります。

Gadget サーバーのURLは

  • Sandbox 環境

    `http://g[アプリID`].sb.sp.pf.mbga.jp/
  • 本番環境

    `http://g[アプリID`].sp.pf.mbga.jp/

になります。

GET:

<a href="?url=http%3A%2F%2Fexample.com%2F">リンク</a>
  • 絶対パス(http://~)による設定 (例:Sandbox環境にて、アプリIDが「100001」の場合)

    <a href="http://g100001.sb.sp.pf.mbga.jp/?url=http%3A%2F%2Fexample.com%2F">リンク</a>

POST:

<form method="post" action="?url=http%3A%2F%2Fexample.com%2F">
<input type="submit" value="送信" />
</form>
  • 絶対パス(http://~)による設定 (例:Sandbox環境にて、アプリIDが「100001」の場合)

    <form method="post" action="http://g100001.sb.sp.pf.mbga.jp/?url=http%3A%2F%2Fexample.com%2F">
    <input type="submit" value="送信" />
    </form>
  • 絶対パス(http://~)による設定 (例:Sandbox環境にて、アプリIDが「100001」の場合)

    <form method="post" action="http://g100001.sb.sp.pf.mbga.jp/">
    <input type="hidden" name="url" value="`http://example.com"` />
    <input type="submit" value="送信" />
    </form>
  • urlパラメータの値はURIエスケープする必要があります。

  • これ以外のリンクに関しては、全て Gadget サーバーによって中間ページ経由に変換されます。

画像の表示​

コンテンツ内の画像表示は通常のHTMLとして書くことができます。ユーザーの端末への表示の際に Gadget サーバーにより自動的に Gadget サーバー経由のURLに変更されます。

<img src="http://example.com/image.gif" />

通常は画像ファイルの Gadget サーバーからパートナーサーバーへのリクエストには Authorization ヘッダが付きません。Authorization ヘッダを付けてリクエストの妥当性を評価したい場合は、signed=1 をクエリパラメータに含めてください。

<img src="http://example.com/image.gif?signed=1" />

また、本番環境および Sandbox 環境で画像ファイルはキャッシュされます。これが問題となる場合は nocache=1 をクエリパラメータに含めてください。また、一度キャッシュされたものを更新する場合は、URLに含まれるファイル名を変更するかクエリパラメータの付与を行ってください。

なお、1x1 ピクセルの透過画像をご利用になりたい場合は弊社で用意した

<img src="http://ava-a.mbga.jp/i/dot.gif" />

をご利用ください。

Flashコンテンツの表示​

Flashの表示は画像表示同様に通常のHTMLとして書くことができます。また、画像表示同様にユーザーの端末への表示の際に Gadget サーバーにより自動的に Gadget サーバー経由のURLに変更されるため、ユーザーには Gadget サーバーのドメインとして配信されます。

  1. インタラクティブ再生
<a href="?url=http%3A%2F%2Fexample.com%2Fflash.swf">Flash再生</a>
  1. インライン再生
<object data="?url=http%3A%2F%2Fexample.com%2Fflash.swf" type="application/x-shockwave-flash" width="200" height="40">
</object>

また、Flash Player が導入されていない端末に関しては、ExGameを使用することができます。

<html>
<head>
<script type="text/javascript" src="?url=http%3A%2F%2Fexample.com%2Fjj.js"></script>
<script type="text/javascript">
window.onunload = function() {};
window.onload = function() {
var container = document.getElementById("container");
var jj = new JumpinJack("?url=http%3A%2F%2Fexample.com%2Fflash.swf", container);
};
</script>
</head>
<body><div id="container"></div></body>
</html>

サービスタグ​

HTML内に特別なリンクをコンテンツに含むことで、プラットフォームが用意するソーシャル機能へのアクセスすることが可能になります。例えば、日記を書き込む機能の場合は、アンカータグの href 属性に diary:self という予約語を記載しておくと、Gadgetサーバーがプラットフォームの日記機能へのリンクに置換して、機能を実現します。

例

<a href="diary:self?url=http%3A%2F%2Fexample.com&subject=%83e%83X%83g">日記を書く</a>

JavaScript について​

  • body タグの onclick について
    • スマートフォンアプリの WebView で見た場合、動作しない場合があるので、以下の様に div タグに指定するようにしてください。
# 修正前
<body onclick="...">
...
</dody>

# 修正後
<body>
<div onclick="...">
</div>
</body>
  • 以下のように、JavaScript で URL を生成、または通信する場合は必ずGadget Server を通すようにしてください。

Sandbox環境

`http://g[アプリID`].sb.sp.pf.mbga.jp/?url=[通信したいURLをURIエスケープした値]

本番環境

`http://g[アプリID`].sp.pf.mbga.jp/?url=[通信したいURLをURIエスケープした値]

対象となるURLは以下のようなケースです。

  • XMLHttpRequest などの通信を行う URL
  • img タグや iframe タグ などの src に URL を動的に埋め込む場合
  • a タグや、その他ユーザーがアクションを起こしたときに、遷移される URL

設定可能なHTTPのレスポンスヘッダー​

以下のHTTPレスポンスヘッダーは利用可能です。下記以外のレスポンスヘッダーは、Gadgetサーバーにより削除されます。

リダイレクト​

  • Location
    例)

    Location: http://example.com/path/to/redirect
    备注

Locationに設定するリダイレクト先のURLは、ゲームサーバーのURLを直接指定します。 :::

Cross-Origin Resource Sharing​

  • Access-Control-Allow-Origin
  • Access-Control-Allow-Credentials
  • Access-Control-Expose-Headers
  • Access-Control-Max-Age
  • Access-Control-Allow-Methods
  • Access-Control-Allow-Headers
  • Origin
  • Access-Control-Request-Method
  • Access-Control-Request-Headers
     
    参考)
  • http://www.w3.org/TR/cors/

更新履歴​

  • 2014/05/30
    • POST の
      の例を削除
  • 2013/04/25
    • 設定可能なHTTPのレスポンスヘッダーを追記
  • 2013/03/15
    • ドキュメント移行
  • 画面遷移
  • 画像の表示
  • Flashコンテンツの表示
  • サービスタグ
  • JavaScript について
  • 設定可能なHTTPのレスポンスヘッダー
  • 更新履歴