Classements avec Azure Functions

Dans ce didacticiel, vous allez apprendre à implémenter des classements à l’aide de CloudScript, plus précisément via Azure Functions. Cette approche est puissante, car elle vous permet de créer une logique personnalisée côté serveur sans nécessiter de mise à 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 par la suite, vous pouvez mettre à jour la fonction Azure de manière indépendante, souvent sans modifier le client, selon la complexité de la mise à jour.

Prérequis

Pour suivre ce didacticiel, vous avez besoin des éléments suivants :

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 d’envoyer 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, ici 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 via les méthodes HTTP GET et POST sans aucune authentification.
Dans la fonction, nous définissons le Title ID PlayFab et la clé secrète de développeur afin d’authentifier nos requêtes auprès des services PlayFab. Vous pouvez modifier la façon dont vous accédez à 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.
Nous appelons ensuite 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 portant le nom fourni. Pour en savoir plus sur la création de classements, consultez 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 développer votre logique de jeu personnalisée. La manière 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. Vous pouvez également configurer des règles d’automatisation pour déclencher cette fonction Azure en fonction d’événements spécifiques. 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