Photon Fusion 2

Découvrez comment héberger des projets Unity sur Edgegap en utilisant les techniques du Fusion 2 Asteroids Sample.

✔️ Préparation

Avant de commencer, vous aurez besoin :

• Unity 6 - téléchargez via Unity Hub,

• projet Fusion 2 Asteroids Sample (modifié pour Edgegap) - téléchargez depuis GitHub.

⚡ Déployer et se connecter

1. Déployer un serveur sur Edgegap

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

☑️ Créez une nouvelle version d'application pour votre application, choisissez Fusion 2 Asteroids Sample.

☑️ Ouvrez votre nouveau projet dans Unity.

☑️ Accédez à Tools / Edgegap Hosting, puis à l'étape 6. Deploy a Server on Edgegap.

☑️ Appuyez sur Déployer dans le cloud et ouvrez les détails de votre nouveau déploiement.

☑️ Trouvez les détails de connexion uniques et à usage unique de votre déploiement :

• URL de l'hôte au format 780aa4260e83.pr.edgegap.net .

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

2. Se connecter depuis l'éditeur

☑️ Ouvrez votre nouveau projet dans Unity.

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

☑️ Saisissez l'URL de l'hôte (détails de connexion de l'étape précédente) comme nom de salle.

☑️ Appuyez sur le bouton Start Edgegap 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 d'apprendre à compiler et personnaliser des serveurs.

Créer une application sur Photon

Pour faciliter la démo initiale, nous avons utilisé un compte Photon Cloud gratuit appartenant à Edgegap.

☑️ Créez un compte gratuit sur Photon.

☑️ Créer une application sur Photon:

• Jeu multijoueur,

• Fusion SDK Photon,

• Fusion 2 version du SDK.

☑️ Trouvez votre ID d'application au format 85314a99-56fc-4ab3-ba26-50efca09f303 .

☑️ Saisissez votre ID dans Photon Settings sous Tools / Fusion / Fusion Hub (Alt + F).

Intégrer le projet Fusion 2 avec Edgegap

Voir EdgegapServerManager.cs script pour un exemple d'intégration de Fusion 2 avec Edgegap.

Votre NetworkProjectConfig doit utiliser Mode pair = Single (Serveur dédié), pas Multiple (Client-hôte) !

Les clients de jeu se connecteront aux serveurs de jeu via Photon Fusion 2 Session (salle) fonctionnalité.

Votre serveur de jeu doit enregistrer son adresse IP et son port externe avec le nom de la session, lors de l'appel de _runnerInstance.StartGame(StartGameArgs args):

• utilisez GameMode.Server pour vous assurer que votre connexion n'est pas relayée via Photon Cloud (ajoute de la latence),

• utilisez NetAddress.CreateFromIpPort méthode de Fusion,

• fournissez l'adresse IP du serveur : Environment.GetEnvironmentVariable("ARBITRIUM_PUBLIC_IP")

• fournissez le port externe du serveur : Environment.GetEnvironmentVariable("ARBITRIUM_PORT_GAMEPORT_EXTERNAL")

  • c'est le nom de mappage de port par défaut si vous utilisez notre plugin Unity pour empaqueter votre serveur.

Utilisez l'URL d'hôte du déploiement Edgegap comme nom de session :

• dans le serveur de jeu, récupérez-la avec $"{Environment.GetEnvironmentVariable("ARBITRIUM_REQUEST_ID")}.pr.edgegap.net"

• lors des tests du client de jeu, récupérez-la depuis le tableau de bord - page des détails du déploiement / URL de l'hôte

  • créez des déploiements pour les tests à partir de notre plugin d’hébergement de démarrage rapide,

• en production dans le client de jeu, récupérez-la depuis matchmaking / attribution de ticket / fqdn:

  • voir aussi bien démarrer avec Matchmaking.

Intégration client

EdgegapClientManager.cs

// obtenir le NetworkRunner de Fusion 2
_runnerInstance = FindFirstObjectByType<NetworkRunner>();
_runnerInstance.ProvideInput = true;

// obtenez cette valeur depuis l'affectation du matchmaker Edgegap ou l'API Sessions de Fusion 2
string sessionName = "<requestId.pr.edgegap.net>";

// trouver la session Fusion 2 (en utilisant le nom de session)
var result = await _runnerInstance.StartGame(
    new StartGameArgs() {
        GameMode = GameMode.Client,
        SessionName = sessionName,
        ObjectProvider = _runnerInstance.GetComponent<NetworkObjectPoolDefault>(),
    }
);

// Fusion va maintenant récupérer l'IP et le port du serveur à partir du nom de session et se connecter

Intégration serveur

EdgegapServerManager.cs

// lire les variables d'environnement injectées par Edgegap
string requestId = Environment.GetEnvironmentVariable("ARBITRIUM_REQUEST_ID");
string listenPortStr = Environment.GetEnvironmentVariable("ARBITRIUM_PORT_GAMEPORT_INTERNAL");
string connectIP = Environment.GetEnvironmentVariable("ARBITRIUM_PUBLIC_IP");
string connectPort = Environment.GetEnvironmentVariable("ARBITRIUM_PORT_GAMEPORT_EXTERNAL");

// obtenir le NetworkRunner de Fusion 2
_runnerInstance = FindFirstObjectByType<NetworkRunner>();
_runnerInstance.ProvideInput = true;

// convertir le port d'écoute en ushort, comme attendu par StartGame
ushort.TryParse(listenPortStr, out ushort listenPort);

// enregistrer la session Fusion 2 pour que les clients la retrouvent plus tard (en utilisant le nom de session)
var result = await _runnerInstance.StartGame(
    new StartGameArgs() {
        GameMode = GameMode.Server,
        SessionName = $"{requestId}.pr.edgegap.net",
        ObjectProvider = _runnerInstance.GetComponent<NetworkObjectPoolDefault>(),
        Address = NetAddress.Any(listenPort),
        CustomPublicAddress = NetAddress.CreateFromIpPort(connectIP, connectPort),
    }
);

// charger la scène initiale
if (result.Ok && _runnerInstance.IsServer) {
    await _runnerInstance.LoadScene(sceneName);
}

Dépannage

Le jeu n'existe pas (32758)

• Les salles Photon exigent que le joueur se connecte à la région Photon Cloud où se trouve le déploiement. Le déploiement depuis le tableau de bord utilise une IP de joueur aléatoire.

• Vous devrez peut-être trouver l'emplacement du déploiement sur la carte et configurer votre client de jeu dans Assets / Photon / Fusion / Resources / PhotonAppSettings.asset avec la région Photon Cloud.

• Edgegap déploie au plus près du joueur possible lors de l'utilisation de nos plugins ou API donc en production, définir la région Photon Cloud n'est pas requis.