Découvrez comment fonctionne Edgegap

Découvrez comment fonctionne Edgegap

Matchmaking

Matchmaking

et

et

Hébergement de serveurs de jeux

Hébergement de serveurs de jeux

Intégration

/

Unity Package Manager

/

Unity Package Manager

Déployer sur Edgegap

Publié

Publié

Publié

dernière vérification de l'exactitude

dernière vérification de l'exactitude

dernière vérification de l'exactitude

Unity Package Manager : Comment installer des packages à partir d'une URL Git

Unity Package Manager : Comment installer des packages à partir d'une URL Git

Ce guide vous montre comment installer un package dans Unity directement depuis un dépôt Git, via la fenêtre du Package Manager ou en modifiant le manifeste de votre projet, ainsi que la manière d'épingler des versions, d'installer depuis un sous-dossier, d'accéder à des dépôts privés et de corriger les erreurs courantes. Nous utilisons les packages Unity d'Edgegap comme exemple ; les étapes fonctionnent pour n'importe quel package hébergé sur Git.

Edgegap héberge des jeux multijoueurs sur des serveurs dédiés. Une fois votre serveur de jeu conteneurisé, Edgegap le déploie dans le monde entier sur plus de 615 emplacements Edge Cloud (à la demande) à partir d'un simple appel d'API et avec une facturation basée exclusivement sur l'utilisation : aucun serveur complet à louer, à provisionner ou à maintenir en fonctionnement entre les parties. Pour les serveurs persistants à capacité réservée, Edgegap propose des Private Fleets. Le Matchmaking d'Edgegap s'appuie sur cette base et est facultatif.

Vous hébergez un jeu Unity complet ? Consultez Unity Engine pour découvrir le parcours complet, de la compilation du serveur dédié au matchmaking.

Parler à un ingénieur

Aucune carte de crédit requise. L'offre gratuite inclut les ressources nécessaires pour déployer un véritable serveur de jeu.

Aucune carte de crédit requise. L'offre gratuite inclut les ressources nécessaires pour déployer un véritable serveur de jeu.

Guide étape par étape

Étapes d'intégration détaillées

1. Avant de commencer : installez Git

Le gestionnaire de packages d'Unity ne télécharge pas lui-même les packages Git : il exécute le client Git installé sur votre ordinateur.

  • Git 2.14.0 ou plus récent, dans votre PATH. macOS en a généralement déjà un (Xcode Command Line Tools). Sous Windows, installez Git et conservez l'option par défaut du programme d'installation qui ajoute Git à votre PATH.

  • Redémarrez Unity et Unity Hub après avoir installé Git, afin qu'ils prennent en compte le nouveau PATH.

  • Git LFS, uniquement si le package stocke des fichiers volumineux avec Git LFS. Sans le client LFS, Unity extrait de petits fichiers pointeurs au lieu des véritables ressources, sans afficher d'erreur.

  • Toute version récente d'Unity. Les étapes ci-dessous utilisent Unity 6.3 LTS.

Vérifiez que cela fonctionne : ouvrez un nouveau terminal et exécutez git --version.

