game.json 構成ファイル
コレクションでコンテンツを整理必要に応じて、コンテンツの保存と分類を行います。

GameSnacks にゲームをアップロードする際には、game.json 構成ファイルが必要となります。この構成ファイルを使用して、ゲームに関する情報を GameSnacks に提供します。これには、ゲームセンターカタログでゲームを表示する際に必要となるマーケティングリソースなどが含まれます。

例

以下は game.json ファイルのサンプルです。

{
  "name": "Test game",
  "version": "1.0",
  "description": "The test game! ...",
  "genres": ["CARD", "Casual"],
  "orientation": "ANY",
  "developer": {
    "name": "GameSnacks developer name",
    "logo": [{
      "size": {
        "height": 512,
        "width": 512
      },
      "src": "images/testgame-icon-character.png"
    },
    {
      "size": {
        "height": 128,
        "width": 128
      },
      "src": "images/testgame-icon-character.png"
    },
    {
      "size": {
        "height": 256,
        "width": 256
      },
      "src": "images/testgame-icon-character.png"
    }]
  },
  "marketingAssets": {
    "horizontalBanners": [{
      "size": {
        "height": 1080,
        "width": 1920
      },
      "src": "images/testgame-horizontal-banner.png"
    },{
      "size": {
        "height": 540,
        "width": 960
      },
      "src": "images/testgame-high-res-banner.jpg"
    },{
      "size": {
        "height": 270,
        "width": 480
      },
      "src": "images/testgame-med-res-banner.jpg"
    },{
      "size": {
        "height": 135,
        "width": 240
      },
      "src": "images/testgame-low-res-banner.jpg"
    }],
    "verticalBanners": [{
      "size": {
        "height": 1920,
        "width": 1080
      },
      "src": "images/testgame-tall-banner.png"
    },{
      "size": {
        "height": 960,
        "width": 540
      },
      "src": "images/testgame-high-res-tall.png"
    },{
      "size": {
        "height": 480,
        "width": 270
      },
      "src": "images/testgame-med-res-tall.png"
    },{
      "size": {
        "height": 240,
        "width": 135
      },
      "src": "images/testgame-low-res-tall.png"
    }],
    "screenshots": [{
        "size": {
          "width": 1080,
          "height": 1920
        },
        "src": "images/testgame-screenshot1.png"
      },
      {
        "size": {
          "width": 1080,
          "height": 1920
        },
        "src": "images/testgame-screenshot2.png"
      },
      {
        "size": {
          "width": 1080,
          "height": 1920
        },
        "src": "images/testgame-screenshot3.png"
      }
    ],
    "gameIcons": [{
        "size": {
          "height": 512,
          "width": 512
        },
        "src": "images/testgame-icon.png"
      },
      {
        "size": {
          "height": 256,
          "width": 256
        },
        "src": "images/testgame-high-res-icon.png"
      },
      {
        "size": {
          "height": 128,
          "width": 128
        },
        "src": "images/testgame-med-res-icon.png"
      },
      {
        "size": {
          "height": 64,
          "width": 64
        },
        "src": "images/testgame-low-res-icon.png"
      }
    ]
  },
  "files": ["**"]
}

フィールド

game.json 構成ファイルのフィールドの要件は以下のとおりです。

