Übersicht über den Multiplayer-Modus

• Destinations - Destinations sind konfigurierbare Orte in deiner App, die über die Gruppenpräsenz angezeigt werden können. In der Übersicht über Destinations erfährst du, wie du Destinations in deiner App einrichtest.
• Gruppenpräsenz – Enthält die folgenden Informationen, die von der App verwaltet werden:
  • In welcher App befindet sich ein*e Nutzer*in?
  • Nimmt er*sie an einem Spiel teil?
  • Befindet er*sie sich in einer Lobby?
  • Ist er*sie an einer bestimmten Destination?
  • Kann er*sie Nutzer*innen zu seinem*ihrer aktuellen Destination einladen?
• Einladung zur App – Lade Follower*innen und Nutzer*innen, mit denen du vor Kurzem gespielt hast, in bereits bestehende Lobbys ein.
• Aufstellung – Über die Aufstellung können Nutzer*innen sehen, welche Personen sich mit ihnen im Spiel befinden.
• Erneutes Beitreten – Mit dieser Funktion können Nutzer*innen entscheiden, ob sie nach einer Unterbrechung wieder in eine Sitzung mit Freund*innen aufgenommen werden möchten.
• Webhooks – Mit Webhooks kannst du in Echtzeit HTTP-Benachrichtigungen zu Änderungen erhalten, die für die Multiplayer-Erlebnisse in deiner App relevant sind.
• Einladungslink – Ein offener Einladungslink kann an beliebige Personen weitergegeben werden, damit sie gemeinsam eine App nutzen können.
• Schnelleinladungen – Mit Schnelleinladungen können Entwickler*innen Einladungen in ihr App-Erlebnis integrieren, ohne dass ein Meta Quest-Overlay erforderlich ist.

• Nutzerin A (Alice) startet die App.
  • Wenn die Anwendung regulär und nicht infolge einer Einladung gestartet wird, legt ein Event die Gruppenpräsenzinformationen fest.
    • Der Name der Destination-API wird auf die Standard-Destination „Lobby“ und -Karte festgelegt.
    • Da Alice die Lobby betritt und ihre Sitzungs-Lobby-ID noch nicht festgelegt hat, wird eine neue zufällige ID erstellt. In diesem Beispiel lautet diese „lobby_123“. Die Spielesitzungs-ID wird gelöscht.
  • Im nächsten Schritt wird die Transportschicht mit Photon eingerichtet. Wir treten einfach einem Raum bei oder erstellen einen Raum mit dem gleichen Namen wie die Lobby-Sitzungs-ID „lobby_123“. Da wir diesen neuen Namen gerade erst angelegt haben, ist sie die erste Person im Raum, der für sie erstellt wurde.
  • Da sie auf UE4-Ebene Masterclient ihres Photon-Raums ist, beginnt sie nun, den UE4-Server auf ihrem Headset zu hosten.
• Alice sendet Bob eine Einladung zu „lobby_123“.
  • Bob erhält die Einladung, entweder im Spiel oder in Horizon Home.
  • Wenn Bob die Einladung annimmt, wird die App mit einem Deeplink gestartet, der Alices Gruppenpräsenz enthält, einschließlich ihrer aktuellen Destination „Lobby“, der Lobby-Sitzung „lobby_123“ und ohne Spiel-ID.
  • Bobs Gruppenpräsenz wird aktualisiert, damit sie dieselbe Destination verwendet. Da es sich um eine Einladung zum Beitritt zu einer Lobby handelt, wird auch Bobs Lobby-ID so aktualisiert, dass sie mit der von Alice übereinstimmt.
  • Auf Photon-Ebene folgt Bob genau dem gleichen Ablauf: Er versucht, einen Raum namens „lobby_123“ zu erstellen oder ihm beizutreten. Da dieser bereits existiert, tritt er ihm einfach als normaler Client bei.
  • Auf der Ebene der Unreal Engine verbindet ihn die App mit Alice (aktueller Masterclient des Photon-Raums) als normaler Client.

• Bob betritt den blauen Raum.
  • Beim Betreten wird seine „match_ID“ auf die ID des blauen Raums gesetzt. Die ID dieses privaten Raums leitet sich von der Lobby ab, an den er angeschlossen ist (z. B. „BlueRoom_for_lobby_123“).
    • Der blaue Raum ist ein privater Raum, der mit Alices Lobby „lobby_123“ verbunden ist.
    • Nutzer*innen in einer bestimmten Lobby können jedem angeschlossenen privaten Raum beitreten. Wenn Bob beispielsweise dem Raum beitritt, wird der Photon-Raum erstellt oder dem Raum hinzugefügt, der nach seiner „match_session_ID“ benannt ist.
    • Wenn er die erste Person in diesem Raum ist, wird ein neuer Photon-Raum erstellt und er wird als aktueller Masterclient zugewiesen. Als Masterclient hostet Bob den entsprechenden UE4-Server auf seinem Headset. Bob initialisiert den UE4-Server, wird zum ersten Client des Servers und seine Startposition wird festgelegt.
