Steamworks ドキュメンテーション
GetContextContents/v0001
これは、ユーザーの特定のコンテキスト内のすべてのアセットと通貨を返します。

呼び出し元: トレーディングUI、インベントリUI

HTTPメソッド: GET

パラメーター:

名前必須説明
keystringこれは、パートナーサイトで、アプリのSteamエコノミー設定で指定した「アセットサーバーキー」です。
appiduint32アセットに関連付けられたアプリケーションの32ビットAppID
steamiduint64アセットを返すユーザーの64ビットSteam ID
contextiduint64アセットを返すコンテキストの64ビットID

戻り値

このメソッドからの出力はJSONフォーマットでエンコードされている必要があります。

応答:
  • result
    • success―メソッドが成功するとtrueを返します。 アセットサーバーがfalseと返すと、その理由を説明する文字列にerrorを設定します。
    • error - 呼び出しが失敗した理由を説明する文字列。 このメッセージは、Steamworksサイトのエコノミータブ内のエラーログに記録されます。
    • assets - 指定されたコンテキストの子アセットの配列
      • id - アセットの64ビットID
      • class - ゲームが定義したアセットクラス識別子の配列。 識別子についてはゲームが定義します。
        クラス識別子がGetAssetClassInfo/v0001に返された際に、
        アセット情報を再現するのに必要な情報(例:どのようなアイテムであるのか)を提供する必要があります。 各識別子には以下のフィールドが含まれています:
        • name - クラス識別子のこの部分の名前
        • value - 文字列としてのクラス識別子のこの部分の値
        • instance - trueの場合、そのクラス識別子は 「インスタンスデータ」であると判断されます。これは
          一般にトレード時にアイテムとともに引き渡されることはなく、そのためアイテムの取引値には含まれません。
          (既定値:false)
          注意:GetAssetClassInfo/v0001レスポンス内のアイテムのmarket_hash_nameに最終的に影響を与えるアセットクラスのプロパティを、インスタンスデータとするべきではありません。 コミュニティマーケットはmarket_hash_nameに影響しないインスタンスプロパティに依存します。
        Steamがキャッシュ可能な説明の情報量を最大化するには、クラス識別子はできる限り普遍的かつ再利用可能なものである必要があります。 たとえば、「itemid」のような名前のプロパティを1つだけ持ち、そしてその値がアセットの64ビットIDであるといったクラスは避けるべきでしょう。 その代わりに、説明が作成できるぐらい十分な情報を提供する形で、それがどのようなアイテムなのかを記述してください。 たとえば、アセットクラスの「type」=「sword」、そして「rarity」=「common」であれば、そのアイテムの正確なインスタンスを知らなくても、アイテムの説明を作ることができます。
      • amount(オプション)- このアセットのスタック数。 ユーザーはこのスタックで最大この数までのトレードが可能です。 (既定値:1)
    • currency (オプション)- このコンテキストに含まれる通貨タイプの配列。 ユーザーが特定の通貨を持たない場合で、ゲーム内UIに表示される場合にのみ、ここに含める必要があります。 通貨の表示はアセットの表示と非常に似ているため、class、およびidフィールドを除き、上記にリストされているアセットのフィールドも通貨にも適用されます。 他のアセットフィールドに加え、以下の2つのフィールドも通貨に使用します:
      • id - このタイプの通貨に割り当てられた符号なし32ビットID。 このIDはゲーム内においてグローバルに固有でなければなりません。
      • amount - ユーザーが所有するこのタイプの通貨の額を表す64ビット整数

出力例

{ "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 } }