Présentation du mode multijoueur·se

• Destinations : les destinations sont des lieux configurables dans votre application qui peuvent être affichés à l’aide de la présence de groupe. Pour commencer à configurer des destinations dans votre application, consultez la présentation sur les destinations.
• Group Presence (Présence de groupe) : comprend les informations suivantes qui sont gérées par l’application :
  • L’application dans laquelle se trouve la personne
  • Si elle se trouve dans un match
  • Si elle se trouve dans un lobby
  • Si elle se trouve dans une destination spécifique
  • S’il ou elle est joignable, c’est-à-dire qu’il ou elle est en mesure d’inviter des personnes à le ou la rejoindre dans sa destination actuelle
• Invite to App (Invitation à l’application) : invitez les followers et les utilisateur·ices ayant récemment joué avec vous dans les lobbies existants.
• Roster (Liste) : la liste permet aux utilisateur·ices de savoir quelles personnes participent au jeu à leurs côtés.
• Rejoin (Rejoindre) : permet aux utilisateur·ices de décider de revenir ou non dans une session avec des ami·es après une interruption.
• Webhooks : vous permettent de recevoir des notifications HTTP en temps réel des modifications relatives aux expériences multijoueur dans votre application.
• Invite Link (Lien d’invitation) : lien d’invitation ouvert pouvant être envoyé à toute personne afin de se retrouver dans une application.
• Quick Invites (Invitations rapides) : permettent aux développeur·ses d’intégrer des invitations dans leur expérience d’application sans superposition Meta Quest.

• L’utilisatrice A, Alice, lance l’application.
  • Lorsque l’application est lancée normalement, et non suite à une invitation, un évènement définit les informations de présence de groupe de l’utilisateur·ice.
    • Le nom de l’API de destination est défini sur la destination par défaut « Lobby » (Hall d’entrée) et la carte.
    • Comme Alice se rend dans le lobby et qu’elle ne possède pas encore d’ID de session pour le lobby, un nouvel identifiant aléatoire est créé. Dans cet exemple, nous utiliserons « Lobby_123 ». L’ID de session du match est vide.
  • L’étape suivante consiste à établir la couche de transport à l’aide de Photon. Nous rejoignons ou créons simplement un salon portant le même nom que son ID de session de lobby : « Lobby_123 ». Ce nom venant juste d’être créé, Alice sera la première dans le salon qui a été créé pour elle.
  • Maintenant au niveau d’UE4, elle commence à héberger le serveur UE4 sur son casque, car elle est la cliente principale de son salon Photon.
• Alice envoie une invitation à Bob pour qu’il vienne la rejoindre dans le lobby_123.
  • Bob reçoit l’invitation dans le jeu ou dans Horizon Home.
  • Lorsque Bob accepte l’invitation, l’application est lancée avec un lien profond contenant la présence de groupe d’Alice, avec sa destination actuelle, « lobby », sa session de lobby, « Lobby_123 », mais sans ID de match.
  • La présence de groupe de Bob est mise à jour pour lui permettre d’utiliser cette même destination. Comme il s’agit d’une invitation à rejoindre un lobby, nous mettons également à jour l’ID du lobby de Bob afin qu’il soit identique à celui d’Alice.
  • Au niveau de Photon, le même flux est suivi par Bob : il essaie de créer ou de rejoindre un salon appelé « Lobby_123 ». Puisqu’il existe, il le rejoint simplement comme un client normal.
  • Au niveau d’Unreal Engine, l’application le connecte à Alice (l’actuelle cliente principale du salon Photon) en tant que client normal.

• Bob pénètre dans le salon bleu.
  • Lors de son entrée, son match_ID est défini sur l’ID du salon bleu. L’ID de ce salon privé est dérivé du lobby auquel il est rattaché, par exemple BlueRoom_for_lobby_123.
    • Le salon bleu est un salon privé associé au lobby d’Alice, lobby_123.
    • Les joueur·ses se trouvant dans un lobby spécifique peuvent rejoindre n’importe quel salon privé associé. Dans notre exemple, Bob rejoint le salon, ce qui a pour effet de créer ou de rejoindre le salon Photon nommé d’après son match_session_ID.
    • S’il est le premier à pénétrer dans ce salon, un nouveau salon Photon est créé et lui est affecté en tant que client principal actuel. En tant que client principal, Bob hébergera le serveur UE4 correspondant sur son casque. Bob initialise le serveur UE4, devient le premier client du serveur, et sa position de départ est établie.
