AMAZON GAMELIFT MANUEL DU DÉVELOPPEUR FLEXMATCH VERSION - AWS ...

La page est créée Alexandre Renard
 
CONTINUER À LIRE
Amazon GameLift
Manuel du développeur FlexMatch
            Version
Amazon GameLift Manuel du développeur FlexMatch

Amazon GameLift: Manuel du développeur FlexMatch
Copyright © Amazon Web Services, Inc. and/or its affiliates. All rights reserved.

Amazon's trademarks and trade dress may not be used in connection with any product or service that is not Amazon's,
in any manner that is likely to cause confusion among customers, or in any manner that disparages or discredits
Amazon. All other trademarks not owned by Amazon are the property of their respective owners, who may or may not
be affiliated with, connected to, or sponsored by Amazon.
Amazon GameLift Manuel du développeur FlexMatch

Table of Contents
  Qu'est-ce qu'GameLift FlexMatch ? ....................................................................................................... 1
        Fonctions FlexMatch clés ............................................................................................................. 1
        FlexMatch avec GameLift hébergement ......................................................................................... 2
        Fonctionnement de FlexMatch ...................................................................................................... 2
              Composants de mise en relation ........................................................................................... 3
              FlexMatch processus de mise en relation ............................................................................... 4
  Configuration de ................................................................................................................................. 6
  Mise en route .................................................................................................................................... 7
        Intégration pour la mise en relation autonome ................................................................................. 7
        Intégration à l'hébergementGameLift .............................................................................................. 8
  Création d'un matchmakerFlexMatch .................................................................................................... 10
        Concevoir un matchmaker .......................................................................................................... 10
              Configuration d'un matchmaker de base ............................................................................... 10
              Choix d'une région AWS pour le matchmaker ....................................................................... 10
              Ajouter des éléments facultatifs ........................................................................................... 11
        Créer une configuration de mise en relation .................................................................................. 12
              Création d'un matchmaker pour l'hébergementGameLift .......................................................... 12
              Création d'un matchmaker pour FlexMatch autonome ............................................................. 14
        Créer un ensemble de règles ..................................................................................................... 15
              Concevoir un ensemble de règles ....................................................................................... 16
              Créer des ensembles de règles de mise en relation ............................................................... 25
              Exemples d'ensembles de règles ........................................................................................ 27
        Configuration de la notification d'événement .................................................................................. 41
              Configurer CloudWatch Events ........................................................................................... 41
              Configuration d'une rubrique SNS ........................................................................................ 41
  Préparation des jeux pourFlexMatch .................................................................................................... 43
        Ajouter FlexMatch à un client de jeu ............................................................................................ 43
              Se préparer à demander une mise en relation pour les joueurs ................................................ 43
              Demander une mise en relation pour les joueurs ................................................................... 44
              Suivre les événements de mise en relation ........................................................................... 45
              Demander l'acceptation du joueur ........................................................................................ 46
              Se connecter à une mise en relation ................................................................................... 46
              Exemples de demandes de mise en relation ......................................................................... 47
        Ajouter FlexMatch à un serveur de jeux hébergé surGameLift .......................................................... 48
              Configuration de votre serveur de jeux pour la mise en relation ................................................ 48
              Utiliser les données du matchmaker .................................................................................... 49
        Renvoi des jeux existants .......................................................................................................... 50
              Activation du remplissage automatique ................................................................................. 50
              Envoi de demandes de remplissage (à partir d'un serveur de jeux) ........................................... 51
              Envoi de requêtes de renvoi (depuis un service client) ............................................................ 53
              Mise à jour des données de mise en relation sur le serveur de jeux .......................................... 55
  Surveillance avec CloudWatch ............................................................................................................ 56
  Référence FlexMatch ......................................................................................................................... 57
        Référence d'API FlexMatch (kit SDK AWS) ................................................................................... 57
              Configurer les règles et les processus de mise en relation ...................................................... 57
              Demander une mise en relation pour un ou plusieurs joueurs .................................................. 58
              Langages de programmation disponibles .............................................................................. 58
        Schéma d'ensemble de règles .................................................................................................... 58
              Schéma d’ensemble de règles pour les parties de petite envergure ........................................... 59
              Schéma d’ensemble de règles pour les parties à grande échelle .............................................. 60
              Définitions des propriétés de schéma des ensembles de règles ................................................ 61
        Langage des règles .................................................................................................................. 65
              Types de règle ................................................................................................................. 66
              Expressions de propriété .................................................................................................... 68

                                                                    Version
                                                                      iii
Amazon GameLift Manuel du développeur FlexMatch

        Événements de mise en relation ................................................................................................. 71
                MatchmakingSearching ...................................................................................................... 71
                PotentialMatchCreated ....................................................................................................... 72
                AcceptMatch .................................................................................................................... 73
                AcceptMatchCompleted ...................................................................................................... 74
                MatchmakingSucceeded ..................................................................................................... 75
                MatchmakingTimedOut ...................................................................................................... 76
                MatchmakingCancelled ...................................................................................................... 77
                MatchmakingFailed ............................................................................................................ 78
Sécurité avec FlexMatch .................................................................................................................... 80
Versions des notes de mise à jour et du kit SDK ................................................................................... 81
Tous les guidesGameLift .................................................................................................................... 82
Glossaire AWS ................................................................................................................................. 83
 .................................................................................................................................................. lxxxiv

                                                                     Version
                                                                       iv
Amazon GameLift Manuel du développeur FlexMatch
                                    Fonctions FlexMatch clés

Qu'est-ce qu'GameLift FlexMatch ?
    GameLift FlexMatch est un service personnalisable de mise en relation pour les jeux multijoueur. Avec
    FlexMatch, vous pouvez créer un ensemble de règles personnalisé qui définit à quoi ressemble une
    mise en relation multijoueur pour votre jeu, et détermine comment évaluer et sélectionner les joueurs
    compatibles pour chaque mise en relation. Vous pouvez également personnaliser les principaux aspects du
    processus de mise en relation, y compris l'ajustement de l'algorithme correspondant, en fonction de votre
    jeu.

    FlexMatch est disponible pour une utilisation avec une solution d'hébergement de jeux GameLift (y
    compris Serveurs en temps réel), ou en tant que service autonome de mise en relation. Vous pouvez
    implémenter FlexMatch en tant que fonction autonome avec des jeux qui utilisent l'architecture peer-to-peer
    ou hébergent des serveurs de jeux sur site ou sur d'autres solutions de calcul cloud (y compris GameLift
    FleetIQ). Ce guide fournit des informations détaillées sur la création d'un système de mise en relation pour
    l'un de ces scénarios.

    FlexMatch vous donne la flexibilité nécessaire pour définir les priorités de mise en relation en fonction des
    exigences de votre jeu. Par exemple, vous pouvez effectuer les opérations suivantes :

    • Trouvez un équilibre entre la vitesse et la qualité de la partie. Définissez des règles de mise en relation
      pour trouver rapidement les rencontres qui sont suffisamment bonnes, ou autorisez les joueurs à
      attendre un peu plus pour trouver la meilleure rencontre possible pour une expérience joueur optimale.
    • Créez des rencontres basées sur des joueurs ou des équipes bien mis en relation. Crée une mise
      en relation où tous les joueurs ont des caractéristiques très similaires, telles que la compétence ou
      l'expérience. Sinon, formez des rencontres où les caractéristiques combinées de chaque équipe sont
      similaires, même si les caractéristiques des joueurs individuels sont plus variées.
    • Hiérarchisez les facteurs de latence des joueurs dans une mise en relation. Définissez une limite stricte
      de latence pour tous les joueurs d'une mise en relation ou assurez-vous que tous les joueurs d'une mise
      en relation connaissent une latence très similaire, ou les deux.

        Prêt à commencer à utiliser FlexMatch ?

        Suivez ces guides pour obtenir des conseils étape par étape sur la façon d'obtenir votre jeu
        opérationnel avec FlexMatch : guide.

        • Intégration d'FlexMatch avec l'hébergementGameLift (p. 8)
        • GameLift FlexMatch Intégration de pour la mise en relation autonome (p. 7)

