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

コンテンツ生成時の注意

  • パートナーサーバーは Gadget Server からのリクエストヘッダのUser Agentを元に各キャリア毎にコンテンツを返す必要があります。
  • 文字コードは以下の物を利用する必要があります。

    ドコモ

    Shift-JIS

    au

    Shift-JIS

    ソフトバンク

    UTF-8

  • 以下のタグや属性は利用できません。
    • <script>
    • <a href="mailto:">
    • <a href="tel:">
    • on属性
    • utn属性
    • lcs属性
  • iアプリ、BREWアプリ、Sアプリは利用できません。
  • ドコモ端末の場合、iモードの仕様でHTMLと画像合わせて、1画面は100Kバイト未満に収める必要があります。

画面遷移

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

Gadget サーバーのURLは

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

になります。

GET:

  • 絶対パス(http://~)による設定 (例:Sandbox環境にて、アプリIDが「100001」の場合)

POST:

  • 絶対パス(http://~)による設定 (例:Sandbox環境にて、アプリIDが「100001」の場合)
  • 絶対パス(http://~)による設定 (例:Sandbox環境にて、アプリIDが「100001」の場合)
  • urlパラメータの値はURIエスケープする必要があります。
  • ドコモの場合はguid=ONを付ける必要があります。
  • これ以外のリンクに関しては、全て Gadget サーバーによって中間ページ経由に変換されます。

画像の表示

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

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

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

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

をご利用ください。

Flashコンテンツの表示

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

1. インタラクティブ再生

2. インライン再生

サービスタグ

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

設定可能な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 の <form method="post" action=""> の例を削除
  • 2013/04/25
    • 設定可能なHTTPのレスポンスヘッダーを追記
  • 2013/03/15
    • ドキュメント移行

PREVIOUS

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

NEXT

Gadget サーバーからユーザーへのレスポンス