Intégration EOS Lobby

Ce guide vous montrera comment intégrer Edgegap pour fonctionner avec les lobbies EOS dans votre projet de jeu Unreal. Certaines étapes nécessiteront que vous envoyiez des requêtes à notre API en utilisant un jeton, et le curl les commandes fournies ci‑dessous vous permettront d'apercevoir chacune de leurs réponses afin que vous puissiez déterminer comment les gérer dans votre code. Lors de l'utilisation du jeton dans vos requêtes, assurez‑vous de garder le jeton mot‑clé.

Vous devrez également avoir une version d'application déjà configurée sur notre plateforme pour votre projet. Dans ce cas, nous recommandons d'utiliser le plugin Edgegap pour Unreal afin d'accélérer le processus de test. Pour plus d'informations sur le plugin, vous pouvez lire notre documentation ici.

Par mesure de sécurité, il n'est pas recommandé que le propriétaire du lobby EOS envoie des requêtes directement à l'API Edgegap en production, car le client aurait accès au jeton API. Vous devriez plutôt utiliser un service séparé pour gérer ces requêtes.

1. Obtenir et stocker l'IP publique des joueurs

Pour commencer, chaque joueur qui rejoint un lobby - y compris le propriétaire du lobby - doit obtenir son IP publique et la stocker en tant que propriété de membre du lobby.

curl --location --request GET 'https://api.edgegap.com/v1/ip' \
--header 'Authorization: [EDGEGAP_API_TOKEN]'

2. Créer un déploiement

Une fois que le propriétaire du lobby décide que la partie est prête à commencer, une requête doit être envoyée pour créer un nouveau déploiement sur Edgegap, en utilisant les IP publiques stockées.

curl --location --request POST 'https://api.edgegap.com/v1/deploy' \
--header 'Content-Type: application/json' \
--header 'Authorization: [EDGEGAP_API_TOKEN]' \
--data-raw '{
    "app_name": "[EDGEGAP_APP_NAME]",
    "version_name": "[EDGEGAP_APP_VERSION]",
    "ip_list": [
        "[LOBBY_MEMBER_IP]"
    ]
}'

Ensuite, le propriétaire du lobby devra continuer à interroger le déploiement en boucle, en utilisant le request_id fourni dans la réponse à la requête de création de déploiement. Une fois que la réponse contient le current_status défini sur READY, le propriétaire du lobby devra définir les valeurs d'IP et de port du déploiement comme propriétés du lobby EOS.

curl --location --request GET 'https://api.edgegap.com/v1/status/[REQUEST_ID]' \
--header 'Authorization: [EDGEGAP_API_TOKEN]'

3. Se connecter au déploiement

Lorsque les joueurs reçoivent la notification que les valeurs d'IP et de port ont été attribuées, ils peuvent les comparer au cache client puis les utiliser pour se connecter au serveur et jouer la partie.

4. Terminer la partie et le déploiement

Une fois la partie terminée, le propriétaire du lobby supprimera les valeurs d'IP et de port des propriétés du lobby EOS, ce qui notifiera les autres de se déconnecter proprement du serveur. Si l'application est configurée pour injecter des variables d'environnement, elles pourront être utilisées pour terminer le déploiement depuis l'intérieur à ce moment.

Pour terminer le déploiement depuis l'extérieur du serveur, une requête comme la curl commande montrée ci‑dessous peut être utilisée à la place.

curl --location --request DELETE 'https://api.edgegap.com/v1/stop/[REQUEST_ID]' \
--header 'Authorization: [EDGEGAP_API_TOKEN]'

Si les joueurs restent dans le lobby, le propriétaire du lobby peut alors répéter les étapes en commençant par la demande d'un nouveau déploiement afin d'initier une revanche avec les mêmes personnes.