フィールド	型	必須 / 省略可	説明	要件
`name`	文字列	必須	ゲームの名前。通常、ユーザーにはこの名前が表示されます。	2 文字以上の文字列を指定してください（空白文字を除く）。一例として、「a 」は無効になります。 25 文字以下で入力してください（空白文字を含む）。すべてのゲームで一意である必要があります。
`version`	文字列	必須	デベロッパー提供のバージョンを表す文字列。	空の文字列は指定できません（空白文字を除く）。それぞれのゲーム内で一意である必要があります。
`description`	文字列	必須	ゲームの説明。	空の文字列は指定できません（空白文字を除く）。 150 文字以下で入力してください（空白文字を含む）。
`genres`	文字列のリスト	必須	ゲームのジャンル。	次の値のうち 1 つ以上を指定してください。`Action`、`Adventure`、`Arcade`、`Board`、`Card`、`Casino`、`Educational`、`Music`、`Puzzle`、`Racing`、`Role playing`、`Simulation`、`Sports`、`Strategy`、`Trivia`、`Word`
`orientation`	文字列	省略可	ゲームのデフォルトの画面の向き。	次のいずれかの値を指定してください。`Any`、`Landscape`、`Portrait`
`marketingAssets`	MarketingAssets	必須	ゲームのビジュアルアセット。	マーケティングアセットタイプのフィールドの要件を満たしている必要があります。
`aboutUrl`	文字列	省略可	ゲームの概要ページの URL。	有効な URL を指定してください。 HTTP または HTTPS スキームを使用している必要があります。
`privacyPolicyUrl`	文字列	省略可	ゲームのプライバシーポリシーの URL。	有効な URL を指定してください。 HTTP または HTTPS スキームを使用している必要があります。
`developer`	デベロッパー	必須	ゲームデベロッパーに関するメタデータ。	デベロッパータイプのフィールドの要件を満たしている必要があります。
`publisher`	パブリッシャー	省略可	パブリッシャーに関するメタデータ。	パブリッシャータイプのフィールドの要件を満たしている必要があります。
`monetizationSettings`	MonetizationSettings	省略可	ゲームの収益化設定。	収益化設定タイプのフィールドの要件を満たしている必要があります。
`alternativePlatforms`	AlternativePlatforms の配列	省略可	代替プラットフォームで提供されているゲームのバージョン。	代替プラットフォームタイプのフィールドの要件を満たしている必要があります。
`files`	文字列の配列	必須	ゲームの必須ファイルのリスト。	このリストには、ゲームの実行に必要なアセットのみを含めます。バナーやアイコンなどの追加のアセットは含めないでください。ファイル形式の要件を満たしている必要があります。
`entrypoint`	文字列	省略可	ゲームのエントリポイント。	ファイルタイプの要件を満たしている必要があります。値が指定されていない場合のデフォルト値は「index.html」です。エントリポイントファイルは、構成ファイルの「files」リストに含まれている必要があります。

型

複数のフィールドで使用できる一般的な形式の種類は、以下のとおりです。

ファイル

要件
ゲームアーカイブに配置する必要があります。パスは、ゲームアーカイブ内のパスを指定します（例: 「../」は使用できません）。関連するすべての要件を満たしている必要があります。

サイズ

フィールド	型	必須 / 省略可	説明	要件
`width`	int32	必須	リソースの幅。	なし
`height`	int32	必須	リソースの高さ。	なし

画像

フィールド	型	必須 / 省略可	説明	要件
`size`	サイズ	必須	画像のサイズ。	サイズタイプの要件を満たしている必要があります。
`src`	文字列	必須	画像ファイルのパス。	ファイル形式の要件を満たしている必要があります。ファイル拡張子は、「jpeg」、「jpg」、「jpe」、「jif」、「jfif」、「png」、「svg」、「webp」のいずれかである必要があります。ファイル拡張子が SVG である場合、size を指定する必要はありません。

動画

フィールド	型	必須 / 省略可	説明	要件
`size`	サイズ	必須	動画のサイズ。	サイズタイプの要件を満たしている必要があります。
`src`	文字列	必須	動画ファイルのパス。	ファイル形式の要件を満たしている必要があります。ファイル拡張子は「mp4」である必要があります。

代替プラットフォーム

フィールド	型	必須 / 省略可	説明	要件
`platform`	列挙型	省略可	ゲームが提供されているプラットフォーム。	`Chrome Web Store`、`Play`、`iTunes`、`Web app`、`Windows`、`F-Droid`、または `Amazon` の値を指定してください
`url`	文字列	必須	ゲームにアクセスできる URL。	有効な URL を指定してください。HTTP または HTTPS スキームを使用している必要があります。

パブリッシャー

