Freigeben über


C#-Beispiel für Windows Runner

In diesem Tutorial werden die Schritte zum Einrichten des Beispiels für die Verwendung mit den PlayFab Multiplayer-Servern aufgeführt.

Notiz

Um die PlayFab Multiplayer-Server verwenden und anzeigen zu können, müssen Sie das Feature über Game Manager aktivieren. Anweisungen finden Sie unter Aktivieren des PlayFab Server-Features.

  1. Api-Featureoption konfigurieren
  2. Erstellen eines PlayFab Multiplayer-Spielserverbuilds: Serversetup
  3. Erstellen von Servern durch Bereitstellen eines Builds
  4. Mehrspielerserver anfordern: Client wird eingerichtet. Dies ist erforderlich, damit Sie einen Client starten können, der eine Verbindung mit den Servern herstellt.

Api-Featureoption konfigurieren

Notiz

Dieser Schritt ist nur zum Ausführen dieses Beispiels erforderlich. Sie müssen Clients nicht erlauben, Spiele zu starten, es sei denn, Ihr Titel erfordert diese Einrichtung.

  • Melden Sie sich bei Ihrem Entwicklerkonto auf PlayFab.com an, um das Game Manager-Portal zu verwenden.
  • Wählen Sie Ihren Spieltitel aus.
  • Wählen Sie das Einstellungssymbol >API-Features aus, wie in der folgenden Abbildung dargestellt.

Registerkarte

  • Wählen Sie unter Optionen die Option Starten von Spielen durch den Client erlauben aus, wie in der abbildung unten gezeigt.

Auswählen von

Server einrichten

Beschreibt, wie Sie den PlayFab Multiplayer Game Server Build abrufen.

  • PlayFab Game Server SDK des PlayFab Multiplayer Server Build for the Windows Runner-Beispiels.

  • Wenn Sie dies lieber selbst erstellen möchten:

    • Rufen Sie das C#-Beispiel für Windows Runner mithilfe von Git-Standardmethoden ab, oder laden Sie es als ZIP-Datei herunter.
    • Öffnen Sie das Projekt mit Visual Studio 2017 oder höher. Dadurch sollten Abhängigkeiten wie das neueste NuGet-Paket des PlayFab Game Server SDK (GSDK) automatisch heruntergeladen werden.
    • Kompilieren und erstellen Sie windowsRunnerCSharp.csproj in release x64-Konfiguration. Sie erhalten einen Gameserver-Build, der in das GSDK integriert ist, sodass dies ein gültiger PlayFab Multiplayer Game Server Build ist.
    • Wechseln Sie zum Ordner bin, und zippen Sie alle Binärdateien der x64-Version. Es sollte keine interne Ordnerstruktur geben, die ZIP-Datei sollte eine einfache flache Sammlung von Dateien sein, wie in der folgenden Abbildung dargestellt.

    GSDK-Beispielausgabe

Tipp

Zur Kreuzüberprüfung können Sie Ihre Buildausgabe mit der kompilierten Version vergleichen, die oben im Link angegeben ist.

Wenn Sie über die ZIP-Datei verfügen, können Sie mit der Bereitstellung eines Builds beginnen.

Erstellen von Servern durch Bereitstellen eines Builds

Sie können einen Build mit einer der folgenden Methoden bereitstellen.

Bei einigen Einstellungen ist es möglicherweise einfacher, die Weboberfläche – Game Manager – zu konfigurieren.

Richten Sie als Nächstes den Client ein, und führen Sie diesen aus, um eine Verbindung mit den bereitgestellten Servern herzustellen.

Client-Einrichtung

Beschreibt, wie Die Windows Runner-Clientanwendung eine Verbindung mit den Spielservern herstellt, die Sie mithilfe von PlayFab Multiplayer-Servern erstellt haben. Dies kann nur eingerichtet werden, wenn Sich Server im Standbymodus befinden.

  • Warten Sie nach der Bereitstellung eines Builds, bis Standbyserver verfügbar sind.

  • Abrufen der titleId und buildId des Builds

    • Verwenden von Game Manager:

      • Wechseln Sie zur Seite Meine Studios und Titel , und suchen Sie nach Ihrem Spieltitel. Kopieren Sie den dort aufgeführten ID-Wert, und fügen Sie ihn an einer beliebigen Stelle ein, auf die Sie später zugreifen können. Dies ist die titleId.
      • Wählen Sie den Titel des Spiels aus, um die Dashboard
      • Wechseln Sie zuMultiplayer-Serverbuilds>>.
      • Kopieren Sie die ID für den Build, den Sie verwenden möchten, und fügen Sie ihn an einem geeigneten Ort ein. Dies ist die buildId.
    • Bei Verwendung von PowerShell werden diese Informationen in der Ausgabe angezeigt, nachdem der Build erfolgreich bereitgestellt wurde.

      • Kopieren Sie titleId und buildId , und fügen Sie sie an einem geeigneten Ort ein.
  • Rufen Sie das C#-Beispiel für Windows Runner mithilfe von Git-Standardmethoden ab, oder laden Sie es als ZIP-Datei herunter. Überspringen Sie, wenn Sie dies zuvor getan haben.

  • Öffnen Sie das Projekt mit Visual Studio 2017 oder höher. Dadurch sollten Abhängigkeiten wie das neueste Game Server SDK-NuGet-Paket automatisch heruntergeladen werden.

  • Kompilieren und Erstellen von WindowsRunnerCSharpClient.csproj in Release x64-Konfiguration

  • Öffnen Sie die Eingabeaufforderung, und navigieren Sie zum Ausgabeordner dieses Projekts.

  • Führen Sie windowsRunnerCSharpClient mithilfe dieser Befehlszeile aus, und <ersetzen Sie TitleId> und <BuildID> durch die oben genannten Werte: dotnet WindowsRunnerCSharpClient.dll --titleId <TitleId> --buildId <BuildId>

Beispiel:

cd C:\Users\UserName\Documents\GitHub\MpsSamples\WindowsRunnerCSharp\WindowsRunnerCSharpClient\bin\Release\netcoreapp3.1

dotnet WindowsRunnerCSharpClient.dll --titleId CBE66 --buildId 36083326-3bd5-4b8f-a97d-7e82f066aa40 --verbose

Wenn der Client erfolgreich eine Verbindung mit dem Server herstellt, zeigt die Eingabeaufforderung eine Protokollmeldung an, die Sie darüber informiert, dass ein Server mit einer IP-Adresse zugeordnet ist.

Weitere Informationen