Unity NGO

Découvrez comment héberger des projets Unity sur Edgegap à l'aide des techniques du l’exemple NGO Boss Room.

Cet exemple ne nécessite aucun service Unity Gaming Services (UGS) , Multiplay ou Relays pour fonctionner.

✔️ Préparation

Avant de commencer, vous aurez besoin de :

• Unity 6 - à télécharger via Unity Hub,

• Projet d’exemple Unity NGO [Netcode for Game Objects] Boss Room (modifié pour Edgegap) :

  • à télécharger depuis GitHub.

⚡ Déployer et connecter

1. Déployer un serveur sur Edgegap

☑️ Pour commencer, vous devrez créer un compte gratuit chez Edgegap. Aucune carte de crédit requise.

☑️ Créer une nouvelle version d’application pour votre application, choisissez NGO Boss Room Sample.

☑️ Déployez un serveur avec la version de votre application NGO Boss Room Sample.

☑️ Ouvrez les détails de votre nouveau déploiement et trouvez vos informations de connexion uniques, à usage unique :

• Port externe, par exemple 30854 (choisi aléatoirement).

☑️ Allez dans l’onglet Logs et trouvez (CTRL+F) vos informations de connexion uniques, à usage unique :

• ARBITRIUM_PUBLIC_IP , par exemple IPv4 : 172.234.244.38 .

✅ Vous pouvez maintenant passer à l’étape suivante.

2. Se connecter depuis l’éditeur

☑️ Ouvrez votre nouveau projet dans Unity.

☑️ Vérifiez que vous avez ouvert la scène : Assets/Scenes/MainMenu.unity.

☑️ Appuyez sur le bouton ▶️ Play pour lancer votre client de jeu :

• appuyez sur START WITH DIRECT IP bouton,

• sélectionnez l’onglet JOIN WITH IP.

☑️ Saisissez les informations de connexion de l’étape précédente.

☑️ Appuyez sur JOIN bouton pour vous connecter à votre serveur.

☑️ Connectez un deuxième joueur virtuel avec Multiplayer Play Mode ou ParrelSync.

🙌 Félicitations pour votre premier déploiement sur Edgegap !

✏️ Personnaliser la build du serveur

Voir Unity pour Unity afin de apprendre à créer et personnaliser des serveurs.

Exécuter en tant que serveur dédié

Pour que cet exemple s’exécute en tant que serveur dédié, nous avons apporté les modifications suivantes :

Initialisation du serveur

Nouveau script (ajouté à votre MainMenu scène dans un nouveau GameObject vide):

Assets/Scripts/EdgegapServerStarter.cs

using System;
using System.Collections;
using System.Collections.Generic;
using Unity.BossRoom.ConnectionManagement;
using UnityEngine;

namespace Unity.Multiplayer.Samples.BossRoom
{
    public class EdgegapServerStarter : MonoBehaviour
    {
        public string portMapName = "gameport";

        // Start est appelé avant la première mise à jour de frame
        void Start()
        {
            if (Application.isBatchMode)
            {
                ConnectionManager connectionManager = GameObject.Find("ConnectionManager").GetComponent<ConnectionManager>();
                string internalPortAsStr = Environment.GetEnvironmentVariable($"ARBITRIUM_PORT_{portMapName.ToUpper()}_INTERNAL");

                if (internalPortAsStr == null || !ushort.TryParse(internalPortAsStr, out ushort port))
                {
                    throw new Exception($"Could not find port mapping, make sure your app version port name matches with \"{portMapName}\"");
                }

                connectionManager.StartHostIp("SERVER", "0.0.0.0", port);
            }
        }
    }
}

Gestion de la connexion

Fichiers modifiés :

Assets/Scripts/ConnectionManagement/ConnectionMethod.cs

116        public override async Task SetupHostConnectionAsync()
117        {
118            //SetConnectionPayload(GetPlayerId(), m_PlayerName); // Il faut aussi définir la charge utile de connexion pour l’hôte, car l’hôte est aussi un client
119            var utp = (UnityTransport)m_ConnectionManager.NetworkManager.NetworkConfig.NetworkTransport;
120            utp.SetConnectionData(m_Ipaddress, m_Port);
121        }

Assets/Scripts/ConnectionManagement/ConnectionState/StartingHostState.cs

66        async void StartHost()
67        {
              ...

72                // StartHost de NGO lance tout
--                //if (!m_ConnectionManager.NetworkManager.StartHost())
73                if (!m_ConnectionManager.NetworkManager.StartServer())
74                {
75                    StartHostFailed();
76                }

              ...

Assets/Scripts/Gameplay/GameplayObjects/Character/ClientCharacter.cs

112        public override void OnNetworkSpawn()
113        {
               ...

125            m_ServerCharacter.IsStealthy.OnValueChanged += OnStealthyChanged;
126            m_ServerCharacter.MovementStatus.OnValueChanged += OnMovementStatusChanged;
127            //OnMovementStatusChanged(MovementStatus.Normal, m_ServerCharacter.MovementStatus.Value);
 
               ...

Compatibilité éditeur/serveur

Modifier les fichiers :

Assets/Scripts/ConnectionManagement/ConnectionState/HostingState.cs

148        ConnectStatus GetConnectStatus(ConnectionPayload connectionPayload)
149        {
               ...
                
155            //if (connectionPayload.isDebug != Debug.isDebugBuild)
156            //{
157            //    return ConnectStatus.IncompatibleBuildType;
158            //}

               ...