Fonctions FlexMatch clés
    Les fonctions suivantes sont disponibles avec tous les scénarios FlexMatch, qu'elles soient utilisées en tant
    que service autonome ou avec l'hébergement de jeux GameLift.

    • Correspondance de joueur personnalisable. Concevez et construisez des matchmakers pour répondre
      à tous les modes de jeu que vous proposez à vos joueurs. Créez un ensemble de règles personnalisées
      pour évaluer les attributs de joueur clés (tels que le niveau de compétence ou le rôle) et les données de
      latence géographique pour former des rencontres de joueurs de grande qualité pour votre jeu.
    • Association basée sur la latence. Fournissez les données de latence des joueurs et créez des règles de
      mise en relation qui exigent que les joueurs d'une mise en relation aient des temps de réponse similaires.
      Cette fonction est utile lorsque les groupes de mise en relation de vos joueurs couvrent plusieurs régions
      géographiques.

                                                 Version
                                                    1
Amazon GameLift Manuel du développeur FlexMatch
                               FlexMatch avec GameLift hébergement

    • Prise en charge des tailles de rencontre allant jusqu'à 200 joueurs. Créez des rencontres impliquant
      jusqu'à 40 joueurs à l'aide de règles de rencontre personnalisées pour votre jeu. Créez des parties
      réunissant jusqu'à 200 joueurs à l'aide d'un processus de mise en relation personnalisé rationalisé pour
      gérer les temps d'attente des joueurs.
    • Acceptation des joueurs. Nécessitent que les joueurs s'inscrivent à une mise en relation proposée avant
      de finaliser la mise en relation et de démarrer une session de jeu. Utilisez cette fonction pour initier votre
      flux de travail d'acceptation personnalisé et signaler les réponses des joueurs à FlexMatch avant de
      placer une nouvelle session de jeu pour la mise en relation. Si tous les joueurs n'acceptent pas une mise
      en relation, la mise en relation proposée échoue et les joueurs qui ont accepté sont automatiquement
      renvoyés au pool de mise en relation.

      Prise en charge des parties des joueurs. Générez des rencontres pour des groupes de joueurs qui
      souhaitent jouer ensemble dans la même équipe. Utilisez FlexMatch pour trouver d'autres joueurs afin de
      remplir la mise en relation en fonction des besoins.
    • Règles de correspondance extensibles. Assouplissez progressivement les exigences de mise en relation
      après un certain délai sans trouver de correspondance. Une extension de règle vous permet de décider
      où et quand assouplir les règles initiales de la mise en relation, afin que les joueurs puissent participer à
      des jeux jouables dans un délai raisonnable.
    • Renvoi de correspondance. Remplissez les emplacements de joueur vides dans une session de jeu
      existante avec de nouveaux joueurs à bonne correspondance. Personnalisez quand et comment
      de nouveaux joueurs peuvent être demandés, et utilisez les mêmes règles de mise en relation
      personnalisées pour trouver des joueurs supplémentaires.

