Freigeben über

Schnellstart: Hinzufügen Ihres ersten Elements zum Inventar eines Spielers

  • Artikel

Wichtig

Economy v2 ist jetzt allgemein verfügbar. Unterstützung und Feedback erhalten Sie im PlayFab-Forum.

Machen Sie sich mit Spielerbeständen vertraut, indem Sie das PlayFab Beta SDK verwenden, um einen Artikel zu kaufen und zu überprüfen, ob es dem Inventar Ihres Spielers hinzugefügt wurde. Nachdem Sie ein Entitätstoken für die Interaktion mit Ihrem Titel über die APIs erhalten haben, suchen Sie nach einem Artikel in Ihrem Katalog, kaufen den Artikel und rufen dann den Bestand des Spielers ab, um den gekauften Artikel zu finden.

Voraussetzungen

Melden Sie sich als Spieler an.

Sie müssen sich zunächst beim Player anmelden, um das Sicherheitstoken zu erhalten, das für die restlichen API-Aufrufe in dieser Schnellstartanleitung erforderlich ist. Weitere Informationen finden Sie auf der Seite Player-Authentifizierung .

Suchen nach dem Element

Um das Element im Katalog zu finden, müssen Sie aufrufen Search. Im Anruftext:

{
  "Search": "[Item Title]",
  "Top": 1
}
  • ist Search die Suchzeichenfolge, die anhand des Titels, der Beschreibung und der Schlüsselwörter jedes Elements in Ihrem Katalog Fuzzy durchsucht wird.
  • Top ist eine ganze Zahl, die bestimmt, wie viele Ergebnisse zurückgegeben werden sollen. In diesem Fall benötigen wir nur ein Ergebnis.

Notiz

Es gibt zusätzliche Felder, über die Sie sich im Schnellstart suchen informieren können.

Greifen Sie in der Antwort auf die folgenden Felder zu:

  • Items > Id – Katalog-ID des Elements
  • Items > PriceOptions > Prices > Amounts > ItemId - ID der virtuellen Währung, die zum Kauf des Artikels verwendet wird
  • Items > PriceOptions > Prices > Amounts > Amount - Betrag der virtuellen Währung, die für den Kauf des Artikels erforderlich ist

Notiz

Nur Titelentitäten können Preise für Elemente festlegen.

Artikel kaufen

Rufen Sie PurchaseInventoryItemsauf, um den Artikel zu kaufen. Im Anruftext:

{
  "Item": {
    "Id": "{{ItemID}}",
  },
  "Amount": 1,
  "PriceAmounts": [
    {
      "ItemId": "{{CurrencyId}}",
      "Amount": 15
    }
  ]
}
  • ist Item.Id die ID des Elements (aus der Search Antwort im vorherigen Schritt abgerufen)
  • Ist Amount die Anzahl der Gegenstände, die der Spieler kauft.
  • ist ItemId die ID der virtuellen Währung, die zum Kauf des Artikels verwendet wurde (aus der Search Antwort im vorherigen Schritt abgerufen).
  • ist Amount der Betrag der virtuellen Währung, die zum Kauf des Artikels benötigt wird (aus der Search Antwort im vorherigen Schritt abgerufen).

Abrufen der Inventarelemente des Spielers

Sehen Sie sich den neu erworbenen Artikel des Spielers über an GetInventoryItems. Stellen Sie im Aufruf sicher, dass der Text leer ist. Sie können die Entität im Text angeben, ist aber nicht erforderlich, da die Informationen bereits über das Entitätstoken im Header übergeben werden.

Die Antwort enthält IDs jedes Elements, das der Spieler besitzt, und die Menge der einzelnen Elemente. Der neu gekaufte Artikel befindet sich im Inventar des Spielers.

Notiz

Wenn der Spieler diesen Artikel bereits im Bestand mit demselben StackIdhat, wird nach dem Kauf kein weiterer Artikel instance angezeigt. Stattdessen wird das Amount Feld einfach vergrößert.

Problembehandlung

  • Unzureichende Geldmittel
    • Wenn Sie aufrufen PurchaseInventoryItems und eine 422: InsufficientFunds Fehlermeldung erhalten, verfügt der Spieler nicht über genügend virtuelle Währung, um den Artikel zu kaufen. Sie können dem Spieler virtuelle Währung gewähren, indem Sie aufrufen AddInventoryItems (erfordert ein Titelentitätstoken) oder im Game Manager zu [Titel]>Spieler>[Spieler]>Inventory (V2) navigieren.
  • Der Artikel kann nicht zum angegebenen Preis erworben werden.
    • Wenn Sie aufrufen PurchaseInventoryItems und einen 1071 Fehlercode erhalten, stimmt das PriceAmounts Feld nicht mit den im Katalog angegebenen Preisen überein.

Nächste Schritte

Nachdem Sie nun den ersten Artikel des Spielers gekauft haben, können Sie den Artikel nutzen. Sie können den Artikel einem Store hinzufügen, um ihn zum Verkauf zu bringen, und Sie können ein Paket erstellen und kaufen, das den Artikel enthält.

Tutorial zur Spielerinventur

Stores

Pakete