In this How-to, we will fetch a single metadata entry from a leaderboard and output it to the console.
Prerequisites
- A LootLocker account and a created game
- A feature with at least one type of metadata
- An active Game Session
Fetching Metadata
When fetching a single metadata, you need to provide 3 things:
- A
ulid: (can be retrieved through the web console or in the SDK's depending on the feature) of the item to fetch metadata for- For example:
01J96M0BX1GGTPP2QDRCBV3FW2
- For example:
- A key: of the desired metadata
- For example:
icon
- For example:
- A source type
- One of the following: Progression, leaderboard, catalog_item, currency
Fetching the metadata
When fetching the metadata by key, you simply call the function and display or handle the data.
// Available sources are: reward, leaderboard, catalog_item, progression, currency,LootLockerMetadataSources sourceType = LootLockerMetadataSources.leaderboard;
// The ulid of the source you are trying to fetch metadata forstring sourceID = "01J96M0BX1GGTPP2QDRCBV3FW2";
// The key of the source that you want to fetchstring key = "info";
// Base64 can be set to content_type "application/x-redacted", use this to avoid accidentally fetching large data filesbool ignoreFiles = true;LootLockerSDKManager.GetMetadata(sourceType, sourceID, key, (response) =>{ if(response.success) { // If it succeeded, dispaly the fetched metadata in the console string value = ""; response.entry.TryGetValueAsString(out value); Debug.Log("Metadata result:"+ value); } else { // If it failed, output the error to the console Debug.Log(response.errorData.message); }}, ignoreFiles);Coming soon
curl -X GET 'https://api.lootlocker.io/game/metadata/source/catalog_item/id/{ulid}?key={value}&ignore_files={bool}' \ -H 'x-session-token: your_token_here' \Conclusion
In this How-to we’ve fetched a single metadata entry that was created in the web console. Apart from getting just one single data entry with metadata, you also have the possibility to Fetch metadata in game by tags or fetch metadata in game from multiple sources.