2. Installer un paquet à partir d'une URL Git dans le gestionnaire de paquets

  1. Dans Unity, ouvrez Fenêtre → Gestionnaire de packages (Fenêtre → Gestion des packages → Gestionnaire de packages dans les versions plus récentes d'Unity 6).

  2. Sélectionnez + en haut à gauche, puis Installer le package depuis une URL git (intitulé Ajouter un package depuis une URL git dans les versions antérieures).

  3. Collez l'URL du dépôt, se terminant par .git. Pour le plugin d'Edgegap : https://github.com/edgegap/edgegap-unity-plugin.git

  4. Sélectionnez Installer.

Après quelques secondes, le package apparaît dans la liste avec une étiquette Git. En cas d'échec, la raison est indiquée dans la console Unity.

3. Ou installez-le en modifiant le fichier manifest.json

Chaque package utilisé par votre projet est répertorié dans Packages/manifest.json. Y ajouter une URL Git produit le même effet que d'utiliser le Package Manager, tout en étant facile à partager via le contrôle de version ou à demander à un agent de programmation.

Ouvrez Packages/manifest.json et ajoutez une ligne sous dependencies, avec le nom du package comme clé et l'URL Git comme valeur :

"com.edgegap.unity-sdk": "https://github.com/edgegap/edgegap-unity-sdk.git#3.5.5",

Enregistrez le fichier et revenez dans Unity : le package s'installe automatiquement.

Avec votre agent :

« Ajoute l'Edgegap Unity SDK 3.5.5 à ce projet depuis son URL Git dans Packages/manifest.json. »

Les URL Git doivent uniquement figurer dans le fichier manifest.json de votre projet, jamais dans le package.json d'un package.

4. Épingler une version, mettre à jour ou installer depuis un sous-dossier

  • Épingler une version : ajoutez # et un tag, une branche ou le hachage complet du commit à l'URL, par exemple https://github.com/edgegap/edgegap-unity-sdk.git#3.5.5. Les hachages de commit courts ne fonctionnent pas. Sans #, vous obtenez le dernier commit de la branche par défaut.

  • Verrouillage : Unity enregistre le commit exact qu'il a installé, afin que vos coéquipiers obtiennent la même version. Un nom de branche n'avance pas de lui-même.

  • Mise à jour : réinstallez la même URL depuis + → Install package from git URL, ou modifiez le tag # pour une version plus récente.

  • Sous-dossier : si le package ne se trouve pas à la racine du dépôt, ajoutez ?path= suivi du dossier contenant son package.json, avant tout # : https://github.com/owner/repo.git?path=/MyPackage#v1.2.3. L'ordre inverse échoue.

  • Dépôt privé : Unity ne peut pas demander de mot de passe. Via HTTPS, configurez d'abord un gestionnaire d'identifiants Git (Git credential helper). Via SSH (git@github.com:owner/repo.git), configurez votre clé SSH en dehors d'Unity ; une clé protégée par une phrase secrète ne fonctionne que par l'intermédiaire d'un agent tel que ssh-agent.

5. Packages Unity d'Edgegap

  • Plugin de l'outil de build automatisé de serveur de jeu d'Edgegap pour Unity : compile votre serveur Linux, le conteneurise et le déploie sur le cloud à partir de boutons dans l'éditeur Unity. URL : https://github.com/edgegap/edgegap-unity-plugin.git. Ouvrez-le sous Tools → Edgegap Server Hosting.

  • SDK Edgegap pour Unity : le code client et serveur de matchmaking que votre jeu utilise au moment de l'exécution. URL : https://github.com/edgegap/edgegap-unity-sdk.git#3.5.5. La version 3.5.5 ou plus récente est requise pour les builds de navigateur (WebGL).

Vous utilisez Mirror ? Les versions récentes de Mirror incluent déjà le plugin Edgegap (Assets/Mirror/Hosting/Edgegap). Ne l'installez pas à nouveau depuis Git, sinon Unity signalera des scripts en double.

6. Étape suivante : ajouter le matchmaking

Avec le SDK Edgegap installé, votre jeu peut regrouper des joueurs et démarrer automatiquement un serveur dédié à proximité d'eux. Consultez le SDK Unity Matchmaking pour la configuration, ou Unity Engine pour commencer à partir de votre build de serveur dédié.

7. Vérifier l'installation

  1. Dans le Package Manager, sélectionnez In Project : le package est répertorié avec une étiquette Git et sa version ou son commit.

  2. La console Unity n'affiche aucune erreur du Package Manager.

  3. Pour le plugin d'Edgegap, Tools → Edgegap Server Hosting ouvre la fenêtre du plugin.

Étapes suivantes

Étapes suivantes

Vous êtes bloqué ? Posez vos questions à notre équipe et à d'autres studios sur le Discord d'Edgegap.

Questions Fréquemment Posées

Questions fréquentes sur l'installation de packages Unity à partir d'une URL Git.

Comment résoudre l'erreur « No 'git' executable was found » dans Unity ?

Installez Git 2.14.0 ou une version plus récente et assurez-vous qu'il se trouve dans votre PATH, puis redémarrez Unity et Unity Hub. Sous Windows, l'option par défaut du programme d'installation de Git l'ajoute à votre PATH. Vérifiez avec git --version dans un nouveau terminal.

Comment installer une version spécifique d'un paquet Unity depuis Git ?

Ajoutez # et une balise (tag), une branche ou un hachage de commit complet à la fin de l'URL Git, par exemple https://github.com/edgegap/edgegap-unity-sdk.git#3.5.5. Sans cela, Unity installe le dernier commit de la branche par défaut.

Comment mettre à jour un package Unity installé depuis Git ?

Installez à nouveau la même URL Git depuis le menu + du Package Manager, ou modifiez la version après le # dans Packages/manifest.json. Unity verrouille le commit qu'il a installé, il ne se met donc pas à jour tout seul.

Unity peut-il installer un package depuis un dépôt Git privé ?

Oui. Unity ne peut pas demander de mot de passe, configurez donc un assistant d'identification Git (credential helper) pour HTTPS, ou une clé SSH pour les URL SSH, avant de procéder à l'installation. Les clés SSH protégées par une phrase secrète nécessitent un agent tel que ssh-agent.

Pourquoi est-ce que j'obtiens des erreurs de scripts en double après avoir installé le plugin Edgegap ?

Votre projet contient déjà le plugin, souvent parce que les versions récentes de Mirror l'incluent sous Assets/Mirror/Hosting/Edgegap. Supprimez une copie : conservez celle de Mirror, ou supprimez ce dossier et utilisez le package Git.

Clients

Découvrez les témoignages de clients qui ont intégré Edgegap

31 études de cas sont disponibles auprès de studios ayant migré d'une autre plateforme vers Edgegap.

Principales raisons pour lesquelles ils ont choisi Edgegap

Découvrez l’impact de l’orchestration automatisée des serveurs de jeu d’Edgegap pour une expérience multijoueur impeccable.

+58 % Réduction de Latence Moyenne

+58 % Réduction de Latence Moyenne

14M CCU Dimensionnement

14M CCU Dimensionnement

+615 de sites dans le monde

+615 de sites dans le monde

~2s. Temps de démarrage médian du serveur de jeu

~2s. Temps de démarrage médian du serveur de jeu

Support multi-version et mises à jour continues

Support multi-version et mises à jour continues

Taux de remplissage de 91 % Matchmaking

Taux de remplissage de 91 % Matchmaking

Compatibilité multiplateforme

Compatibilité multiplateforme

Protection DDoS instantanée

Protection DDoS Instantanée

Multi-cloud sur plus de 17 fournisseurs pour une disponibilité de 99,99 %

Multi-cloud sur plus de 17 fournisseurs pour une disponibilité de 99,99 %

Coût

Prix

Prix

Optimisez les coûts et les performances grâce à l'orchestration hybride

Optimisez les coûts et les performances grâce à l'orchestration hybride

Optimisez les coûts et les performances grâce à l'orchestration hybride

Cloud de périphérie

À la demande

0,00115 $

/ vCPU

/ MINUTE

Facturé à la minute, uniquement à l'utilisation

Payez quand les joueurs jouent. 0 serveur actif = 0 $

Déployez des serveurs de jeu dans le monde entier, par instance, dans plus de 615 emplacements edge cloud. Sans engagement.

Ajoutez simplement une carte de crédit.

Plus de 615 PoP dans le monde

0,10 $ / Go de Egress mensuel

Déploiements de 0,25 à 4 vCPU

Comparer les fonctionnalités et les tarifs

Cloud de périphérie

À la demande

0,00115 $

/ vCPU

/ MINUTE

Facturé à la minute, uniquement à l'utilisation

Payez quand les joueurs jouent. 0 serveur actif = 0 $

Déployez des serveurs de jeu dans le monde entier, par instance, dans plus de 615 emplacements edge cloud. Sans engagement.

Ajoutez simplement une carte de crédit.

Plus de 615 PoP dans le monde

0,10 $ / Go de Egress mensuel

Déploiements de 0,25 à 4 vCPU

Comparer les fonctionnalités et les tarifs

Private Fleet (Bare Metal)

Capacité réservée

0,0261 $

/ vCPU

/ HEURE

Facturé mensuellement, toujours actif

280 $ par hôte/mois (tarif sur 12 mois), ou 350 $ par mois

Optimisez la rentabilité de votre serveur de jeu grâce à l'hébergement sans frais de transfert de données sortantes (egress-free) des flottes privées (Private Fleets).

Permanent, disponible 24h/24 et 7j/7, exclusif à votre studio.

58 PoP global

Egress inclus

16 vCPU/hôte au total (14,7 utilisables)

Comparer les fonctionnalités et les tarifs

Private Fleet (Bare Metal)

Capacité réservée

0,0261 $

/ vCPU

/ HEURE

Facturé mensuellement, toujours actif

280 $ par hôte/mois (tarif sur 12 mois), ou 350 $ par mois

Optimisez la rentabilité de votre serveur de jeu grâce à l'hébergement sans frais de transfert de données sortantes (egress-free) des flottes privées (Private Fleets).

Permanent, disponible 24h/24 et 7j/7, exclusif à votre studio.

58 PoP global

Egress inclus

16 vCPU/hôte au total (14,7 utilisables)

Comparer les fonctionnalités et les tarifs

Votre facture varie selon le tarif et l'utilisation, qui peuvent varier en fonction
du type de jeu, du nombre de joueurs et plus encore.

Votre facture varie selon le tarif et l'utilisation, qui peuvent varier en fonction
du type de jeu, du nombre de joueurs et plus encore.

Modélisez votre utilisation avec notre calculateur d'estimation ->

Modélisez votre utilisation avec notre calculateur d'estimation ->

Fonctionnalités et tarifs d'Edgegap : comparaison détaillée entre Edge Cloud et Private Fleets

Fonctionnalités et tarifs d'Edgegap : comparaison détaillée entre Edge Cloud et Private Fleets

COMPARER

Essai gratuit

Cloud de périphérie

Flottes privées

FACTURATION & PRIX

Tarif par vCPU

N/A

0,00115 $ / vCPU / minute

0,0261 $ / vCPU / heure

Modèle de tarification

N/A

À la demande (basé sur l'utilisation)

Capacité réservée

Facturation

Aucune carte de crédit requise

Oui, via Stripe

Oui, via Stripe

Engagement

N/A

Aucun

1, 6 ou 12 mois (réduction incluse)

Sortie

N/A

0,10 $ / Go par mois

6 To par hôte, par mois

FONCTIONNALITÉS

Analyses et surveillance

Alertes de facturation

Cliquer pour agrandir

28 lignes de plus

Déverrouille

Les fonctionnalités sont débloquées lorsqu'une carte de crédit est ajoutée au compte.

Déploiements en Chine

Protection DDoS

Clusters entièrement gérés

Déploiements permanents

COMPARER

Essai gratuit

Cloud de périphérie

Flottes privées

FACTURATION & PRIX

Tarif par vCPU

N/A

0,00115 $ / vCPU / minute

0,0261 $ / vCPU / heure

Modèle de tarification

N/A

À la demande (basé sur l'utilisation)

Capacité réservée

Facturation

Aucune carte de crédit requise

Oui, via Stripe

Oui, via Stripe

Engagement

N/A

Aucun

1, 6 ou 12 mois (réduction incluse)

Sortie

N/A

0,10 $ / Go par mois

6 To par hôte, par mois

FONCTIONNALITÉS

Analyses et surveillance

Alertes de facturation

Cliquer pour agrandir

28 lignes de plus

Déverrouille

Les fonctionnalités sont débloquées lorsqu'une carte de crédit est ajoutée au compte.

Déploiements en Chine

Protection DDoS

Clusters entièrement gérés

Déploiements permanents

COMPARER

Essai gratuit

Cloud de périphérie

Flottes privées

FACTURATION & PRIX

Tarif par vCPU

N/A

0,00115 $ / vCPU / minute

0,0261 $ / vCPU / heure

Modèle de tarification

N/A

À la demande (basé sur l'utilisation)

Capacité réservée

Facturation

Aucune carte de crédit requise

Oui, via Stripe

Oui, via Stripe

Engagement

N/A

Aucun

1, 6 ou 12 mois (réduction incluse)

Sortie

N/A

0,10 $ / Go par mois

6 To par hôte, par mois

FONCTIONNALITÉS

Analyses et surveillance

Alertes de facturation

Cliquer pour agrandir

28 lignes de plus

Déverrouille

Les fonctionnalités sont débloquées lorsqu'une carte de crédit est ajoutée au compte.

Déploiements en Chine

Protection DDoS

Clusters entièrement gérés

Déploiements permanents