GetAssetClass/v0001 (Steamworks-dokumentation)

Steamworks-dokumentation

GetAssetClass/v0001

Steamworks-dokumentation > Funktioner > Steam-inventartjeneste > Steam-økonomi > GetAssetClass/v0001

Returnerer aktivklassen for en liste over tilfældige asset-ID'er i en kontekst.

Kaldes af: Inventargrænseflade

HTTP-metode: GET

Parametre:

Navn	Type	Påkrævet	Beskrivelse
key	string	✔	Dette er "nøglen til asset serveren", som du tildelte under din apps Steam-økonomiindstillinger på partnersiden.
appid	uint32	✔	32-bit app-ID for applikationen, som er forbundet med aktiverne.
contextid	uint64	✔	64-bit ID for konteksten, som aktiverne kan findes i.
asset_count	uint32	✔	Antallet af aktiver, som der anmodes om.
asset#	uint32	✔	64-bit asset-ID, der anmodes om. Der vil være en af disse parametre for hvert nummer mellem 0 og asset_count-1. (f.eks. asset0, asset1, asset2).

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 string, 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 med oplysninger om aktivklasser for den angivne kontekst og asset-ID'er. Dette er overvejende samme data, som returneres af GetContextContents/v0001 med tilføjelse af ejerfeltet.
  - id – 64-bit ID for aktivet.
  - owner – Steam-Id'et for ejeren af 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 oplysningerne generelt ikke overføres med genstanden i en byttehandel, og dermed berører det ikke 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å f.eks. 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)

Eksempeloutput

{ "result": { "assets": [ { "id": 131363189, "owner": 76561198029978818, "class": [ { "name": "def_index", "value": "128" }, { "name": "quality", "value": "3" } ] } ] , "success": true } }