FlexMatch avec GameLift hébergement
    Pour les jeux hébergés avec GameLift, FlexMatch offre les fonctions supplémentaires suivantes. Ces
    fonctions sont disponibles lors de l'utilisation du service GameLift pour héberger des serveurs de jeux
    personnalisés, ou lors de l'utilisation de Serveurs en temps réel. Les jeux hébergés sur des ressources
    Amazon EC2 avec GameLift FleetIQ doivent implémenter FlexMatch en tant que fonction autonome.

    • Placement des sessions de jeu. Lorsqu'une mise en relation aboutit, FlexMatch demande
      automatiquement un nouveau placement de session de jeu à GameLift. Les données générées au cours
      de l'activité de mise en relation, y compris les affectations de joueur IDs et d'équipe, sont fournies au
      serveur de jeux afin qu'il puisse utiliser ces informations pour démarrer la session de jeu pour la mise en
      relation. FlexMatch transmet ensuite les informations de connexion de session de jeu afin que les clients
      puissent rejoindre le jeu. Le placement de session de jeu avec GameLift peut également utiliser les
      données de latence régionales des joueurs, si elles sont fournies, afin de réduire la quantité de latence
      perçue par tous les joueurs de la mise en relation.
    • Renvoi de correspondance automatique. Lorsque cette fonction est activée, FlexMatch envoie
      automatiquement une demande de renvoi de correspondance lorsqu'une nouvelle session de jeu
      commence avec des emplacements de joueur non remplis. Avec cette fonction, votre système de mise
      en relation démarre le processus de placement de session de jeu avec un nombre minimum de joueurs,
      puis remplit rapidement les emplacements restants. Le remplissage automatique ne peut pas être utilisé
      pour remplacer les joueurs qui abandonnent une session de jeu correspondante.

Fonctionnement Amazon GameLift FlexMatch d'
    Cette rubrique fournit une vue d'ensemble du GameLift FlexMatch service , y compris les composants de
    base d'un FlexMatch système et leur interaction.

    Vous pouvez utiliser FlexMatch avec des jeux qui utilisent l'hébergement GameLift géré ou avec des jeux
    qui utilisent une autre solution d'hébergement. Les jeux hébergés sur GameLift des serveurs , y compris

                                                  Version
                                                     2
Amazon GameLift Manuel du développeur FlexMatch
                              Composants de mise en relation

Serveurs en temps réel, utilisent le GameLift service intégré pour localiser automatiquement les serveurs
de jeux disponibles et démarrer des sessions de jeu pour les rencontres. Les jeux qui utilisent FlexMatch
en tant que service autonome, y compris GameLift FleetIQ, doivent se coordonner avec le système
d'hébergement existant pour attribuer des ressources d'hébergement et démarrer des sessions de jeu pour
les rencontres.

Pour obtenir des conseils détaillés sur la configuration FlexMatch de pour vos jeux, consultez Mise en route
avec FlexMatch (p. 7).

Composants de mise en relation
Un système de mise en FlexMatch relation comprend tout ou partie des composants suivants.

GameLiftComposants

Il s'agit GameLift des ressources qui contrôlent la façon dont le FlexMatch service effectue la mise en
relation pour votre jeu. Elles sont créées et gérées à l'aide GameLift d'outils, y compris la console et
l'interface de ligne de commande AWS, ou par programmation à l'aide du kit AWS SDK pour GameLift.

• FlexMatch configuration de mise en relation (également appelé matchmaker) – Un matchmaker est un
  ensemble de valeurs de configuration qui personnalise le processus de mise en relation pour votre jeu.
  Un jeu peut avoir plusieurs matchmakers, chacun configuré pour différents modes de jeu ou expériences
  selon les besoins. Lorsque votre jeu envoie une demande de mise en relation à FlexMatch, il spécifie le
  matchmaker à utiliser.
• FlexMatch Ensemble de règles de mise en relation – Un ensemble de règles contient toutes les
  informations nécessaires pour évaluer les joueurs d'une mise en relation potentielle et approuver ou
  rejeter. L'ensemble de règles définit la structure d'équipe d'une mise en relation, déclare les attributs
  de joueur qui sont utilisés pour l'évaluation et fournit des règles qui décrivent les critères d'une mise
  en relation acceptable. Les règles peuvent s'appliquer à des joueurs individuels, à des équipes ou à
  l'ensemble de la mise en relation. Par exemple, une règle peut exiger que chaque joueur de la mise
  en relation choisisse la même relation de jeu, ou exiger que toutes les équipes aient une moyenne de
  compétences de joueur similaire.
• GameLift File d'attente de session de jeu (pour FlexMatch l'hébergement GameLift géré uniquement)
  – Une file d'attente de session de jeu localise les ressources d'hébergement disponibles et démarre
  une nouvelle session de jeu pour la mise en relation. La configuration de la file d'attente détermine où
  GameLift recherche les ressources d'hébergement disponibles et comment sélectionner le meilleur hôte
  disponible pour une mise en relation.

Composants personnalisés

Les composants suivants comprennent les fonctionnalités requises pour un FlexMatch système complet
que vous devez implémenter en fonction de l'architecture de votre jeu.

• Interface de joueur pour la mise en relation – Cette interface permet aux joueurs de rejoindre une mise
  en relation. Au minimum, il initie une demande de mise en relation via le composant de service de mise
  en relation du client et fournit des données spécifiques au joueur, telles que les données de niveau de
  compétence et de latence, selon les besoins du processus de mise en relation.
      Note

      Comme bonne pratique, la communication avec le FlexMatch service doit être effectuée par un
      service backend, et non par un client de jeu.
• Service de mise en relation du client – Ce service champ les demandes de jonction de joueurs à partir de
  l'interface du joueur, génère des demandes de mise en relation et les envoie au FlexMatch service . Pour
  les demandes en cours, il surveille les événements de mise en relation, suit l'état de la mise en relation
  et agit en fonction des besoins. Selon la façon dont vous gérez l'hébergement de session de jeu dans

                                             Version
                                                3
Amazon GameLift Manuel du développeur FlexMatch
                          FlexMatch processus de mise en relation

  votre jeu, ce service peut renvoyer des informations de connexion de session de jeu aux joueurs. Ce
  composant utilise le kit SDK AWS avec GameLift l'API pour communiquer avec le FlexMatch service .
