Classements avec Azure Functions

Dans ce tutoriel, vous apprendrez à implémenter des classements à l’aide de CloudScript, plus précisément au moyen d’Azure Functions. Cette approche est puissante, car elle vous permet de créer une logique personnalisée côté serveur sans nécessiter de mises à jour du client. En définissant la logique liée aux classements dans une fonction Azure, votre client peut appeler cette fonction pour exécuter le code. Si des modifications sont nécessaires plus tard, vous pouvez mettre à jour la fonction Azure de façon indépendante, souvent sans modifier le client, selon la complexité de la mise à jour.

Prérequis

Pour suivre ce tutoriel, vous avez besoin de :

Un compte PlayFab. Si vous n’en avez pas, vous pouvez en créer un ici.
Un abonnement Azure. Si vous n’en avez pas, vous pouvez en créer un ici.

Pour plus de détails sur la création d’une fonction Azure, consultez ce guide. Créer votre première fonction dans Azure à l’aide de Visual Studio

Créer un classement à l’aide d’Azure Functions

Dans cette section, nous allons créer un classement qui vous permet de soumettre des scores et de récupérer les meilleurs scores.

[Function("LeaderboardExample")]
public async Task<HttpResponseData> RunAsync([HttpTrigger(AuthorizationLevel.Anonymous, "get", "post")] HttpRequestData req)
{
    _logger.LogInformation("C# HTTP trigger function processed a request.");

    PlayFabSettings.staticSettings.TitleId = "78C3E"; // Change this value to your own titleId from PlayFab Game Manager
    PlayFabSettings.staticSettings.DeveloperSecretKey = "WJT5SBP7PUFH61JHE39QQ4F1SJKGBWBJR647CH1WYB9CS3MZDD"; // Change this to your title's secret key from Game Manager
                                                                                                              // Check if parameter exists
    if (string.IsNullOrEmpty(req.Query["leaderboardName"]))
    {
        var badResponse = req.CreateResponse(HttpStatusCode.BadRequest);
        badResponse.Headers.Add("Content-Type", "text/plain; charset=utf-8");
        badResponse.WriteString("Please pass a leaderboardName on the query string");
        return badResponse;
    }

    PlayFabAuthenticationContext authContext = await LoginAsTitleEntity();
    var result = await CreateLeaderboardDefinitionAsync(authContext, req.Query["leaderboardName"]);
    if (result != null)
    {
        if (result.Error != null) {
            PlayFabError apiError = result.Error;
            var response = req.CreateResponse(HttpStatusCode.BadRequest);
            response.Headers.Add("Content-Type", "text/plain; charset=utf-8");
            if (apiError != null)
            {
                response.WriteString("Something went wrong with your API call.  :");
                response.WriteString("Here's some debug information:");
                response.WriteString(PlayFabUtil.GenerateErrorReport(apiError));
                return response;
            }
            response.WriteString("Something went wrong with your API call but it wasn't possible to get a PlayFab error description.");
            return response;
        }
        else
        {
            var response = req.CreateResponse(HttpStatusCode.OK);
            response.Headers.Add("Content-Type", "text/plain; charset=utf-8");
            response.WriteString("Leaderboard created successfully!");
            return response;
        }
    }
    else 
    {
        var response = req.CreateResponse(HttpStatusCode.BadRequest);
        response.Headers.Add("Content-Type", "text/plain; charset=utf-8");
        response.WriteString("Something went wrong with your API call.  :");
        return response;
    }    
    
}

L’attribut de fonction [Function("LeaderboardExample")] définit le nom de la fonction, dans ce cas LeaderboardExample.
La fonction est déclenchée par une requête HTTP, comme l’indique l’attribut [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post")]. Cela signifie que la fonction est accessible au moyen des méthodes HTTP GET et POST sans aucune authentification.
Dans la fonction, nous définissons l’ID de titre PlayFab et la clé secrète de développeur pour authentifier nos requêtes auprès des services PlayFab. Vous pouvez modifier la façon d’accéder à ces valeurs selon ce qui convient le mieux à votre cas particulier et à vos exigences de sécurité.
La fonction vérifie si le paramètre de requête « leaderboardName » est fourni dans la requête.
Ensuite, nous appelons la méthode LoginAsTitleEntity pour nous authentifier en tant qu’entité de titre, ce qui est nécessaire pour créer des définitions de classement.
Enfin, nous appelons la méthode CreateLeaderboardDefinitionAsync pour créer une définition de classement avec le nom fourni. Pour en savoir plus sur la création de classements, vous pouvez consulter Créer un classement de base et Aller plus loin avec les classements.

La méthode RunAsync sert de point d’entrée pour votre fonction Azure. À partir de là, vous pouvez définir et appeler des méthodes supplémentaires pour élaborer votre logique de jeu personnalisée. La façon dont vous gérez les erreurs ou interagissez avec plusieurs services PlayFab dépend entièrement de vous, ce qui vous offre une flexibilité totale dans votre implémentation. De plus, vous pouvez configurer des règles d’automatisation pour déclencher cette fonction Azure en fonction d’événements précis. Pour plus de détails, consultez cette page.

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

Prérequis

Créer un classement à l’aide d’Azure Functions

Voir aussi

​Prérequis

​Créer un classement à l’aide d’Azure Functions

​Voir aussi

Prérequis

Créer un classement à l’aide d’Azure Functions

Voir aussi