Lua-Schnellstart für Corona

  • Artikel

Dieser Schnellstart unterstützt Sie beim ersten PlayFab-API-Aufruf in der Corona-Engine.

Bevor Sie eine PlayFab-API aufrufen können, müssen Sie über ein PlayFab-Entwicklerkonto verfügen.

Einrichtung des Corona-Projekts

Betriebssystem: Diese Schnellstartanleitung wurde für Windows 10 geschrieben. Es sollte jedoch auch mit einem Mac gut funktionieren.

  1. Herunterladen und Installieren von Corona: https://coronalabs.com/.

  2. Führen Sie Corona aus, und erstellen Sie ein neues Projekt. Der folgende Link enthält Informationen, die Sie bei ihren ersten Schritten unterstützen können, wenn Sie sie noch nicht ausgeführt haben: https://docs.coronalabs.com/guide/start/installWin/index.html

  3. Nachdem Sie ein neues Projekt installiert, angemeldet und erstellt haben, sollten mehrere Fenster angezeigt werden, die in etwa wie das unten gezeigte Beispiel aussehen.

    Installieren des PlayFab SDK

  4. Aktivieren Sie das PlayFab-Client-Plug-In im Corona Marketplace:

    https://marketplace.coronalabs.com/plugin/playfab-client

  5. Die PlayFab-Installation ist abgeschlossen!

Einrichten Ihres ersten API-Aufrufs

Dieser Leitfaden enthält die Mindestschritte, die für Ihren ersten PlayFab-API-Aufruf erforderlich sind. Die Bestätigung wird im Ausgabeprotokoll der Corona-Engine angezeigt.

Fügen Sie in Ihrem bevorzugten Text-Editor die folgenden Zeilen zu hinzubuild.settings.

settings =
{
    -- ADD THESE THREE LINES at the top, leave everything else as-is
    plugins = {
        ["plugin.playfab.client"] = { publisherId = "com.playfab" }
    },

-- Other existing lines...
}

Notiz

Informationen zum Suchen des richtigen Formats für das loginRequest-Objekt in diesem Beispiel finden Sie in der API-Referenz für LoginWithCustomID.

Ersetzen Sie in Ihrem bevorzugten Text-Editor den Inhalt der Datei Standard.lua durch die unten gezeigten Inhalte.

local pfClient = require("plugin.playfab.client")
local PlayFabClientApi = pfClient.PlayFabClientApi
PlayFabClientApi.settings.titleId = "144"

local loginRequest = {
    -- See the API reference for LoginWithCustomID.
    CustomId = "GettingStartedGuide",
    CreateAccount = true
}
PlayFabClientApi.LoginWithCustomID(loginRequest,
    function(result) print("Congratulations, you made your first successful API call!") end,
    function(error) print("Something went wrong with your first API call.\nHere's some debug information:\n" .. error.errorMessage) end
)

Fertig stellen und ausführen

Corona führt die Projektquelle beim Speichern automatisch aus. Sobald Sie also diese beiden Dateien aktualisieren und speichern, sollte Folgendes angezeigt werden:

Herunterladen des Corona-Plug-Ins - Fertig stellen und ausführen

An diesem Punkt können Sie damit beginnen, andere API-Aufrufe auszuführen und Ihr Spiel zu erstellen. Eine Liste aller verfügbaren Client-API-Aufrufe finden Sie in unserer Dokumentation zu PlayFab-API-Referenzen .

Wir wünschen viel Vergnügen bei der Codeerstellung!

Dekonstruieren des Codes