• Service de placement de rencontre (pour FlexMatch un service autonome uniquement) – Ce
  composant fonctionne avec votre système d'hébergement de jeux existant pour localiser les ressources
  d'hébergement disponibles et démarrer de nouvelles sessions de jeu pour les rencontres. Le composant
  doit obtenir les résultats de la mise en relation et extraire les informations nécessaires pour démarrer une
  nouvelle session de jeu, y compris les IDs de joueur, les attributs et les affectations d'équipe pour tous
  les joueurs de la mise en relation.

FlexMatch processus de mise en relation
Cette rubrique décrit un scénario de mise en relation de base et les interactions entre les différents
composants de votre jeu et le FlexMatch service .

Demande de mise en relation pour les joueurs

    Un joueur qui utilise votre client de jeu clique sur un bouton « Rejoindre le jeu ». Avec cette action,
    votre service de mise en relation client envoie une demande de mise en relation à FlexMatch. La
    demande identifie le FlexMatch matchmaker à utiliser lors de l'exécution de la demande. La demande
    inclut également les informations de joueur dont votre matchmaker personnalisé a besoin, telles que le
    niveau de compétence, les préférences de jeu ou les données de latence géographique. Vous pouvez
    effectuer des demandes de mise en relation pour un ou plusieurs joueurs.
Ajouter des demandes au pool de mise en relation

    Quand FlexMatch reçoit la demande de mise en relation, il génère un ticket de mise en relation et
    l'ajoute au pool de ticket du matchmaker. Le ticket reste dans le pool jusqu'à ce qu'il corresponde
    ou qu'un délai maximum soit atteint. Le service de mise en relation de votre client est régulièrement
    informé des événements de mise en relation, y compris des modifications de l'état du ticket.
Création d'une mise en relation

    Votre FlexMatch matchmaker exécute en permanence le processus suivant sur tous les tickets de son
    groupe :
    1. Le matchmaker trie le pool par âge de ticket, puis commence à créer une mise en relation
       potentielle à partir du ticket le plus ancien.
    2. Le matchmaker ajoute un second ticket à la mise en relation potentielle et évalue le résultat par
       rapport à vos règles de mise en relation personnalisées. Si la mise en relation potentielle réussit
       l'évaluation, les joueurs du ticket sont affectés à une équipe.
    3. Le matchmaker ajoute le prochain ticket dans l'ordre et répète le processus d'évaluation. Une fois
       tous les emplacements de joueur remplis, la mise en relation est prête.

    L'activité de mise en relation pour les parties à grande échelle (41 à 200 joueurs) utilise une version
    modifiée du processus décrit ci-dessus afin de créer des rencontres dans un délai raisonnable. Au lieu
    d'évaluer chaque ticket individuellement, le matchmaker divise un pool de ticket pré-trié en rencontres
    potentielles, puis équilibre chaque rencontre en fonction d'une caractéristique de joueur que vous avez
    spécifiée. Par exemple, un matchmaker peut pré-trier les tickets en fonction d'emplacements à faible
    latence similaires, puis utiliser l'équilibrage après la mise en relation pour s'assurer que les équipes
    sont mises en relation uniformément par compétence de joueur.
Rapport des résultats de mise en relation

    Lorsqu'une mise en relation acceptable est trouvée, tous les tickets correspondants sont mis à jour et
    un événement de mise en relation réussi est généré pour chaque ticket correspondant.
    • FlexMatch en tant que service autonome : votre jeu reçoit les résultats d'une mise en relation
      réussie. Les données de résultat incluent une liste de tous les joueurs mis en relation et leurs
      affectations d'équipe. Si vos demandes de mise en relation contiennent des informations sur la

                                             Version
                                                4
Amazon GameLift Manuel du développeur FlexMatch
                          FlexMatch processus de mise en relation

      latence des joueurs, les résultats suggèrent également un emplacement géographique optimal pour
      la mise en relation.
   • FlexMatch avec une solution GameLift d'hébergement : les résultats de la mise en relation sont
     automatiquement transmis à une file GameLift d'attente pour le placement de session de jeu. Le
     matchmaker détermine la file d'attente utilisée pour le placement de session de jeu.
Démarrer une session de jeu pour la mise en relation

    Une fois qu'une mise en relation proposée est correctement formée, une nouvelle session de jeu est
    démarrée. Vos serveurs de jeux doivent être en mesure d'utiliser les données de résultats de mise en
    relation, y compris les IDs de joueur et les affectations d'équipe, lors de la configuration d'une session
    de jeu pour la mise en relation.
    • FlexMatch en tant que service autonome : votre service de placement de mise en relation
      personnalisé obtient les données des résultats de mise en relation à partir d'événements de
      mise en relation réussis et se connecte à votre système de placement de session de jeu existant
      pour localiser une ressource d'hébergement disponible pour la mise en relation. Une fois qu'une
      ressource d'hébergement a été trouvée, le service de placement des rencontres coordonne avec
      votre système d'hébergement existant pour démarrer une nouvelle session de jeu et acquérir les
      informations de connexion.
    • FlexMatch avec une solution GameLift d'hébergement : la file d'attente de session de jeu localise
      le meilleur serveur de jeux disponible pour la mise en relation. En fonction de la façon dont la file
      d'attente est configurée, elle essaie de placer la session de jeu avec les ressources les moins
      onéreuses et où les joueurs subiront une faible latence (si les données de latence pour les joueurs
      sont fournies). Une fois que la session de jeu est correctement placée, le GameLift service invite le
      serveur de jeux à démarrer une nouvelle session de jeu, en transmettant les résultats de mise en
      relation et d'autres données de jeu facultatives.
Connecter les joueurs à la mise en relation

    Une fois qu'une session de jeu est démarrée, les joueurs se connectent à la session, revendiquent leur
    affectation d'équipe et commencent le gameplay.
    • FlexMatch en tant que service autonome : votre jeu utilise le système de gestion de session de jeu
       existant pour fournir les informations de connexion aux joueurs.
    • FlexMatch avec une solution GameLift d'hébergement : sur un placement de session de jeu réussi,
       FlexMatch met à jour tous les tickets correspondants avec les informations de connexion de session
       de jeu et un ID de session de joueur.

                                              Version
                                                 5
