Ce qui suit utilise la documentation sur la façon de déployer des serveurs de jeu sur la plateforme d'hébergement et d'orchestration d'Edgegap à partir du service de matchmaking d'Unity. Il peut être obsolète, et nous recommandons donc de suivre la documentation, qui est disponible sur GitHub.

Besoin de migrer complètement de Multiplay alors qu'Unity arrête ses supports internes pour Multiplay le 30 mars 2026 ? Edgegap propose un guide étape par étape disponible.

Objectif & Portée

Ce dépôt montre comment intégrer Unity Matchmaker avec différentes plateformes d'hébergement de serveurs de jeu en utilisant des modules Cloud Code. Lors de l'utilisation de ces exemples, vous êtes responsable de :

Tester et valider les intégrations pour votre cas d'utilisation spécifique.
Sécuriser vos déploiements et gérer les identifiants.
Respecter les conditions de service de chaque fournisseur d'hébergement.
Maintenir et mettre à jour vos implémentations.

Partie 1 - Configuration

Exigences

Dotnet SDK
UGS CLI
- Configurer le projet et l'environnement
- S'authentifier
- Assurez-vous que votre compte de service dispose des autorisations de projet suivantes :
  - Visionneuse des environnements Unity
  - Éditeur de code Cloud

Partie 2 - Edgegap : Hébergement et orchestration de serveurs de jeu

Edgegap : Hébergement de Serveur de Jeu & Orchestration

Collez le nom de votre application Edgegap et la version dans le code du script cloud.

Déployer le module

# Deploy cloud code module for your chosen provider
ugs deploy modules/EdgegapAllocator

# Deploy cloud code module for your chosen provider
ugs deploy modules/EdgegapAllocator

# Deploy cloud code module for your chosen provider
ugs deploy modules/EdgegapAllocator

Configurer le Tableau de Bord Unity

Naviguez vers le Tableau de Bord Unity :

Ajoutez les secrets nécessaires à votre projet sous Administration > Secrets (reportez-vous au CONFIGURATION.md du module respectif pour plus de détails)
Mettez à jour votre Matchmaker pour utiliser le nouvel allocateur basé sur le Cloud Code sous Matchmaker > Queues.

Intégration Client

Lors de la création d'un ticket avec POST- https://matchmaker.services.api.unity.com/v2/tickets, incluez l'IP publique dans les données personnalisées :

{
    "queueName": "basic",
    "attributes": {},
    "players": [
        {
            "id": "Player 1",
            "customData": {
                "player_ip": "8.8.8.8"
            }
        },
        {
            "id": "Player 2",
            "customData": {
                "player_ip": "4.4.4.4"
            }
        }
    ]

{
    "queueName": "basic",
    "attributes": {},
    "players": [
        {
            "id": "Player 1",
            "customData": {
                "player_ip": "8.8.8.8"
            }
        },
        {
            "id": "Player 2",
            "customData": {
                "player_ip": "4.4.4.4"
            }
        }
    ]

{
    "queueName": "basic",
    "attributes": {},
    "players": [
        {
            "id": "Player 1",
            "customData": {
                "player_ip": "8.8.8.8"
            }
        },
        {
            "id": "Player 2",
            "customData": {
                "player_ip": "4.4.4.4"
            }
        }
    ]

Partie 3 - Test

Maintenance et support

Ce dépôt contient du code exemple à des fins éducatives et de référence. Unity examinera les mises à jour de ce dépôt mais ne garantira pas les délais de réponse pour les problèmes ou les demandes de tirage.

Dépannage

Si vous avez des problèmes avec les exemples de ce dépôt, reportez-vous à la documentation de votre fournisseur d'hébergement choisi ou demandez de l'aide sur les forums de discussions Unity.

Intégrer Edgegap facilement en quelques minutes

Commencez l'intégration maintenant!

Mettez votre jeu en ligne facilement
& en quelques minutes

Ajoutez des Déploiements de Serveurs de Jeu Dédiés au Matchmaking de Unity

Objectif & Portée

Partie 1 - Configuration

Partie 1 - Configuration

Exigences

Partie 2 - Edgegap : Hébergement et orchestration de serveurs de jeu

Partie 2 - Edgegap : Hébergement et orchestration de serveurs de jeu

Edgegap : Hébergement de Serveur de Jeu & Orchestration

Déployer le module

Configurer le Tableau de Bord Unity

Intégration Client

Partie 3 - Test

Partie 3 - Test

Maintenance et support

Dépannage

Mettez votre jeu en ligne facilement
& en quelques minutes

Get Started

Get Started

Get Started

Get Started

Get Started

Get Started

Ajoutez des Déploiements de Serveurs de Jeu Dédiés au Matchmaking de Unity

Objectif & Portée

Partie 1 - Configuration

Partie 1 - Configuration

Exigences

Partie 2 - Edgegap : Hébergement et orchestration de serveurs de jeu

Partie 2 - Edgegap : Hébergement et orchestration de serveurs de jeu

Edgegap : Hébergement de Serveur de Jeu & Orchestration

Déployer le module

Configurer le Tableau de Bord Unity

Intégration Client

Partie 3 - Test

Partie 3 - Test

Maintenance et support

Dépannage

Mettez votre jeu en ligne facilement & en quelques minutes

Get Started

Get Started

Get Started

Get Started

Get Started

Get Started

Mettez votre jeu en ligne facilement
& en quelques minutes