Integrieren des PlayFab GSDK in Unity

Die Multiplayerserver-Plattform bietet eine GSDK-Bibliothek, die Sie in Ihren Unity-Spielserver integrieren können. Die Bibliothek ist Open Source und finden Sie im GSDK-Repository auf GitHub.

Installation

Sie können den Ordner Assets/PlayFabSdk in Ihr Unity-Projekt kopieren. Danach müssen Sie die Skriptdirektive ENABLE_PLAYFABSERVER_API für Ihre Unity-Buildeinstellungen aktivieren (Beispiel). Alternativ können Sie die bereitgestellte Unity-Paketdatei verwenden. Beispielcode finden Sie im Projekt MultiplayerServerSample .

Nutzung

Sie müssen mindestens die -Methode implementieren PlayFabMultiplayerAgentAPI.Start() und eine Coroutine für die PlayFabMultiplayerAgentAPI.ReadyForPlayers() -Methode starten, wie im folgenden Code.

//...
StartCoroutine(ReadyForPlayers());
//...

private IEnumerator ReadyForPlayers()
{
    yield return new WaitForSeconds(.5f);
    PlayFabMultiplayerAgentAPI.ReadyForPlayers();
}

Sie sollten sich auch für den Zeitpunkt registrieren, an dem der Spielserver zu Aktiv wechselt, indem Sie verwenden, PlayFabMultiplayerAgentAPI.OnServerActiveCallbackwie im folgenden Beispiel gezeigt:

PlayFabMultiplayerAgentAPI.OnServerActiveCallback += OnServerActive;
// ...
private void OnServerActive()
{
    Debug.Log("Server Started From Agent Activation");
    // players can now connect to the server
}

Notiz

Weitere Informationen zu Spielserverzuständen finden Sie hier im Abschnitt Grundlagen eines PlayFab-Spielservers.

Darüber hinaus können Sie die folgenden Rückrufe auf Ihrem Spielserver implementieren:

• PlayFabMultiplayerAgentAPI.OnMaintenanceCallback wird ausgelöst, wenn Azure eine Wartung auf dem virtuellen Computer durchführen muss
• PlayFabMultiplayerAgentAPI.OnShutDownCallback wird ausgelöst, wenn eine Beendigungsbenachrichtigung empfangen wird
• PlayFabMultiplayerAgentAPI.OnAgentErrorCallback wird ausgelöst, wenn zwischen dem Spielserver und der Kommunikation mit dem PlayFab-VM-Agent ein Fehler auftritt.

Notiz

Weitere GSDK-Beispiele finden Sie in unserem MPS-Beispielrepository hier.