Amazon GameLift Manuel du développeur FlexMatch

Configuration d’FlexMatch
   GameLift FlexMatch est un service AWS et vous devez disposer d'un compte AWS pour utiliser ce service.
   La création d'un compte AWS est gratuite. Pour plus d'informations sur ce que vous pouvez faire avec un
   compte AWS, consultez Mise en route avec AWS.

   Si vous utilisez FlexMatch avec d'autres solutions GameLift, consultez les rubriques suivantes :

   • Configuration de l'accès pour l'hébergement GameLift et Serveurs en temps réel
   • Configuration de l'accès pour l'hébergement sur Amazon EC2 avec GameLift FleetIQ

   Pour configurer votre compte pour GameLift

   1.   Obtenez un compte. Ouvrez Amazon Web Services et choisissez Sign In to the Console (Se connecter
        à la console). Suivez les invites pour créer un nouveau compte ou vous connecter à un compte
        existant.
   2.   Configurez un groupe d'utilisateurs administratif. Ouvrez la console du service AWS Identity and
        Access Management (IAM) et suivez les étapes pour créer ou mettre à jour des utilisateurs ou des
        groupes d'utilisateurs. IAM gère l'accès à vos services et ressources AWS. Toute personne qui accède
        à vos ressources FlexMatch, à l'aide de la console GameLift ou en appelant GameLift APIs, doit
        bénéficier d'un accès explicite. Pour obtenir des instructions détaillées sur l'utilisation de la console (ou
        de l'interface de ligne de commande AWS ou d'autres outils) pour configurer des groupes d'utilisateurs,
        consultez Création d'utilisateurs IAM.
   3.   Attachez une stratégie d'autorisations à votre utilisateur ou groupe d'utilisateurs. L'accès aux
        services et ressources AWS est géré en attachant une stratégie IAM à un utilisateur ou à un groupe
        d'utilisateurs. Les stratégies d'autorisations spécifient un ensemble de services et d'actions AWS
        auxquels un utilisateur doit pouvoir accéder.

        Pour GameLift, vous devez créer une stratégie d'autorisations personnalisées et l'attacher à chaque
        utilisateur ou groupe d'utilisateurs. Une stratégie est un document JSON. Utilisez l'exemple ci-dessous
        pour créer votre stratégie.

   L'exemple suivant illustre une stratégie d'autorisations en ligne avec des autorisations administratives pour
   toutes les ressources et actions GameLift. Vous pouvez choisir de limiter l'accès en spécifiant uniquement
   des éléments spécifiques à FlexMatch.

   {
   "Version": "2012-10-17",
   "Statement":
     {
       "Effect": "Allow",
       "Action": "gamelift:*",
       "Resource": "*"
     }
   }

                                                 Version
                                                    6
Amazon GameLift Manuel du développeur FlexMatch
                            Intégration pour la mise en relation autonome

Mise en route avec FlexMatch
    Utilisez les ressources de cette section pour vous aider à démarrer la création d'un système de mise en
    relation avec FlexMatch.

    Rubriques
     • GameLift FlexMatch Intégration de pour la mise en relation autonome (p. 7)
     • Intégration d'FlexMatch avec l'hébergementGameLift (p. 8)

GameLift FlexMatch Intégration de pour la mise en
relation autonome
    Cette rubrique décrit le processus d'intégration complet pour implémenter FlexMatch en tant que service de
    mise en relation autonome. Utilisez ce processus si votre jeu multijoueur est hébergé à l'aide de matériel
    d'homologue à homologue, d'un matériel sur site configuré sur mesure ou d'autres primitives de calcul du
    cloud. Ce processus est également destiné à une utilisation avec GameLift FleetIQ, qui est une solution
    d'optimisation d'hébergement pour les jeux hébergés sur Amazon EC2. Si vous hébergez votre jeu à l'aide
    de l'hébergement GameLift géré (y compris Serveurs en temps réel), consultez Intégration d'FlexMatch
    avec l'hébergementGameLift (p. 8).

    Avant de commencer l'intégration, vous devez disposer d'un AWS compte et configurer les autorisations
    d'accès pour le GameLift service . Pour de plus amples informations, veuillez consulter Configuration
    d’FlexMatch (p. 6). Toutes les tâches essentielles liées à la création et à la gestion des GameLift FlexMatch
    matchmakers et des ensembles de règles peuvent être effectuées à l'aide de la Amazon GameLift
    console , mais vous pouvez également Obtenez et installez l'outil AWS Command Line Interface.

    1.   Créez un ensemble de règles de mise en FlexMatch relation. Votre ensemble de règles personnalisé
         fournit des instructions complètes sur la création d'une mise en relation. Dans celui-ci, vous définissez
         la structure et la taille de chaque équipe. Vous fournissez également un ensemble d'exigences qu'une
         mise en relation doit respecter pour être valide, qu' FlexMatch utilise pour inclure ou exclure des
         joueurs dans une mise en relation. Ces exigences peuvent s'appliquer aux joueurs individuels. Vous
         pouvez également personnaliser FlexMatch l'algorithme dans l'ensemble de règles, par exemple pour
         créer des parties à grande échelle avec jusqu'à 200 joueurs. Consultez ces rubriques :

         • Créer un ensemble de règlesFlexMatch (p. 15)
         • Exemples d'ensembles de règlesFlexMatch (p. 27)
    2.   Configurez des notifications pour les événements de mise en relation. Utilisez les notifications pour
         suivre l'activité de mise en FlexMatch relation, y compris le statut des demandes de mise en relation
         en attente. Il s'agit du mécanisme utilisé pour fournir les résultats d'une mise en relation proposée.
         Les demandes de mise en relation étant asynchrones, vous devez disposer d'un moyen pour suivre
         le statut des demandes. L'utilisation des notifications est l'option préférée pour cela. Consultez ces
         rubriques :

         • Configuration d'une notification d'événementFlexMatch (p. 41)
         • FlexMatch Événements de mise en relation (p. 71)
    3.   Configurez une configuration de FlexMatch mise en relation. Également appelé matchmaker, ce
         composant reçoit et traite les demandes de mise en relation. Vous configurez un matchmaker en
         spécifiant un ensemble de règles, une cible de notification et un temps d'attente maximal. Vous pouvez
         également activer les fonctions facultatives. Consultez ces rubriques :

         • Concevoir un FlexMatch matchmaker (p. 10)

                                                 Version
                                                    7
