Einrichten Ihrer ersten virtuellen Währung

Wichtig

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

Beginnen Sie mit PlayFab Economy, indem Sie das PlayFab Services SDK verwenden, um Ihre erste virtuelle Währung einzurichten. Nachdem Sie ein Entitätstoken für die Interaktion mit Ihrem Titel über die APIs erhalten haben, erstellen und konfigurieren Sie eine virtuelle Währung.

Voraussetzungen

• Ein PlayFab-Entwicklerkonto
• Das PlayFab Beta SDK (Weitere Informationen finden Sie im Postman-Schnellstart)

Abrufen eines Titelentitätstokens

Um Änderungen an Ihren Titelkonfigurationsdaten über die APIs vorzunehmen, müssen Sie zunächst ein Titelentitätstoken abrufen. Weitere Informationen finden Sie im Postman-Schnellstart

Erstellen einer neuen virtuellen Währung

Um eine neue virtuelle Währung zu erstellen, müssen Sie einen Artikelentwurf vom Typ Währung erstellen.

Game Manager

1. Navigieren Sie in Game Manager zur Registerkarte Wirtschaft , und wählen Sie Katalog (V2) aus.
2. Wählen Sie Währung und dann Neue Währung aus.
3. Bearbeiten Sie den Titel , und fügen Sie eine Beschreibung hinzu, Diamondsz. B. , Our in-game currency of choice..
4. Wählen Sie Speichern und veröffentlichen aus, um die Änderungen abzuschließen.
5. Beobachten Sie Ihre Währung in der Liste Währungen .

REST-API

Rufen Sie CreateDraftItem auf. Verwenden Sie den folgenden Text:

{
  "Item": {
    "CreatorEntity": {
      "Id": "{{TitleID}}",
      "Type": "title"
    },
    "Type": "currency",
    "AlternateIds": [
      {
        "Type": "FriendlyId",
        "Value": "diamonds"
      }
    ],
    "Title": {
      "NEUTRAL": "Diamonds"
    },
    "Description": {
      "NEUTRAL": "Our in-game currency of choice."
    },
    "StartDate": "2023-07-27T00:00:00.000Z",
  },
  "Publish": true,
  "CustomTags": {
    "user": "{{Email}}"
  }
}

• ist FriendlyId der Währungscode, der zwischen einem und drei alphanumerischen Werten enthalten kann.
• ist Title der Anzeigename, der den Spielern angezeigt wird.
• ContentType ist eine Kategorisierung von Economy-Elementen. Sie müssen zuerst den Inhaltstyp in ⚙️ > den Einstellungen für Titeleinstellungen > Economy > Catalog (V2) festlegen.
• StartDate ist eine datetime-Zeichenfolge, die angibt, wann die Währung für die Spieler sichtbar ist (Standard ist der Zeitpunkt der Erstellung).

Problembehandlung

• Fehlendes/abgelaufenes Entitätstoken
  • Wenn Sie versuchen, aufzurufen CreateDraftItem und eine 401: Unauthorized Fehlermeldung erhalten, haben Sie möglicherweise vergessen, ein Titelentitätstoken abzurufen, oder es ist möglicherweise abgelaufen.
• Der Inhaltstyp '' wird nicht unterstützt.
  • Wenn Sie versuchen, aufzurufen CreateDraftItem und eine CatalogBadRequest mit der obigen Meldung zu erhalten, müssen Sie zunächst einen Inhaltstyp auf der Registerkarte "Katalogeinstellungen" auf der Einstellungsseite Ihres Titels in Game Manager erstellen.

Nächste Schritte

Nachdem Sie Nun Ihre erste virtuelle Währung eingerichtet haben, können Sie:

1. Fügen Sie die Währung den PlayFab-Paketen hinzu, die Sie in App Stores verkaufen.
2. Lassen Sie den Spielserver die Währung an Ihre Spieler mit AddInventoryItems belohnen.
3. Weisen Sie Katalogartikeln Preise zu, die der Währung entsprechen.
4. Ermöglichen Sie Es Spielern, Katalogelemente mit der Währung mit PurchaseInventoryItems zu kaufen.