เอกสาร Steamworks
GetAssetClass/v0001
จะคืนค่าคลาส Asset ให้แก่รายการของไอดี Asset ที่กำหนดเองได้ในบริบทกลับมาให้

ถูกเรียกโดย: Inventory UI

เมธอด HTTP: GET

พารามิเตอร์:

ชื่อประเภทที่ต้องการคำอธิบาย
keystringนี่คือ "คีย์เซิร์ฟเวอร์ทรัพยากรy" ที่คุณจัดไว้ให้ในการตั้งค่าระบบเศรษฐกิจของ Steam สำหรับแอปของคุณบนเว็บไซต์พันธมิตร
appiduint32ไอดีแอปประเภท 32 บิต ของแอปพลิเคชันที่เกี่ยวข้องกับทรัพยากรนั้น
contextiduint64ไอดีประเภท 64 บิตของบริบทที่จะพบทรัพยากรเหล่านี้ในนั้น
asset_countuint32จำนวนทรัพยากรที่ร้องขออยู่ในขณะนั้น
asset#uint32ไอดี Asset ประเภท 64 บิตที่ร้องขออยู่ในขณะนั้น โดยจะมีหนึ่งในพารามิเตอร์เหล่านี้สำหรับแต่ละหมายเลขระหว่าง 0 ถึง asset_count-1 (เช่น asset0, asset1, asset2)

คืนค่า

เอาต์พุตจากเมธอดนี้ควรถูกเข้ารหัสไว้ในรูปแบบของ JSON

คำตอบ:
  • result
    • success - True หากเมธอดประสบความสำเร็จ หากเซิร์ฟเวอร์ Asset คืนค่า false กลับมา ก็จะตั้งค่า error เป็นสตริงเพื่ออธิบายเหตุผลว่าเกิดอะไรขึ้น
    • error - สตริงอธิบายสาเหตุที่การเรียกนี้ล้มเหลว ข้อความดังกล่าวจะถูกบันทึกไว้ในรายการบันทึกความผิดพลาด ซึ่งจะสามารถใช้งานได้ใน แท็บระบบเศรษฐกิจ ในเว็บไซต์ของ Steamworks
    • assets - รายละเอียดอาร์เรย์ของคลาสของ Asset สำหรับบริบทและ Asset ID ที่ได้ระบุไว้ ซึ่งส่วนมากก็จะเป็นข้อมูลประเภทเดียวกันกับที่คืนค่ามาให้โดย GetContextContents/v0001 แต่จะมีช่องข้อมูลของเจ้าของเพิ่มเติมมาให้
      • id - ID ประเภท 64 บิตของ Asset
      • owner - SteamID ของผู้ครอบครอง Asset
      • class - อาร์เรย์ของตัวระบุคลาสของ Asset ที่ได้นิยามค่าเอาไว้ตามเกม โดยเกมจะกำหนดตัวระบุเหล่านั้นเองว่าจะให้เป็นอะไร โดยจะต้องเตรียมข้อมูลไว้ให้เพียงพอในการสร้างข้อมูลของ Asset ซ้ำอีกครั้ง (ซึ่งในที่นี้คือ การลงรายละเอียดว่าไอเท็มดังกล่าวเป็นไอเท็มประเภทอะไร) ในเวลาที่ตัวระบุได้ถูกส่งกลับเข้าไปใน GetAssetClassInfo/v0001 ตัวระบุแต่ละตัวควรจะประกอบไปด้วยช่องข้อมูลต่าง ๆ ดังต่อไปนี้:
        • name - ชื่อของส่วนประกอบส่วนนี้ของตัวระบุคลาส
        • value - ค่าเป็นสตริงของส่วนประกอบส่วนนี้ของตัวระบุคลาส
        • instance - หากเป็นค่า true จะถือว่าตัวระบุคลาสเป็น "ข้อมูลอินสแตนซ์", ซึ่งหมายความว่า โดยทั่วไปแล้วก็จะไม่ส่งเข้าไปพร้อมกับไอเท็มในเวลาแลกเปลี่ยน ดังนั้นจึงไม่เข้าไปเป็นส่วนหนึ่งของมูลค่าการแลกเปลี่ยนของไอเท็มดังกล่าว (Default: false)
          หมายเหตุ: คุณสมบัติคลาสของ Asset ที่สุดท้ายแล้วจะมีผลต่อmarket_hash_name ของไอเท็มใน GetAssetClassInfo/v0001 การตอบสนองนั้น ไม่ควรถูกคำนึงว่าเป็นข้อมูลอินสแตนซ์ โดยตลาดชุมชนจะต้องใช้คุณสมบัติของอินสแตนซ์ที่ไม่มีผลต่อ market_hash_name
        เพื่อเป็นการใช้งานข้อมูลคำอธิบายที่ Steam สามารถจะเก็บแคชไว้ให้ได้มากที่สุด ตัวระบุคลาสควรจะรับข้อมูลทั่วไปและสามารถใช้ซ้ำได้ให้มากที่สุดเท่าที่จะเป็นไปได้ ตัวอย่างเช่น ให้พยายามหลีกเลี่ยงคลาสที่มีคุณสมบัติเพียงค่าเดียวที่มาพร้อมกับชื่อ เช่น itemid และมีค่าที่เป็นไอดีประเภท 64 บิตของ Asset แต่ให้ทำเช่นนี้แทน คือ ให้อธิบายประเภทของไอเท็มในลักษณะที่ให้ข้อมูลมากพอที่จะเขียนคำอธิบาย ยกตัวอย่าง คลาสของ Asset ที่มี type = sword และ rarity = common จะให้ข้อมูลที่เพียงพอแก่คุณในการเขียนคำอธิบายไอเท็ม โดยไม่จำเป็นจะต้องรู้อย่างแน่ชัดว่าอินสแตนซ์ของไอเท็มนั้นคืออะไร
      • amount (ตัวเลือกเสริม) - จำนวนสแต็กของ Asset นี้ ผู้ใช้จะสามารถแลกเปลี่ยนได้จนกระทั่งจำนวนการแลกมีค่าตามที่ได้ระบุไว้ในสแต็กนี้ (ค่าเริ่มต้นคือ: 1)

ข้อมูลเอาต์พุตตัวอย่าง

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