Amazon GameLift Manuel du développeur FlexMatch
                                    Intégration à l'hébergementGameLift

            • Créer une configuration de mise en relation (p. 12)
     4.     Créez un service de mise en relation client. Créez ou développez un service de client de jeu
            avec des fonctionnalités permettant de créer et d'envoyer des demandes de mise en relation à
            FlexMatch. Pour créer des demandes de mise en relation, ce composant doit avoir des mécanismes
            permettant d'obtenir les données de joueur requises par l'ensemble de règles de mise en relation et,
            éventuellement, les informations de latence régionale. Il doit également avoir une méthode pour créer
            et attribuer un ticket unique IDs pour chaque demande. Vous pouvez également choisir de créer un
            flux de travail d'acceptation de joueur qui nécessite que les joueurs choisissent une mise en relation
            proposée. Ce service doit également surveiller les événements de mise en relation pour obtenir
            les résultats de la mise en relation et lancer le placement de la session de jeu pour les rencontres
            réussies. Consultez cette rubrique :

            • Ajouter FlexMatch à un client de jeu (p. 43)
     5.     Créez un service de placement des parties. Créez un mécanisme qui fonctionne avec votre système
            d'hébergement de jeux existant pour localiser les ressources d'hébergement disponibles et démarrer
            de nouvelles sessions de jeu pour des rencontres réussies. Ce composant doit être en mesure
            d'utiliser les informations des résultats de la mise en relation pour obtenir un serveur de jeux disponible
            et démarrer une nouvelle session de jeu pour la mise en relation. Vous pouvez également implémenter
            un flux de travail pour effectuer des requêtes de renvoi de correspondance, qui utilise la mise en
            relation pour remplir les emplacements ouverts dans les sessions de jeu qui sont déjà en cours
            d'exécution.

Intégration d'FlexMatch avec
l'hébergementGameLift
     est disponible avec l'hébergement FlexMatch géré pour les serveurs de jeux personnalisés et
     GameLift.Serveurs en temps réel Pour ajouter la mise en relation FlexMatch à votre jeu, veuillez exécuter
     les tâches suivantes.

     • Définir un matchmaker. Un matchmaker reçoit les demandes de mise en relation des joueurs et les
       traite. Il regroupe les joueurs en fonction d'un ensemble de règles définies et, pour chaque mise en
       relation réussie, crée une nouvelle session de jeu et de joueur. Suivez ces étapes pour configurer un
       matchmaker :
          • Créer un ensemble de règles. Un ensemble de règles indique au matchmaker comment construire une
            mise en relation valide. Il spécifie la structure de l'équipe, ainsi que la manière d'évaluer les joueurs
            afin de les inclure dans une mise en relation. Consultez ces rubriques :
            • Créer un ensemble de règlesFlexMatch (p. 15)
            • Exemples d'ensembles de règlesFlexMatch (p. 27)
          • Créer une file d'attente de session de jeu. Une file d'attente localise la région la mieux adaptée à
            chaque mise en relation et crée une nouvelle session de jeu dans cette région. Vous pouvez utiliser
            une file d'attente existante ou en créer une nouvelle pour la mise en relation. Consultez cette rubrique :
            • Créer une file d'attente
          • Configurer des notifications (facultatif). Les demandes de mise en relation étant asynchrones, vous
            devez disposer d'un moyen pour suivre le statut des demandes. Les notifications représentent la
            meilleure option. Consultez cette rubrique :
            • Configuration d'une notification d'événementFlexMatch (p. 41)
          • Configurer un matchmaker. Une fois que vous disposez d'un ensemble de règles, d'une file d'attente
            et d'une cible pour les notifications, créez la configuration pour votre matchmaker. Consultez ces
            rubriques :
            • Concevoir un FlexMatch matchmaker (p. 10)
            • Créer une configuration de mise en relation (p. 12)

                                                     Version
                                                        8
Amazon GameLift Manuel du développeur FlexMatch
                            Intégration à l'hébergementGameLift

• Intégrez FlexMatch à votre service de client de jeu. Ajoutez des fonctionnalités au service du client de jeu
  pour démarrer de nouvelles sessions de jeu avec la mise en relation. Les demandes de mise en relation
  spécifient le matchmaker à utiliser et fournissent des données de joueur nécessaires pour la mise en
  relation. Consultez cette rubrique :
  • Ajouter FlexMatch à un client de jeu (p. 43)
• Intégrez FlexMatch à votre serveur de jeux. Ajoutez des fonctionnalités à votre serveur de jeux pour
  démarrer des sessions créées par le biais de la mise en relation. Les demandes de ce type de session
  de jeu incluent des informations spécifiques à la partie, y compris les joueurs et les affectations d’équipe.
  Le serveur de jeux a besoin de pouvoir utiliser ces informations et y accéder lors de la construction d'une
  session de jeu pour la mise en relation. Consultez cette rubrique :
  • Ajouter FlexMatch à un serveur de jeux hébergé surGameLift (p. 48)
