Schnellstart für Elemente (Legacy-Economy)

  • Artikel

Wichtig

Economy v1-APIs befinden sich im Wartungsmodus und erhalten keine neuen Features, nur Fehlerbehebungen. Die v1-APIs werden auf absehbare Zeit beibehalten. Weitere Informationen zur nächsten Version von PlayFab Economy finden Sie in der Übersicht über Die Wirtschaft v2 !

In der Schnellstartanleitung items finden Sie die Bausteine Ihrer Spielökonomie: virtuelle Währung, Kataloge, Elemente und Einkäufe.

In dieser Schnellstartanleitung gehen Sie folgendermaßen vor:

  • Richten Sie eine virtuelle Währung für Ihr Spiel ein.
  • Geben Sie einem Spieler virtuelle Währung.
  • Fügen Sie ihrem In-Game-Katalog ein Element hinzu.
  • Verwenden Sie PlayFab-APIs, um einen Artikel aus dem Katalog mit virtueller Währung zu kaufen.
  • Verwenden Sie Informationen im Game Manager, um zu bestätigen, dass der Kauf erfolgreich war.

Einrichten einer virtuellen Währung

PlayFab unterstützt eine robuste Spielökonomie mit mehreren Währungen und Gegenständen.

So greifen Sie auf diese Features zu und erstellen eine virtuelle Währung:

  1. Öffnen Sie Game Manager , und wählen Sie auf der linken Seite die Option Wirtschaft aus.
  2. Wählen Sie die Registerkarte Währung und dann Neue Währung aus (Öffnet den unten gezeigten Bildschirm Neue Währung ).
  3. Bearbeiten Sie diese Felder, um Ihre virtuelle Währung zu erstellen:
    • Legen Sie Währungscode (2 Großbuchstaben) auf GD fest.
    • Legen Sie Anzeigename auf Gold fest.
  4. Wählen Sie WÄHRUNG SPEICHERN aus.

Neue Währung speichern

Virtuelle Währung an einen Spieler geben

Sie können Spielern virtuelle Währung direkt geben. Als Beispiel fügen wir einem Spieler mit dem Game Manager Geld hinzu:

  1. Wählen Sie auf der linken Seitenleiste Spieler und dann die ID eines Spielers aus.
  2. Wechseln Sie zur Registerkarte Virtuelle Währung des Spielers.
  3. Wählen Sie die GD-Währung aus (Öffnet den unten gezeigten Bildschirm Virtuelle Währung ändern ).
  4. Ändern Sie den Betrag in 100.
  5. Wählen Sie VIRTUELLE WÄHRUNG SPEICHERN aus.

Währung ändern

Tipp

Es kann gefährlich sein, Clients die Möglichkeit zu geben, die AddUserVirtualCurrency-API aufzurufen. Informationen zum Festlegen von Einschränkungen für bestimmte APIs finden Sie unter API-Zugriffsrichtlinie.

Jetzt hat der Spieler 100 Gold. Was können sie damit tun? Kaufen Sie einen Artikel!

Hinzufügen eines Elements zu Ihrem In-Game-Katalog

Kein Sinn, Geld zu haben, wenn Sie es nicht ausgeben können!

Sie können Kataloge (eine Sammlung von Elementen) erstellen, die den Plattformen entsprechen, auf denen Sie Ihr Spiel veröffentlichen, oder Hauptversionsnummern - was Auch immer Sie möchten.

Tipp

Es wird nicht empfohlen, mehrere Kataloge zu erstellen, um die Typen von Elementen zu unterscheiden. Sie können Elemente mithilfe von Klassen, Tags und Speichern effektiver filtern.

So erstellen Sie einen Katalog mit einem Element

  1. Wählen Sie in der linken Leiste Wirtschaft und dann die Registerkarte Kataloge aus.
  2. Wählen Sie die Schaltfläche Neuer Katalog aus, und geben Sie Standard als Katalogversion ein. Ein Element mit der ID One wird automatisch hinzugefügt.
  3. Wählen Sie Eine aus (öffnet den unten gezeigten Bildschirm Katalogelement bearbeiten ). Bearbeiten Sie diese Felder:
    • Legen Sie die Element-ID auf Apple fest.
    • Legen Sie Anzeigename auf Apple fest.
    • Legen Sie Beschreibung auf Perfekt normaler Apfel fest.

Am unteren Rand des Formulars befindet sich der Abschnitt PREISE , in dem Sie definieren, wie viel ein Element in der virtuellen Währung Ihres Spiels kostet.

  1. Legen Sie den Preis des Apfels in Gold (GD) auf 5 fest.
  2. Wählen Sie ELEMENT SPEICHERN aus.

Zum Katalog hinzufügen

Kauf eines Artikels mithilfe einer virtuellen Währung

Lassen Sie uns die PlayFab-APIs verwenden, um einen Kauf in Ihrem Spiel zu tätigen.

  1. Melden Sie sich als der Spieler an, dem 100 Gold in virtueller Währung zugewiesen wurde (wie unter Geben virtueller Währung an einen Spieler beschrieben).
  2. Rufen Sie GetCatalogItems mit dem folgenden Parameter in der Anforderung auf:
    • CatalogVersion = "main"
  3. Vergewissern Sie sich, dass der Catalog im Ergebnis einen Apfel mit einem GD-Preis von 5 enthält.
  4. Erwerben Sie den Apfel, indem Sie PurchaseItem mit den folgenden Parameterwerten in der Anforderung aufrufen:
    • CatalogVersion = "main"
    • ItemId = "apple"
    • VirtualCurrency = "GD"
    • Price = 5
  5. Rufen Sie abschließend GetUserInventory auf, und sehen Sie sich das Ergebnis dieser Methode an. Im Array der Elemente im Inventar des Spielers sollte ein Apfel angezeigt werden!

Bestätigen, dass der Kauf erfolgreich war

So bestätigen Sie den Kauf in Game Manager:

  1. Wählen Sie in der linken Seitenleiste Spieler aus, um die Registerkarte Spieler zu öffnen.
  2. Wählen Sie die ID des Spielers aus, der den Artikel gekauft hat.

Zur Bestätigung:

  • Öffnen Sie die Registerkarte PlayStream . Es sollte ein Ereignis zum Kauf eines virtuellen Spielerwährungsartikels angezeigt werden.
  • Öffnen Sie die Registerkarte Bestand . Das Inventar sollte nun einen Apfel enthalten. Sie können auch Features auf der Registerkarte Bestand verwenden, um das Element zu widerrufen oder dem Spieler weitere Äpfel zu gewähren.
  • Öffnen Sie die Registerkarte Virtuelle Währung . Der Spieler sollte nur noch 95 Gold haben.