|release (int)|| Release number of the function, useful to check if any changes have been made to what was returned the time before. |
I will try to keep compatibility with the past so changes will probably be only new input parameters or added output data.
|result (object)||It contains the data of the specific function and may also vary considerably (see below for more information).|
|game_name (string)||Romset to search, multiple values separated by semicolons are allowed. Ex. "mslug", "mslug;mslug2;atetris"|
|use_parent (bool)|| Optional, it indicates whether to read the data from the parent if the game is a clone and has no info. |
The check is done for a single resource, so an in-game snap and a parent's marquee may occur.
Values: 0=No (default), 1=Yes
|resize (string)|| Optional, it indicates the resizing of all images at a given resolution: |
0 - original image (default)Any other value is ignored and has a resize effect at 200px in height. The aspect ratio is maintained and a Lanczos filter is used for the operation, which is performed on the fly (it requires additional server cpu time).
100 or 100h - scaled to 100px in height
200 or 200h - scaled to 200px in height
300 or 300h - scaled to 300px in height
100w - scaled to 100px in width
200w - scaled to 200px in width
300w - scaled to 300px in width
|lang (it|en)|| Optional, it indicates the language to use for translations of some terms (eg for genre). |
Normally, you should not specify this parameter and set instead the browser header. After the first call this value is saved on the cookies and will be the default for subsequent requests.
|The result is an array of objects, each containing these elements:|
|index (int)||Progressive number, starts from 1|
|url (string)||Url for detailed game informations|
|game_name (string)||Game romset. Ex. mslug, atetris|
|title (string)||Game title. Ex. Metal Slug, Tetris (set 1)|
|cloneof (string)||Romset of the parent game, if any|
|url_image_ingame (string)||Url of in-game snapshot image file (png format), empty if not present (this will be checked also on parent if use_parent=1)|
|url_image_title (string)||Url of title snapshot image file (png format), empty if not present (this will be checked also on parent if use_parent=1)|
|url_image_marquee (string)||Url of marquee snapshot image file (png format), empty if not present (this will be checked also on parent if use_parent=1)|
|url_image_cabinet (string)||Url of cabinet snapshot image file (png format), empty if not present (this will be checked also on parent if use_parent=1)|
|url_image_flyer (string)||Url of flyer snapshot image file (png format), empty if not present (this will be checked also on parent if use_parent=1)|
|genre (string)||Genre of the game, from category files. Ex. Fight, Drive, ecc.|
|players (int)||Number of supported players|
|year (string)||Year of release of the game. It may contains symbols to indicate release date not accurate. Ex. 19??|
|status (string)|| Emulation driver status. |
Values: GOOD, IMPERFECT, PRELIMINARY, TEST, UNKNOWN
| history (string) |
| Mame history from www.arcade-history.com or progettoemma.net. |
There are two copyright entries (a long one and a short one) and you need to show one of the two contents somewhere, for example immediately below the text
|youtube_video_id (string)|| Youtube video ID (this will be checked also on parent if use_parent=1). |
You can add direct or embedded links like this:
|url_video_shortplay (string)|| Url of shortplay video file (mp4 format), empty if not present (this will be checked also on parent if use_parent=1). |
The video is encoded in mp4 format (h.264 + aac) at the game native resolution.
|url_video_shortplay_hd (string)|| Url of shortplay high-definition video file (mp4 format), empty if not present (this will be checked also on parent if use_parent=1). |
The video is encoded in mp4 format (h.264 + aac) and the resolution is scaled up to 1080p from original raw (uncompressed) video.
|emulator_id (int)||Internal emulator id, useful to check romset update.|
|emulator_name (string)||Name and release of the emulatore. Es. "Mame 0.189 (30-aug-2017)"|
|languages (string)|| Supported languages, comma separated values |
Values: Brazilian Portuguese, Chinese, Croatian, Dutch, English, French, German, Greek, Hungarian, Italian, Japanese, Korean, Polish, Russian, Slovak, Spanish, Swedish, Czech
Additional languages can be added in future.
|rate (int)||Medium game rating. Values starting from 0 (no rating) up to 100 (maximum rating) with steps of 1.|
|HISTORY OF CHANGES|
|release 1, sep-2017||Added new output data url, emulator_id, emulator_name, languages, rate and changed players from string to integer. Added this documentation page.|