Photon Fusion 2

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

✔️ Préparation

Avant de commencer, vous aurez besoin de :

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

• Projet exemple Fusion 2 Asteroids (modifié pour Edgegap) - télécharger depuis GitHub.

⚡ Déployer et se 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éez une nouvelle version d'application pour votre application, choisissez Fusion 2 Asteroids Sample.

☑️ Ouvrez votre nouveau projet dans Unity.

☑️ Allez dans Tools / Edgegap Hosting, puis à l'étape 6. Déployer un serveur sur Edgegap.

☑️ Appuyez sur Deploy to cloud et ouvrez les détails de votre nouveau déploiement.

☑️ Trouvez les informations 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 démarrer 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 construction du serveur

Voir Unity pour Unity afin de apprendre à construire et personnaliser les serveurs.

Créer une application sur Photon

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

☑️ Créez un compte gratuit sur Photon.

☑️ Créez 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 Peer Mode = 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 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,

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

• fournir 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 du test du client de jeu, obtenez-la depuis le tableau de bord - page des détails du déploiement / URL de l'hôte

  • créez des déploiements pour test depuis notre plugin d'hébergement quickstart,

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

  • voir aussi démarrage avec le Matchmaking.

Dépannage

Le jeu n'existe pas (32758)

• Les salles Photon exigent que le joueur se connecte à la région Photon Cloud où le déploiement est situé. Le déploiement depuis le tableau de bord utilise une IP 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 aussi près que possible du joueur lors de l'utilisation de nos plugins ou API donc en production, définir la région Photon Cloud n'est pas nécessaire.