Steamworks-dokumentation
GetContextContents/v0001
Returnerer alle aktiver og valuta i en bestemt kontekst for en bruger.

Kaldes af: Byttegrænseflade, inventargrænseflade

HTTP-metode: GET

Parametre:

NavnTypePåkrævetBeskrivelse
keystringDette er "nøglen til asset serveren", som du tildelte under din apps indstillinger for Steam-økonomi på partnersiden.
appiduint3232-bit app-ID for applikationen, som er forbundet med aktiverne.
steamiduint6464-bit Steam-ID for den bruger, der skal returneres aktiver for.
contextiduint6464-bit ID for konteksten, der skal returneres aktiver for.

Returværdier

Resultatet fra denne metode er kodet i JSON-format.

Svar:
  • result
    • success – true, hvis metoden lykkedes. Hvis asset serveren returnerer false, bør den angive error til en streng, som forklarer hvorfor.
    • error – en streng, som beskriver, hvorfor dette kald mislykkedes. Denne besked vil blive optaget i en fejllog, som er tilgængelig under fanen "Økonomi" på Steamworks-siden.
    • assets – et array af aktiver, som er underordnet i forhold til den angivne kontekst.
      • id – 64-bit ID for aktivet.
      • class – et array af spildefinerede identifikatorer for aktivklasser. Det er op til spillet at definere, hvad
        disse identifikatorer er. De skal blot give tilstrækkelig information til at genskabe aktivoplysningerne
        (dvs. beskrive, hvilken slags genstand det er), når klasseidentifikatorerne sendes tilbage til GetAssetClassInfo/v0001. Hver identifikator skal indeholde følgende felter:
        • name – Navnet på denne del af klasseidentifikatoren.
        • value – Værdien af denne del af klasseidentifikatoren som streng.
        • instance – Hvis denne er true, betragtes klasseidentifikatoren som "instance data", hvilket betyder at den
          generelt ikke overføres med genstanden i en byttehandel, og dermed spiller den ikke ind i genstandens bytteværdi.
          (Standard: false)
          BEMÆRK: En aktivklasseegenskab, som vil påvirke market_hash_name for en genstand i GetAssetClassInfo/v0001-svaret, bør ikke betragtes som "instance data". Fællesskabsmarkedet afhænger af, at instance-egenskaber ikke påvirker market_hash_name..
        For at maksimere mængden af beskrivelsesoplysninger, som Steam kan cache-lagre, bør klasseidentifikatorer være så generiske og genbrugelige som muligt. Undgå for eksempel en klasse, hvor du kun har én egenskab med et navn såsom "itemid" og en værdi, som er aktivets 64-bit ID. Beskriv i stedet, hvilken slags genstand det er på en måde, som giver dig nok information til at bygge beskrivelsen. En aktivklasse med "type" = "sword" og "rarity" = "common" giver dig nok information til at bygge genstandens beskrivelse uden at skulle vide præcist, hvilken forekomst af genstanden det er.
      • amount (valgfri) – Antal af dette aktiv i stabel. Brugeren vil kunne bytte op til dette antal enhder fra denne stabel. (Standard: 1)
    • currency (valgfri) – Et array af valutatyperne, som denne kontekst indeholder. Hvis en bruger ikke har noget i en bestemt valutatype, skal denne parameter kun inkluderes her, hvis den vil være synlig i brugergrænsefladen i spillet. Valutavisningen ligner aktivvisningen meget, så felterne ovenfor for aktiver gælder også for valuta, undtagen felterne class og id. Ud over de andre aktivfelter bruges følgende to felter for valuta:
      • id – Det usignerede 32-bit ID, som er tildelt for denne slags valuta. Dette ID skal være globalt entydigt i spillet.
      • amount – 64-bit heltal, som repræsenterer beløbet i denne valuta, som ejes af brugeren.

Eksempeloutput

{ "result": { "assets": [ { "id": 131363189, "class": [ { "name": "def_index", "value": "128" }, { "name": "quality", "value": "3" } ] }, { "id": 131412933, "class": [ { "name": "def_index", "value": "155" }, { "name": "quality", "value": "3" } ] }, { "id": 556669733, "class": [ { "name": "def_index", "value": "583" }, { "name": "flags", "value": "1" }, { "name": "origin", "value": "1", "instance": true } ] }, ] , "success": true } }