フィールド	型	必須 / 省略可	説明	要件
`name`	文字列	必須	パブリッシャーの名前。	2 文字以上の文字列を指定してください（空白文字を除く）。25 文字以下で入力してください（空白文字を含む）。
`logo`	画像のリスト	必須	パブリッシャーのアイコン。	アイコンの画像はスクエアで、透明度やシャドウが適用されていないものを指定してください。画像タイプの要件を満たしている必要があります。解像度 512×512 ピクセルの画像を少なくとも 1 つ含めてください。解像度 128×128 ピクセルの画像を少なくとも 1 つ含めてください。解像度 256×256 ピクセルの画像を少なくとも 1 つ含めてください。注: デベロッパーは必要に応じて他の解像度の画像を提供できます。

デベロッパー

フィールド	型	必須 / 省略可	説明	要件
`name`	文字列	必須	デベロッパーの名前。	2 文字以上の文字列を指定してください（空白文字を除く）。25 文字以下で入力してください（空白文字を含む）。
`logo`	画像のリスト	必須	デベロッパーのアイコン。	アイコンの画像はスクエアで、透明度やシャドウが適用されていないものを指定してください。画像タイプの要件を満たしている必要があります。解像度 512×512 ピクセルの画像を少なくとも 1 つ含めてください。解像度 128×128 ピクセルの画像を少なくとも 1 つ含めてください。解像度 256×256 ピクセルの画像を少なくとも 1 つ含めてください。注: デベロッパーは必要に応じて他の解像度の画像を提供できます。

マーケティングアセット

フィールド	型	必須 / 省略可	説明	要件
`horizontalBanners`	画像のリスト	必須	ゲームの横長バナー。	画像タイプの要件を満たしている必要があります。アスペクト比 16:9 の画像を指定してください。解像度 1,920×1,080 ピクセルの画像を少なくとも 1 つ含めてください。解像度 240×135 ピクセルの画像を少なくとも 1 つ含めてください。解像度 480×270 ピクセルの画像を少なくとも 1 つ含めてください。
`verticalBanners`	画像のリスト	必須	ゲームの縦長バナー。	画像タイプの要件を満たしている必要があります。アスペクト比 9:16 の画像を指定してください。解像度 1,080×1,920 ピクセルの画像を少なくとも 1 つ含めてください。解像度 135×240 ピクセルの画像を少なくとも 1 つ含めてください。解像度 270×480 ピクセルの画像を少なくとも 1 つ含めてください。
`screenshots`	画像のリスト	必須	ゲームのスクリーンショット。	画像タイプの要件を満たしている必要があります。スクリーンショットは 3 つ以上提供してください。アスペクト比 16:9 または 9:16 の画像を指定してください。解像度 1,920×1,080 または 1,080×1,920 ピクセルのスクリーンショットを少なくとも 1 つ含めてください。
`gameIcons`	画像のリスト	必須	ゲームをインストールするかホーム画面に追加すると表示されるアイコン。	画像タイプの要件を満たしている必要があります。解像度 512×512 ピクセルの画像を少なくとも 1 つ含めてください。解像度 128×128 ピクセルの画像を少なくとも 1 つ含めてください。解像度 256×256 ピクセルの画像を少なくとも 1 つ含めてください。
`trailers`	動画のリスト	省略可	ゲームの予告編。	動画タイプの要件を満たしている必要があります。アスペクト比 16:9 の動画を指定してください。解像度 1,920×1,080 ピクセルの予告編を少なくとも 1 つ含めてください。

収益化設定

フィールド	型	必須 / 省略可	説明	要件
`isChildDirected`	ブール値	必須	このゲームの広告リクエストに子供向け取り扱いタグを設定するかどうか。	hasRewardedAds または hasInterstitialAds が true の場合は指定する必要があります。
`hasRewardedAds`	ブール値	必須	ゲームがリワード広告に対応しているかどうか。	なし
`hasInterstitialAds`	ブール値	必須	ゲームがインタースティシャル広告に対応しているかどうか。	なし

game.json 構成ファイル コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

例