• Alice betritt den blauen Raum.
  • Ihre Spiel-ID ist auf die ID des blauen Raums „BlueRoom_for_lobby_123“ eingestellt.
  • Sie verbindet sich mit dem Server von Bob, da Bob jetzt Host ist. (UE4)
  • Sie ist jetzt mit Bob gleichzeitig anwesend.
  • Sie teilen sich dieselbe Lobby-ID „lobby_123“ und dieselbe Spiel-ID „BlueRoom_for_lobby_123“.

• Im blauen Raum öffnet Alice die Aufstellung.
  • Sie und Bob sind im selben Team, da beide dieselbe Lobby-ID „lobby_123“ haben.
• Alice klickt auf die Schaltfläche zum Einladen unten in der Ansicht mit der Aufstellung, wodurch die Ansicht zum Einladen geöffnet wird.
• Anschließend wählt sie Charlie aus der Ansicht zum Einladen aus.
• Charlie erhält die Einladung und kann sie von überall auf dem Meta Quest-Headset annehmen.
  • Ein „GroupPresenceJoinIntent“ wird empfangen, mit dem der Name der Destination-API, die Lobby-ID und die Spiel-ID basierend auf der Einladung festgelegt werden.
  • Dadurch wird das selbstdefinierte Event „NetworkLaunch“ ausgelöst. Da dieser Aufruf über eine Einladung initiiert wurde, wird eine Deeplink-Nachricht mit Informationen über die Destination „Blauer Raum“, die Lobby „lobby_123“ und das Spiel „BlueRoom_for_lobby_123“ verwendet.
  • Da es sich um eine Einladung zu einem Spiel handelt, wird Charlies Gruppenpräsenz mit den Informationen zur Destination und zur Lobby aktualisiert.
  • Charlies Lobby-Sitzungs-ID ändert sich jedoch nicht. Er behält die bereits vorhandene, und wenn er noch keine hat, wird eine neue zufällig generiert. Seine Lobby-Sitzung unterscheidet sich daher von der von Bob und Alice (z. B. „lobby_456“).
  • Durch die Verbindung mit dem Photon-Raum mit dem Namen „BlueRoom_for_Lobby_123“ wird Charlie benachrichtigt, dass Bob der Host ist. Charlie verbindet sich mit Bob.
  • Alice, Bob und Charlie sind im blauen Raum gleichzeitig anwesend.

• Sie verlassen den blauen Raum und kehren in die Lobby zurück.
  • Ihre Spiel-IDs werden auf null gesetzt.
  • Alice und Bob kehren mit der gemeinsamen Lobby-ID „lobby_123“ in Alices Lobby zurück.
  • Charlie kehrt allein mit seiner individuellen Lobby-ID „lobby_456“ zurück.
• Alice sendet Charlie eine Einladung aus ihrer Lobby. Sie möchte, dass sie gemeinsam mehrere Spiele durchlaufen und in dieselbe Lobby zurückkehren.
  • Charlie nimmt die Einladung an.
  • Ein „GroupPresenceJoinIntent“ wird empfangen, mit dem Gruppenpräsenzinformationen festgelegt werden.
    • Der Name der Destination-API, die Lobby-ID „lobby_123“ und die Spiel-ID basieren auf der Nachricht mit dem Deeplink zur Einladung.
    • Dadurch wird die Lobby-ID von Bobs Gruppenpräsenz auf die Lobby-ID von Alice „lobby_123“ aktualisiert.
    • Dadurch wird er dem Photon-Raum zugeordnet.
  • Charlies Gruppenpräsenz wird nun so aktualisiert, dass seine Lobby-ID mit der von Alice und Bob übereinstimmt.
  • Alice, Bob und Charlie sind gemeinsam in der Lobby anwesend und können Spiele jetzt zusammen spielen und danach in dieselbe Lobby zurückkehren.

• Alice sieht, dass sich Bob derzeit in einer Spielelobby befindet, da seine Gruppenpräsenz seine aktuelle Destination in der Freundesliste angibt.
• Bob befindet sich derzeit in einem Spielstatus, der nicht zum Beitritt freigegeben ist, sodass seine Gruppenpräsenz „is_joinable“ auf „false“ gesetzt ist.
  • Da Bobs „is_joinable“ auf „false“ gesetzt ist, kann Alice Bob an seiner aktuellen Destination nicht beitreten.
• Wenn sich Bob an einer Destination befindet, der beigetreten werden kann, während ein Spiel oder eine Sitzung läuft, kann sein „is_joinable“ auf „true“ gesetzt bleiben.
  • Wenn Alice versucht, einer Gruppe beizutreten, wird ein „GroupPresenceJoinIntent“ für Bobs aktuelle Destination empfangen.
    • Die aktuelle Spielsitzung von Bob wird unterbrochen und er und alle weiteren Gruppenmitglieder werden in ihre Lobby zurückgeschickt.
    • Alice betritt den Raum und ihre Lobby-ID wird so eingestellt, dass sie mit der Lobby-ID von Bob übereinstimmt.
  • Alice ist nun zusammen mit Bob und allen anderen Mitgliedern in der Lobby anwesend.
  • Alice und Bob können nun gemeinsam als Gruppe ein Spiel oder eine App starten.