• Configurez le remplissage FlexMatch (facultatif). Demandez des mises en relation supplémentaires
  de joueurs afin de remplir les emplacements ouverts dans les jeux existants. Vous pouvez activer le
  remplissage automatique pour laisserGameLift gérer les demandes de remplissage. Vous pouvez
  également gérer manuellement le remplissage en ajoutant des fonctionnalités à votre client ou serveur
  de jeu afin de pouvoir initier des demandes de remplissage. Consultez cette rubrique :
  • Renvoi de jeux existants avec FlexMatch (p. 50)
      Note

      Le remplissage FlexMatch n'est pas disponible actuellement pour les jeux qui utilisent Serveurs
      en temps réel.

                                             Version
                                                9
Amazon GameLift Manuel du développeur FlexMatch
                                   Concevoir un matchmaker

Protection d'un
matchmakerGameLiftFlexMatch
    Un matchmaker FlexMatch effectue la tache de créer une mise en relation pour un jeu. Il gère le pool des
    demandes de mise en relation reçues, forme les équipes d'une mise en relation, traite et sélectionne les
    joueurs pour trouver les meilleurs groupes de joueurs possibles et lance le processus de placement et de
    démarrage d'une session de jeu pour la mise en relation. Cette rubrique décrit les principaux aspects d'un
    matchmaker et explique comment configurer un matchmaker personnalisé pour votre jeu.

    Pour une description détaillée de la façon dont un matchmaker FlexMatch traite les demandes de mise en
    relation qu'il reçoit, consultez FlexMatch processus de mise en relation (p. 4).

    Rubriques
     • Concevoir un FlexMatch matchmaker (p. 10)
     • Créer une configuration de mise en relation (p. 12)
     • Créer un ensemble de règlesFlexMatch (p. 15)
     • Configuration d'une notification d'événementFlexMatch (p. 41)

Concevoir un FlexMatch matchmaker
    Cette rubrique fournit des conseils sur la façon de concevoir un matchmaker adapté à votre jeu.

    Configuration d'un matchmaker de base
    Au minimum, un matchmaker a besoin des éléments suivants :

    • L'ensemble de règles détermine la taille et la portée des équipes pour une mise en relation et définit
      un ensemble de règles à utiliser lors de l'évaluation des joueurs pour une mise en relation. Chaque
      matchmaker est configuré pour utiliser un seul ensemble de règles. Consultez Créer un ensemble de
      règlesFlexMatch (p. 15) et Exemples d'ensembles de règlesFlexMatch (p. 27).
    • La cible de notification reçoit toutes les notifications d'événements de mise en relation. Vous devez
      configurer une rubrique Amazon Simple Notification Service (SNS), puis ajouter l'ID de rubrique au
      matchmaker. Pour plus d'informations sur la configuration des notifications, consultez Configuration d'une
      notification d'événementFlexMatch (p. 41).
    • Le délai d'expiration de la demande détermine combien de temps les demandes de mise en relation
      peuvent rester dans le pool de demandes et être évaluées pour les rencontres potentielles. Une fois
      qu'une demande a dépassé le délai, elle a échoué à créer une mise en relation et elle supprimée du
      pool.
    • Lorsque vous utilisez FlexMatch avec l'hébergement GameLift géré, la file d'attente de session de jeu
      trouve les meilleures ressources disponibles pour héberger une session de jeu pour la mise en relation
      et démarre une nouvelle session de jeu. Chaque file d'attente est configurée avec une liste des régions
      AWS et des types de ressources (y compris les instances Spot ou à la demande) qui déterminent où
      les sessions de jeu peuvent être placées. Pour plus d'informations sur les files d'attente , consultez
      Utilisation des files d'attente sur plusieurs régions.

    Choix d'une région AWS pour le matchmaker
    Décidez où vous souhaitez que l'activité de mise en relation se déroule et créez votre matchmaker
    (configuration de la mise en relation et ensemble de règles) dans cette région. Toutes les demandes

                                                Version
                                                  10
Amazon GameLift Manuel du développeur FlexMatch
                              Ajouter des éléments facultatifs

pour le matchmaker sont envoyées à un groupe de ticket où elles sont triées et évaluées pour des
correspondances viables. Une fois les rencontres effectuées, les joueurs peuvent ensuite être dirigés vers
des sessions de jeu à n'importe quel emplacement pris en charge par votre solution d'hébergement.

Lorsque vous choisissez AWS Regions (Régions AWS) pour vos matchmakers, tenez compte de la façon
dont l'emplacement peut affecter leurs performances et comment optimiser l'expérience de mise en relation
pour les joueurs ciblés. Nous vous recommandons les bonnes pratiques suivantes :

• Placez un matchmaker dans une région AWS proche de vos joueurs —et votre service client qui envoie
  des demandes de mise en FlexMatch relation. Cette approche réduit l'effet de latence sur votre flux de
  travail de demande de mise en relation et le rend plus efficace.
• Si votre jeu atteint un public mondial, envisagez de créer des matchmakers dans plusieurs régions
  et d'acheminer les demandes de mise en relation vers le matchmaker le plus proche du joueur.
  Outre l'amélioration de l'efficacité, cela entraîne la formation de groupes de tickets avec des joueurs
  géographiquement proches les uns des autres, ce qui améliore la capacité du matchmaker à mettre en
  relation des joueurs en fonction des exigences de latence.
• Lorsque vous utilisez FlexMatch avec l'hébergement GameLift géré, placez votre matchmaker et la file
  d'attente de session de jeu qu'il utilise dans la même région AWS. Cela permet de réduire la latence des
  communication entre le matchmaker et la file d'attente.

Les FlexMatch ressources MatchmakingConfiguration et MatchmakingRuleSet peuvent être placées
dans les régions AWS GameLiftprises en charge par les régions suivantes : USA Est (Virginie du Nord),
USA Ouest (Oregon), UE Centre (Francfort), UE Ouest (Irlande), Asie-Pacifique Sud-Est (Sydney), Asie-
Pacifique Nord (Séoul et Tokyo) et Chine (Beijing).

