Tämä palauttaa käyttöominaisuusluokan satunnaisten elementtitunnusten listan kontekstissaan.
Kutsuja: Tavaraluettelon käyttöliittymä
HTTP-metodi: GET
Parametrit
| Nimi | Tyyppi | Pakollinen | Kuvaus |
|---|
| key | string | ✔ | Tämä on elementtipalvelimen tunnus, jonka annoit sovelluksesi kumppanisivulla Steam-talouden asetuksissa. |
| appid | uint32 | ✔ | 32-bittinen sovellustunnus (AppID) sovellukselle, joka liittyy elementteihin. |
| contextid | uint64 | ✔ | Elementin sisältävän kontekstin 64-bittinen tunnus. |
| asset_count | uint32 | ✔ | Pyydettävien elementtien lukumäärä. |
| asset# | uint32 | ✔ | Pyydettävä 64-bittinen elementtitunnus. Jokaiselle numerolle välillä 0 ja asset_count-1 on yksi parametri (esim. asset0, asset1, asset2). |
Paluuarvot
Metodin palautuksen tulisi olla koodattu JSON-muodossa.
Vastaus: -
result
-
success – True (tosi), jos metodi onnistui. Jos elementtipalvelin palauttaa false (epätosi), tulisi se määrittää error merkkijonoon, joka selittää sen syyn.
-
error – Kutsun epäonnistumista kuvaava stringi. Viesti tallennetan virhelokiin. Sinne pääsee Steamworks-sivuston Talous-välilehdeltä.
-
assets – Elementtiluokkatietojen taulukko erityiskontekstille ja elementtitunnuksille. Nämä ovat suurimmaksi osaksi samaa dataa kuin mitä GetContextContents/v0001 palauttaa, mutta niihin on lisätty omistaja-kenttä.
-
id – 64-bittinen elementin tunnus.
-
owner – Elementin omistajan SteamID-tunnus.
-
class – Pelin määrittämien elementtiluokan tunnisteiden taulukko. Pelin on määritettävä, mitkä nämä tunnisteet ovat. Niiden on vain annettava riittävästi tietoa elementtitietojen toistamiseksi (toisin sanoen kuvata, minkälainen esine on kyseessä), kun luokan tunnisteet välitetään takaisin GetAssetClassInfo/v0001. Jokaisessa tunnisteessa tulee olla seuraavat kentät:
-
name – Tämän luokkatunnisteen osan nimi.
-
value – Tämän luokkatunnisteosan arvo merkkijonona.
-
instance – Jos tämä on true (tosi), luokan tunnistetta pidetään "instanssidatana", eli se ei yleensä siirry esinevaihdossa eikä vaikuta esineen vaihtoarvoon. (Oletus: false (epätosi))
HUOMAA! Elementtiluokan ominaisuutta ei saa koskaan pitää instanssidatana, jos se vaikuttaa ennen kaikkea esineen market_hash_name-nimeen GetAssetClassInfo/v0001 -vastauksessa. Yhteisön kauppapaikan toiminta riippuu siitä, ettei instanssiominaisuuksilla ole mitään vaikutusta market_hash_name-nimeen.
Jotta voidaan maksimoida kuvaustietojen määrä, jotka Steam pystyy tallentamaan välimuistiin, luokan tunnisteiden pitäisi olla mahdollisimman yleisiä ja uudelleenkäytettäviä. Vältä esimerkiksi sellaisia luokkia, joissa on vain yksi ominaisuus, jolla on "itemid"-tyyppinen nimi, ja arvo, joka on elementin 64-bittinen tunnus. Kuvaile esinettä sen sijaan tarpeeksi rikkaalla tavalla, jotta saat tehtyä määrityksen. Esimerkiksi elementtiluokka "type" = "miekk" ja "rarity" = "common" antaa riittävästi tietoa kohteen kuvauksen luomiseen ilman, että on tiedettävä tarkalleen, mikä esineen instanssi on kyseessä.
-
amount (valinnainen) – Elementin pinolaskin. Käyttäjä voi vaihtaa pinosta enintään tämän määrän yksiköitä. (Oletus: 1)
Esimerkki koodista
{
"result": {
"assets": [
{
"id": 131363189,
"owner": 76561198029978818,
"class": [
{
"name": "def_index",
"value": "128"
},
{
"name": "quality",
"value": "3"
}
]
}
]
,
"success": true
}
}