• Alice pénètre dans le salon bleu.
  • Son ID de match est défini sur celui du salon bleu, BlueRoom_for_lobby_123.
  • Elle se connecte au serveur de Bob, car ce dernier en est désormais l’organisateur. (UE4)
  • Elle est maintenant coprésente avec Bob.
  • Ils partagent les mêmes ID de lobby (lobby_123) et ID de match (BlueRoom_for_lobby_123).

• Dans le salon bleu, Alice ouvre la liste.
  • Elle et Bob sont représentés dans la même équipe et possèdent le même ID de lobby, lobby_123.
• Alice clique sur le bouton d’invitation au bas de la liste, ce qui ouvre le panneau d’invitation.
• Ensuite, elle sélectionne Charlie dans le panneau d’invitation.
• Charlie reçoit l’invitation et l’accepte sur le casque Meta Quest, l’emplacement à partir duquel il l’accepte n’ayant aucune importance.
  • Un GroupPresenceJoinIntent est reçu et utilisé pour définir le nom de l’API de destination, l’ID du lobby et l’ID du match selon l’invitation.
  • Cela provoque l’évènement personnalisé NetworkLaunch. Ce lancement ayant démarré suite à une invitation, il utilise un message de lien profond contenant des informations sur la destination « Blue Room » (salon bleu), le lobby (lobby_123) et le match (BlueRoom_for_lobby_123).
  • Comme il s’agit d’une invitation à un match, la présence de groupe de Charlie est mise à jour avec les informations relatives à la destination et au lobby.
  • Cependant, l’ID de session du lobby de Charlie n’est pas modifié. Il conserve celui en sa possession, et s’il n’en possède pas déjà un, un nouvel ID aléatoire est généré. Sa session de lobby est donc différente de celle qui est partagée par Bob et Alice (par exemple, « Lobby_456 »).
  • Lorsqu’il se connecte au salon Photon nommé BlueRoom_for_Lobby_123, Charlie est informé que Bob en est l’organisateur. Charlie se connecte à Bob.
  • Alice, Bob et Charlie sont coprésents dans le salon bleu.

• Le groupe quitte le salon bleu et retourne dans le lobby.
  • Leurs ID de match sont définis sur null.
  • Alice et Bob retournent dans le lobby d’Alice avec l’ID de lobby partagé, lobby_123.
  • Charlie retourne seul à son ID de lobby unique, lobby_456.
• Alice envoie une invitation à Charlie depuis son lobby. Elle souhaite aller avec lui à plusieurs matchs et revenir dans le même lobby.
  • Charlie accepte l’invitation.
  • Un GroupPresenceJoinIntent est reçu, lequel sert à définir les informations de présence de groupe.
    • Le nom de l’API de destination, l’ID du lobby (lobby_123) et l’ID du match sont basés sur le message de lien profond d’invitation.
    • Cette opération met à jour l’ID du lobby de la présence de groupe de Bob pour qu’il corresponde à celui d’Alice, lobby_123.
    • Il est ainsi associé au salon Photon.
  • La présence de groupe de Charlie est désormais mise à jour afin que son ID de lobby corresponde à celui d’Alice et de Bob.
  • Alice, Bob et Charlie sont coprésents dans le lobby, et peuvent désormais rejoindre les matchs ensemble et revenir dans le même lobby par la suite.

• Alice voit que Bob se trouve actuellement dans un lobby de jeu via sa présence de groupe qui signale sa destination actuelle sur sa liste d’ami·es.
• Bob se trouvant actuellement dans un état de jeu non joignable, sa présence de groupe is_joinable est définie sur false.
  • Dans la mesure où la présence de jeu is_joinable de Bob est définie sur false, Alice ne peut pas le rejoindre dans sa destination actuelle.
• Si Bob se trouve dans une destination joignable alors qu’un match ou une session est en cours, sa valeur is_joinable peut rester sur true.
  • Lorsqu’Alice tente de le rejoindre, un GroupPresenceJoinIntent est reçu pour la destination actuelle de Bob.
    • La session de jeu actuelle de Bob est mise en pause. Lui et tous les autres membres du groupe sont renvoyés dans leur lobby.
    • Alice rejoint le salon, et son ID de lobby est défini de façon à correspondre à celui de Bob.
  • Alice est désormais coprésente avec Bob et tous les autres membres dans le lobby.
  • Alice et Bob peuvent maintenant jouer à un jeu ou utiliser une application en tant que groupe.