Freigeben über

Tutorial: Lokales Debuggen für Cloudscript mit Azure Functions

  • Artikel

Mit Azure Functions können Sie Ihren CloudScript-Code jetzt lokal testen und debuggen. Nachdem Sie dieses Tutorial abgeschlossen haben, können Sie Ihre lokale Azure Functions-App unter dem Debugger ausführen (z. B. in VS Code oder Visual Studio), Ihre Haltepunkte festlegen und Ihren Spielclient ausführen.

In diesem Tutorial erfahren Sie Folgendes:

  • Hinzufügen einer Implementierung von ExecuteFunction zu Ihrer lokalen Azure Functions-App
  • Fügen Sie eine Einstellungsdatei hinzu, um das PlayFab SDK anzufordern, diese lokale Implementierung aus Ihrem Spiel aufzurufen.

Voraussetzungen

Hinzufügen einer lokalen Implementierung von ExecuteFunction

Für C#-Azure Functions-Apps

Um die lokale Implementierung von ExecuteFunction in Ihrer C#-Azure Functions-App einzurichten, fügen Sie die ExecuteFunction.cs-Datei ihrer lokalen Azure Functions-App hinzu.

Erforderliche Umgebungsvariablen für die lokale Implementierung von ExecuteFunction

Fügen Sie ihrer local.settings.json Datei die folgenden Einstellungen hinzu:

Name Wert
PLAYFAB_TITLE_ID Ihre Titel-ID im Hexax-Format
PLAYFAB_DEV_SECRET_KEY Geheimer Schlüssel für Ihren Titel. Sie können Ihre geheimen Schlüssel im Game Manager finden, indem Sie auf das Zahnradsymbol rechts neben dem Namen Ihres Titels klicken und zu Titeleinstellungen>Geheime Schlüssel wechseln.

Beispiel:

{
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "...",
    "FUNCTIONS_WORKER_RUNTIME": "dotnet",
    "PLAYFAB_TITLE_ID": "B55D",
    "PLAYFAB_DEV_SECRET_KEY": "AAAABBBBCCCCDDDDEEEEFFFFGGGGHHHHIIIIJJJJKKKKLLLLMM"
  }
}

Konfigurieren des PlayFab SDK zum Aufrufen der lokalen ExecuteFunction-Implementierung

Um das PlayFab SDK anweisen zu lassen, ExecuteFunction-API-Aufrufe an Ihre lokale Implementierung umzuleiten, fügen Sie eine Datei namens playfab.local.settings.json an einer von zwei Stellen hinzu:

  • Das temporäre Verzeichnis auf Ihrem Computer
    • Unter Windows ist dies die TEMP-Umgebungsvariable .
    • Unter Linux/Mac ist dies die TMPDIR-Umgebungsvariable .
  • Das Verzeichnis Ihrer ausführbaren Spieldatei

Legen Sie den Inhalt der Datei wie folgt fest:

{ "LocalApiServer": "http://localhost:<portNumber>/api/<functionName>" }

Wenn Sie lokale Umleitungen beenden und ExecuteFunction dazu bringen möchten, den PlayFab-API-Server aufzurufen, löschen Sie die playfab.local.settings.json Datei.

Weitere Ressourcen

Azure Functions enthält eine hervorragende Anleitung zum lokalen Testen und Debuggen Ihrer Funktionen.

Im Folgenden finden Sie einige Highlights aus dem obigen Dokument.