steam_ugc_request_item_details(published_file_id, max_age_seconds);
| Argument | Description |
|---|---|
| published_file_id | The unique file ID for the UGC to be checked. |
| max_age_seconds | The "age" of the data to check (recommended 30 - 60 seconds). |
Returns: Async ID
This function can be used to retrieve information about a given file ID. You give the file ID and supply a maximum age for checking (see the Steam docs for more information), then the function returns a unique async ID value which can be used to check the details correctly in the Steam Async event. This event will have the async_load DS map which will be populated with the following key/value pairs:
- "id" - The async ID returned by the function that triggered the event
- "result" - The result of the operation (a real value). This will either be the GML constant ugc_result_success or some other real number. So you should check for this constant to ensure that the call was successful, and if otherwise somthing has not worked correctly. The rest of the possible values returned are shown as the result of the Steam "EResult" value and you should see steamclientpublic.h in the SDK headers for all 89 possible values.
- "event_type" - The string "ugc_item_details"
- "cached_data" - Will be true if the returned details are from the local cache or false if they are taken from the server
- "published_file_id"" -Holds the unique published file id for the item
- "file_type" - The type of file used
- "creator_app_id" - The Steam ID of the item creator
- "consumer_app_id" - The Steam ID of the item consumer
- "title" - The title of the item
- "description" - The description of the item
- "steam_id_owner" - The Steam ID of the item owner
- "time_created" - The time the item was first created
- "time_updated" - The last time the item was updated
- "time_added_to_user_list" - The time that the item was subscribed to
- "visibility" - The visibility of the item (see steam_ugc_set_item_visibility() for the returned constants)
- "banned" - Whether the item has been banned (true) or not (false)
- "accepted_for_use" - Whether the item has been accepted for use (true) or not (false)
- "tags_truncated" - Short version of the tags as an array
- "tags" - An array of the tags for the item
- "handle_file" - The unique file handle for the item
- "handle_preview_file" - The unique handle for the image preview for the item (can be used as an argument with steam_ugc_download() to download a preview image)
- "filename" - The name of the item file
- "file_size" - The size of the item file
- "preview_file_size" - The size of the preview image
- "url" - The full URL for the item
- "votes_up" - The number of up-votes received
- "votes_down" - The number of down-votes received
- "score" - The overall score of the item
- "account_id_owner" - The account ID from the Steam ID owner (this can be used in the function steam_ugc_create_query_user_ex())
In this example we send off a details request for an item and then parse the resulting async_load DS map to set some variables. First we send of the request:
steam_details =
steam_ugc_request_item_details(global.fileID, 60);
The above code will request details on the item with the file ID stored in the global variable and will trigger a Steam Async event with the returned information. In this event we can then parse the map and store some of the values in variables which can then be used to display the information to the user:
var map_id = async_load[? "id"];
var result = async_load[? "result"];
if (map_id == steam_details) && (result ==
ugc_result_success)
{
mTitle = async_load[? "title"];
mDesc = async_load[? "description"];
mTags = async_load[? "tags"];
m_hPreviewFile = async_load[?
"handle_preview_file"];
m_hOwnerSteamId = async_load[?
"steam_id_owner"];
mOwnerAccountId = async_load[?
"account_id_owner"];
mPubFileId = async_load[?
"published_file_id"];
mScore = async_load[? "score"];
}