Add support for mediaTiles to example game JSON

[ouya-game-data.git] / game-metadata.html

diff --git a/game-metadata.html b/game-metadata.html
index 4035646268a89861fa59747594f00a4da18d8e68..c7cffd64e2060b8523d4ef5b38d3f0fa3fa52d80 100644 (file)
--- a/game-metadata.html
+++ b/game-metadata.html
@@ -29,17 +29,6 @@
    </thead>
    <tbody>
 
-    <tr>
-     <td>app</td>
-     <td>Game UUID</td>
-     <td>uuid</td>
-     <td>uuid</td>
-     <td>uuid</td>
-     <td>-</td>
-     <td>App.uuid</td>
-     <td>780688a9-95ee-429a-8755-69a8d0c88fe0</td>
-     <td></td>
-    </tr>
     <tr>
      <td>app</td>
      <td>Game title</td>
@@ -403,17 +392,23 @@
      <td>apk</td>
      <td>UUID of latest apk version</td>
      <td>releases.*.uuid</td>
-     <td>latestVersion.uuid</td>
-     <td>latestVersion</td>
+     <td>
+      uuid<br/>
+      latestVersion.uuid
+     </td>
+     <td>
+      uuid<br/>
+      latestVersion
+     </td>
      <td>version.uuid</td>
-     <td>-</td>
+     <td>App.uuid</td>
      <td>780688a9-95ee-429a-8755-69a8d0c88fe0</td>
-     <td></td>
+     <td>The OUYA API does not have app UUIDs, only release/apk uuids. </td>
     </tr>
     <tr>
      <td>apk</td>
      <td>Internal version</td>
-     <td>-</td>
+     <td>releases.*.versionCode</td>
      <td>-</td>
      <td>-</td>
      <td>apk.versionCode</td>
@@ -490,7 +485,7 @@
      </td>
      <td>
       Also in download.json<br/>
-      Details field: only a file name, no path/domain
+      Details field: only a file name, no path/domain. Always set.
      </td>
     </tr>
     <tr>
@@ -552,7 +547,7 @@
      <td>media.video</td>
      <td></td>
      <td>videoUrl</td>
-     <td>mediaTiles.*.url (when mediaTiles.*.type=video)</td>
+     <td></td>
      <td>Media</td>
      <td>https://vimeo.com/141878938</td>
      <td></td>
@@ -563,11 +558,50 @@
      <td>media.screenshots</td>
      <td></td>
      <td>filepickerScreenshots</td>
-     <td>mediaTiles.*.urls.full, mediaTiles.*.urls.thumb, mediaTiles.*.fp_url (when mediaTiles.*.type=image)</td>
+     <td>-</td>
      <td>Media</td>
      <td>[urls]</td>
      <td></td>
     </tr>
+    <tr>
+     <td>media</td>
+     <td>Details images+videos</td>
+     <td>media.details</td>
+     <td></td>
+     <td></td>
+     <td>mediaTiles</td>
+     <td>?</td>
+     <td>
+      <pre>[
+  {
+    "type: "image",
+    "urls": [
+      "full": "http://...",
+      "thumb": "http://...",
+    ],
+    "fp_url": "http://...."
+  },
+  {
+    "type": "video",
+    "url": "https://vimeo.com/141878938"
+  }
+]</pre>
+     </td>
+     <td>
+      Allows free ordering of images and videos on the details page.<br/>
+      "fp" is probably "FilePicker".<br/>
+      fp_url is not used in OUYA's launcher.
+      The launcher loads the thumbnail at first, immediately after the full image.
+      If no mediaTile is available, the app's mainImageFullUrl
+      is used. When offline, the apk image is used.<br/>
+      <br/>
+      Game data information:
+      If details is not given or an emtpy array,
+      "mediaTile" array should automatically be created by combining
+      "media.large", "media.video" and "media.screenshots" into the
+      mediaTiles format.
+     </td>
+    </tr>
     <tr>
      <td>media</td>
      <td>FIXME</td>
@@ -633,7 +667,7 @@
     <tr>
      <td>developer</td>
      <td>Developer UUID</td>
-     <td>-</td>
+     <td>developer.uuid</td>
      <td>-</td>
      <td>-</td>
      <td>developer.url (part of)</td>