Handel

Die PlayFab-Client-API ermöglicht es Spielern, Gegenstände miteinander zu handeln. Diese API-Methoden sind standardmäßig aktiviert, sodass Sie für die Sicherheit Ihres Titels möglicherweise unsere Richtlinien-API verwenden müssen, um sie zu deaktivieren.

Notiz

Die Bestandshandel-Funktionalität befindet sich in einer Vorschauphase. Die Methoden sind funktionsfähig, aber es fehlen einige nützliche Elemente, die sie zu einem vollständigen Feature machen würden. Derzeit können Sie nur virtuelle Artikel handeln. Sie können keine virtuelle Währung anfordern oder handeln, und PlayFab stellt keine Liste von Trades bereit, die Ihnen von anderen Spielern zur Verfügung stehen. Handelsmethoden sind nur in der Client-API und nicht über die Server-API verfügbar.

Hauptkonzepte

Katalog – Kataloge bieten eine einfache Möglichkeit, die virtuellen Artikel Ihres Spiels zu verwalten. Es handelt sich um Auflistungen aller Elemente, die in Ihrem Spiel verfügbar sind.

Katalogelemente : PlayFab-Elemente können so gut wie jede Art von virtuellen Gütern darstellen, die Sie verwenden könnten – von Langlebigen über Bündel bis hin zu gesperrten Containern.

Bestand : Alle Konten (Spielerkonten und Zeichenkonten) verfügen über einen Bestand. Der Bestand enthält alle besitzereigenen Elementinstanzen sowie den Elementverlauf.

Virtuelle Währung – PlayFab bietet bis zu 10 virtuelle Währungen pro Titel. Währungen können verwendet werden, um Artikel aus einem Katalog oder Store zu kaufen, können weiche Währungen darstellen, die aus In-App-Käufen konvertiert werden, oder sie können als Mechanik verwendet werden, um das Gameplay zu fördern.

Voraussetzungen

Der Handel erfordert Vertrautheit mit Katalog- und Bestandsartikeln. Spieler müssen Inventarartikel besitzen, die sie handeln möchten.

APIs

Der Handelsflow wird von einer Handvoll APIs verarbeitet:

OpenTrade
Öffnet einen neuen ausstehenden Handel. Dies kann zwischen zwei bestimmten Spielern (PlayfabIDs) oder mit einem Spieler, der einen Handel öffnet, der für jeden offen ist. Verstehen Sie, dass sich ein einzelnes element instance nur in einem offenen Handel zu einem Zeitpunkt sein kann.

GetTradeStatus
Ermöglicht es einem Client, einen bestimmten Trade auszuwerten, indem er seine aktuelle status erhält.

AcceptTrade
Akzeptiert einen offenen Handel. Wenn der Aufruf erfolgreich ist, werden die angebotenen und akzeptierten Elemente zwischen den Inventaren der beiden Spieler getauscht.

CancelTrade
Bricht einen offenen Trade ab. Beachten Sie, dass nur der Spieler, der den Trade erstellt hat, ihn über diesen API-Aufruf abbrechen kann, um Trauer zu verhindern.

GetPlayerTrades
GetPlayerTrades gibt alle Trades zurück, die ein Spieler entweder geöffnet oder akzeptiert hat, optional gefiltert nach Trade status.