In diesem optionalen letzten Abschnitt wird jeder Teil des obigen Beispiels Zeile für Zeile beschrieben.

  • build.settings
    • plugins = {
      • Dadurch wird das Corona-Plug-In-System aufgerufen und es aufgefordert, Die Corona Marketplace-Plug-Ins in Ihrem Projekt herunterzuladen und zu installieren.
    • ["plugin.playfab.client"] = { publisherId = "com.playfab" }
      • Dadurch wird es aufgefordert, das PlayFab-Client-Plug-In speziell herunterzuladen.
  • Standard.lua
    • require()-Zeilen:
      • Dies sind die minimalen Importe, die Sie für PlayFab-API-Aufrufe benötigen.
    • PlayFabClientApi.settings.titleId = "xxxx"
      • Jeder PlayFab-Entwickler erstellt einen Titel in Game Manager. Wenn Sie Ihr Spiel veröffentlichen, müssen Sie diese titleId in Ihr Spiel codieren. Dadurch kann der Client wissen, wie auf die richtigen Daten in PlayFab zugegriffen werden kann. Für die meisten Benutzer ist es nur ein obligatorischer Schritt, der PlayFab funktioniert.
    • local loginRequest = { CustomId = "GettingStartedGuide", CreateAccount = true }
      • Die meisten PlayFab-API-Methoden erfordern Eingabeparameter, und diese Eingabeparameter werden in ein Anforderungsobjekt gepackt.
      • Jede API-Methode erfordert ein eindeutiges Anforderungsobjekt mit einer Mischung aus optionalen und obligatorischen Parametern.
        • Für LoginWithCustomIDRequestgibt es einen obligatorischen Parameter von , der CustomIdeinen Spieler eindeutig identifiziert, und CreateAccount, der die Erstellung eines neuen Kontos mit diesem Aufruf ermöglicht.
    • PlayFabClientApi.LoginWithCustomID(loginRequest, {OnLoginSuccess-function}, {OnLoginError-function})
      • Dadurch wird die asynchrone Anforderung an LoginWithCustomIDgestartet, die bei Erfolg den ersten (OnLoginSuccess) Rückruf oder die zweite (OnLoginError) -Funktion für Fehler aufruft.
    • Für die Anmeldung sollten die meisten Entwickler eine geeignetere Anmeldemethode verwenden.
      • Eine Liste aller Anmeldemethoden und Eingabeparameter finden Sie in der Dokumentation zur PlayFab-Anmeldung . Häufig sind folgende Optionen verfügbar:
      • OnLoginSuccess ist eine beliebige Funktion, die einen einzelnen Parameter (Result) akzeptiert.
        • Das Ergebnisobjekt enthält die angeforderten Informationen gemäß der aufgerufenen API.
        • LoginResult enthält einige grundlegende Informationen zum Spieler, aber für die meisten Benutzer ist die Anmeldung einfach ein obligatorischer Schritt vor dem Aufrufen anderer APIs.
      • OnLoginError ist eine beliebige Funktion, die einen einzelnen Parameter akzeptiert (Fehler).
        • API-Aufrufe können aus vielen Gründen fehlschlagen, und Sie sollten immer versuchen, Fehler zu behandeln.
        • Warum API-Aufrufe fehlschlagen (In der Reihenfolge der Wahrscheinlichkeit):
          • PlayFabSettings.TitleId ist nicht festgelegt. Wenn Sie vergessen, auf Ihren Titel festzulegen titleId , funktioniert nichts.
          • Anforderungsparameter. Wenn Sie nicht die richtigen oder erforderlichen Informationen für einen bestimmten API-Aufruf angegeben haben, tritt ein Fehler auf. Weitere Informationen finden Sie unter error.errorMessage, error.errorDetailsoder error.GenerateErrorReport() .
          • Gerätekonnektivitätsproblem. Mobiltelefone verlieren ständig die Konnektivität bzw. erhalten sie wieder, sodass jeder API-Aufruf zu einem beliebigen Zeitpunkt nach dem Zufallsprinzip fehlschlagen kann und dann sofort danach funktioniert. Wenn Sie in einen Tunnel gehen, können Sie vollständig getrennt werden.
          • PlayFab-Serverproblem. Wie bei der gesamten Software kann es Probleme geben. Informationen zu Updates finden Sie in unseren Versionshinweisen .
          • Das Internet ist nicht 100% zuverlässig. Manchmal ist die Nachricht beschädigt oder kann den PlayFab-Server nicht erreichen.
        • Wenn Sie Probleme beim Debuggen eines Problems haben und die Informationen in den Fehlerinformationen nicht ausreichen, besuchen Sie uns bitte in unseren Foren.