Freigeben über

Economy v2 Stores

  • Artikel

Wichtig

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

Stores sind eine hervorragende Möglichkeit, auf Ihrer In-Game-Wirtschaft aufzubauen und zu entwickeln. Stores sind ein spezieller Artikeltyp, der eine Liste von Elementen und Preisen enthält und es Ihnen ermöglicht, die Basiskatalogpreise für Artikel außer Kraft zu setzen. Stores können verwendet werden, um zu verwalten, wo Gegenstände in Ihrem Spiel käuflich sind, Anbieten von Rabatten und Werbeaktionen im Spiel und vieles mehr!

Erstellen eines Stores

Um einen Store zu erstellen, müssen Sie zunächst sicherstellen, dass Sie über andere veröffentlichte Katalogelemente, Währungen oder UGC verfügen, die In Ihrem Spiel zugänglich/käuflich sein sollen. Sie können die Schritte im Schnellstart für Economy v2 ausführen.

  1. Navigieren Sie zu Economy>Catalog (V2).

  2. Wählen Sie auf der Registerkarte Stores die Option Neuer Store aus.

Geben Sie die gewünschten Metadaten ein. Eines der wichtigsten Punkte, die festgelegt werden müssen, sind die Elemente, die In diesem Store verfügbar sein sollen, und welche Preise Sie überschreiben möchten.

Bei dem oben genannten Handelt es sich um ein Geschäft, das zwei Artikel verkauft, und LaserSword .WeaponBundle Bei beiden Elementen handelt es sich um vorhandene Katalogelemente mit einem im Katalog definierten Grundpreis. Dieser Store überschreibt ihre bestehenden Preise und bietet jetzt die LaserSword für 1 Diamond und die WeaponBundle für 10 Gold und 10 Silber.

Diese Anforderung würde eine Antwort zurückgeben, dass der Speicher erstellt und veröffentlicht wurde:

{
  "code": 202,
  "status": "Accepted",
  "Item": {
    "Type": "store",
    "Id": "{{StoreID}}", 
    "Title": {
      "NEUTRAL": "My First Store",
    },
    ...
}

Beachten Sie die , die Id jetzt unserem veröffentlichten Store zugeordnet ist.

Notiz

Um das Konzept zu vereinfachen, wurden die Element-IDs von GUIDs in die Elementnamen getauscht, um das Beispiel für die Verwendung von Stores besser zu veranschaulichen.

Verwenden eines Store

Stores werden verwendet, wenn Spieler die PurchaseInventoryItems API aufrufen. Wenn Sie aufrufen PurchaseInventoryItems, ist eine der optionalen Eigenschaften ein StoreId Parameter, an den wir den Store übergeben können, den wir verwenden, um diese Kaufanforderung anzuwenden.

Eine Beispielanforderung PurchaseInventoryItems mit einem Speicher:

{
    "Entity": {
        "Type": "title_player_account",
        "Id": "{{PlayerID}}"
    },
    "Item": {
        "Id": "LaserSword",
    },
    "Amount": 10,
    "PriceAmounts": [
        {
            "ItemId": "Diamond",
            "Amount": 1
        }
    ],
    "StoreId": "{{StoreID}}"
}

Beachten Sie, dass {{StoreId}} in die Kaufanfrage übergeben wurde und wie das erwartete PriceAmount jetzt mit den 1 Diamantenkosten übereinstimmt, wie in unserem Store festgelegt.

Durchsuchen eines Stores

Wenn Sie die SearchItems API verwenden, ist eine der Eigenschaften, die Sie übergeben können, der Store -Parameter. Mit diesem Parameter können Sie im Kontext eines Speichers suchen. Zusätzlich zur Überprüfung, ob ein Artikel in einem bestimmten Geschäft vorhanden ist, kann es auch verwendet werden, um die überschriebenen Preise der Artikel/Inhalte des Stores anzuzeigen. Sie können auch die AlternateId des Speichers verwenden, um danach zu suchen.

{
  "Search": "",
  "Filter": "ContentType eq 'weapons'",
  "Store": {
    "Id": "{{StoreID}}"
  },
}