Ajouter des éléments facultatifs
En plus de ces exigences minimales, vous pouvez configurer votre matchmaker avec les options
supplémentaires suivantes. Si vous utilisez FlexMatch avec une solution GameLift d'hébergement, de
nombreuses fonctions sont intégrées. Si vous utilisez FlexMatch en tant que service de mise en relation
autonome, vous pouvez souhaiter intégrer ces fonctionnalités à votre système.

Acceptation des joueurs

Vous pouvez configurer un matchmaker pour exiger que tous les joueurs sélectionnés pour une mise en
relation acceptent la participation. Si votre système nécessite l'acceptation, tous les joueurs doivent avoir
la possibilité d'accepter ou de rejeter une mise en relation proposée. Une mise en relation doit recevoir les
acceptations de tous les joueurs avant d'être effective. Si un joueur refuse ou ne parvient pas à accepter
une mise en relation, la mise en relation proposée est ignorée et les tickets sont traités comme suit. Les
tickets dans lesquels tous les joueurs du ticket ont accepté la mise en relation sont renvoyés au pool de
mise en relation pour poursuivre le traitement. Les tickets pour lesquels au moins un joueur a rejeté la mise
en relation ou n'a pas répondu sont mis en état d'échec et ne sont plus traités. L'acceptation des joueurs
nécessite une limite de temps ; tous les joueurs doivent accepter une mise en relation proposée dans la
limite de temps pour que la mise en relation se poursuive.

Mode de remplissage

Utilisez FlexMatch le remplissage pour que vos sessions de jeu soient remplies avec de nouveaux joueurs
bien mis en relation tout au long de la durée de vie de la session de jeu. Lors du traitement des demandes
de remplissage, FlexMatch utilise le même matchmaker que celui utilisé pour mettre en relation les joueurs
d'origine. Vous pouvez personnaliser la façon dont les tickets de remplissage sont hiérarchisés avec les
tickets pour les nouvelles rencontres, en plaçant les tickets de remplissage à l'avant ou à la fin de la ligne.
Cela signifie qu'à mesure que de nouveaux joueurs entrent dans le pool de mise en relation, ils sont plus
ou moins susceptibles d'être placés dans un jeu existant que dans un jeu nouvellement formé.

Le remplissage manuel est disponible que votre jeu utilise FlexMatch avec GameLift l'hébergement géré
ou avec d'autres solutions d'hébergement. Le remplissage manuel vous offre la flexibilité dont vous avez
besoin pour déterminer quand déclencher une demande de remplissage. Par exemple, vous pouvez

                                             Version
                                               11
Amazon GameLift Manuel du développeur FlexMatch
                              Créer une configuration de mise en relation

     ajouter de nouveaux joueurs uniquement au cours de certaines phases de votre jeu ou uniquement lorsque
     certaines conditions existent.

     Le remplissage automatique est disponible uniquement pour les jeux qui utilisent GameLift l'hébergement
     géré. Avec cette fonction activée, si une session de jeu commence avec des emplacements de joueur
     ouverts, GameLift commence automatiquement à générer des demandes de remplissage pour celle-ci.
     Cette fonction vous permet de configurer la mise en relation de sorte que les nouveaux jeux commencent
     avec un nombre minimum de joueurs, puis rapidement remplis lorsque de nouveaux joueurs entrent dans
     le pool de mise en relation. Vous pouvez désactiver le remplissage automatique à tout moment pendant la
     durée de vie de la session de jeu.

     Propriétés du jeu

     Pour les jeux qui utilisent FlexMatch avec l'hébergement GameLift géré, vous pouvez fournir des
     informations supplémentaires à transmettre à un serveur de jeux chaque fois qu'une nouvelle session
     de jeu est demandée. Il peut s'agir d'un moyen utile de transmettre les configurations de mode de jeu
     nécessaires pour démarrer une session de jeu pour le type de rencontres en cours de création. Toutes les
     sessions de jeu pour les rencontres créées par un matchmaker reçoivent le même ensemble de propriétés
     de jeu. Vous pouvez modifier les informations de propriété de jeu en créant différentes configurations de
     mise en relation.

     Emplacements de joueur réservés

     Vous pouvez définir certains emplacements de joueur comme étant réservés et remplis ultérieurement.
     Pour cela, vous devez configurer la propriété « additional player count » d'une configuration de mise en
     relation.

     Données d'événement personnalisées

     Utilisez cette propriété pour inclure un ensemble d'informations personnalisées dans tous les événements
     liés à l'activité de mise en relation et destinés au matchmaker. Cette fonction peut être utile pour le suivi
     d'une activité spécifique à votre jeu, y compris le suivi des performances de vos matchmakers.

Créer une configuration de mise en relation
     Pour configurer un matchmaker FlexMatch pour traiter les demandes de mise en relation, vous créez
     une configuration de mise en relation. Utilisez la console GameLift ou l'AWS Command Line Interface
     (AWS CLI). Pour plus d'informations sur la conception de votre matchmaker, consultez the section called
     “Concevoir un matchmaker” (p. 10).

     Création d'un matchmaker pour
     l'hébergementGameLift
     Avant de créer une configuration de mise en relation, vous devez créer votre ensemble de règles et une
     GameLiftfile d'attente de sessions de jeu à utiliser avec le matchmaker.

     Console

         1.    Ouvrez la console GameLift à l'adresse https://console.aws.amazon.com/gamelift/home.
         2.    Basculez vers la région où vous souhaitez placer votre matchmaker. Pour obtenir la liste des
               régions qui prennent en charge les configurations de mise en relation Choix d'une région AWS
               pour le matchmaker (p. 10), consultez FlexMatch.
         3.    Dans le menu principal, choisissez Create matchmaking configuration. Complétez les détails de la
               configuration de mise en relation.

               • Nom – Créez un nom de matchmaker pertinent afin de pouvoir l'identifier facilement dans une
                 liste et dans les métriques. Le nom d'un matchmaker doit être unique au sein d'une région. Les

                                                  Version
                                                    12
Vous pouvez aussi lire