GetAssetClass/v0001 （Steamworks 文献库）

Steamworks 文献库

GetAssetClass/v0001

Steamworks 文献库 > 功能 > Steam 库存服务 > Steam 经济体 > GetAssetClass/v0001

此 API 为上下文中的一组任意资产 ID 返回资产类。

调用方： 库存 UI

HTTP 方法： GET

参数：

名称	类型	是否必需	描述
key	string	✔	这是在合作伙伴网站上，您在自己应用的 Steam 经济体设置中提供的“资产服务器密钥”。
appid	uint32	✔	与资产相关联的应用程序的 32 位 App ID。
contextid	uint64	✔	资产所在的上下文的 64 位 ID。
asset_count	uint32	✔	请求的资产数量。
asset#	uint32	✔	请求的 64 位资产 ID。在 0 和 class_count-1 之间的每个数字都有一个这类参数（如 asset0、asset1、asset2）。

此方法的输出应为 JSON 格式。

响应：

result
- success - 如果方法成功，为 true。如果资产服务器返回 false，应将 error 设置为解释原因的字符串。
- error - 描述为何此调用失败的字符串。这条消息将记录入错误日志，可在 Steamworks 站点的“经济体”选项卡下查看。
- assets - 指定的上下文与资产 ID 的一组资产类详情。这与 GetContextContents/v0001 返回的数据非常相似，但添加了所有者字段。
  - id - 资产的 64 位 ID。
  - owner - 资产所有者的 steamid。
  - class - 一组游戏定义的资产类标识符。由游戏定义这些标识符，在类标识符传回 GetAssetClassInfo/v0001 时，只需提供足以重现资产信息的信息（比如描述这是哪种物品）。各标识符应该包含以下字段：
    - name - 类标识符中此部分的名称。
    - value - 类标识符中的此部分作为字符串的值。
    - instance - 若为 true，类标识符被视为“实例数据”，意为通常不在交易中与物品一起转移，因此在物品的交易值中不予考虑。（默认为 false。）
      注意：在 GetAssetClassInfo/v0001 响应中最终对物品的 market_hash_name 有影响的资产类属性绝不能作为实例数据。社区市场的运行取决于对 market_hash_name 无任何影响的实例属性。
    为了使 Steam 能尽量多地缓存描述信息，类标识符应尽可能通用并可重复使用。例如，要避免使用只有一个名称为“itemid”，值为资产的 64 位 ID 的属性的类。您应该对物品详加形容，以提供足够信息生成描述。例如，"type" = "sword" 与 "rarity" = "common"的资产类能提供足够的信息，生成物品描述，而您不必知道物品的具体实例是哪一个。
  - amount（可选）- 此资产的堆栈数量。用户能在此堆栈中最多交易此单位数量。（默认为 1。）

输出示例

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