Utiliser les données d'éditeur des joueurs pour récompenser le jeu sur plusieurs titres

Les récompenses impliquent généralement d’autres systèmes que les données des joueurs; cet exemple montre donc, par souci de simplicité, comment attribuer de la monnaie virtuelle.

Exigences

Un compte de développeur PlayFab.
Un joueur doit se connecter aux deux titres avec les mêmes informations d’identification. Une approche consiste à utiliser des informations d’identification récupérables (Recoverable Credentials), comme décrit dans notre tutoriel Principes de base et pratiques exemplaires de connexion. Pour ajouter une connexion récupérable à un compte anonyme, consultez notre tutoriel sur la liaison de comptes.
Cet exemple nécessite une connaissance pratique de CloudScript :
- Notre exemple illustre une sécurité des données de base afin d’éviter la triche des joueurs. Vous pourriez de la même façon utiliser l’API serveur sur un serveur de jeu personnalisé, si le titre en utilise.
Les récompenses déclenchées au moyen de PlayFab nécessitent l’utilisation des fonctionnalités PlayFab appropriées. Les récompenses PlayFab peuvent prendre la forme de monnaie virtuelle, d’objets d’inventaire, de données de joueur personnalisées, de statistiques, etc. La distribution de récompenses en dehors des systèmes PlayFab est un sujet avancé qui n’est pas traité dans ce tutoriel.

Nous recommandons également aux développeurs de mettre en place une bonne gestion des erreurs pour tous les appels d’API serveur effectués depuis CloudScript.

Chaque jeu signale une connexion dans les données d’éditeur

Chaque jeu doit signaler qu’une connexion a eu lieu. Par souci de simplicité, notre exemple ne fournit qu’une récompense par titre, pour chaque autre titre de l’éditeur auquel le joueur a joué. N’hésitez pas à développer cette idée avec des compteurs, des horodatages ou d’autres mécanismes pour offrir des récompenses progressives ou séquentielles. Le CloudScript suivant doit être présent dans chaque jeu de votre studio.

// CloudScript/Javascript

var PUBLISHER_USED_TITLES_KEY = "playedTitleIds";
handlers.TrackTitleUsage = function () {
    // Get the User Publisher Data for this player, and convert it into our expected format
    var getRequest = { Keys: [PUBLISHER_USED_TITLES_KEY], PlayFabId: currentPlayerId };
    var getResult = server.GetUserPublisherInternalData(getRequest);
    var playedTitlesList = JSON.parse(getResult.Data[PUBLISHER_USED_TITLES_KEY].Value); // format is arbitrary, but this example assumes Array<string>
    if (!playedTitlesList)
        playedTitlesList = [];
    // Check if we've played this title already
    var alreadyPlayed = false;
    for (var i = 0; i < playedTitlesList.length; i++)
        alreadyPlayed = alreadyPlayed || playedTitlesList[i] === script.titleId;
    if (alreadyPlayed)
        return; // Nothing to do
    // Update the list of played titles, and re-save
    playedTitlesList.push(script.titleId);
    var setRequest = { PlayFabId: currentPlayerId, Data: { PUBLISHER_USED_TITLES_KEY: JSON.stringify(playedTitlesList) } };
    server.UpdateUserPublisherInternalData(setRequest);
}

Plus précisément, cet exemple montre l’utilisation de :

server.GetUserPublisherInternalData
server.UpdateUserPublisherInternalData.

Chaque jeu vérifie les récompenses échangeables

Une fois que vous suivez les titres joués, vous devez suivre et accorder les récompenses. Cette fonction CloudScript recherche et accorde les récompenses disponibles, en fonction des autres titres auxquels le joueur a joué.

// CloudScript/Javascript

var PUBLISHER_REDEEMED_TITLES_KEY = "redeemedTitleIds";
var MY_CROSS_TITLE_REWARDS = { "AU": 10 };
handlers.CheckCrossTitleRewards = function () {
    // Get the publisher data concerning cross-title rewards for this player
    var getRequest = { Keys: [PUBLISHER_USED_TITLES_KEY, PUBLISHER_REDEEMED_TITLES_KEY], PlayFabId: currentPlayerId };
    var getResult = server.GetUserPublisherInternalData(getRequest);
    var redeemedTitleRewards = JSON.parse(getResult.Data[PUBLISHER_REDEEMED_TITLES_KEY].Value); // format is arbitrary, but this example assumes { [key: string]: Array<string> }
    if (!redeemedTitleRewards)
        redeemedTitleRewards = {};
    var playedTitlesList = JSON.parse(getResult.Data[PUBLISHER_USED_TITLES_KEY].Value); // format is arbitrary, but this example assumes Array<string>
    if (!playedTitlesList)
        playedTitlesList = [];

    // Determine which titles are un-redeemed
    var unredeemedTitleIds = [];
    for (var i = 0; i < playedTitlesList.length; i++) {
        if (!redeemedTitleRewards.hasOwnProperty(playedTitlesList[i]) && playedTitlesList[i] !== script.titleId)
            unredeemedTitleIds.push(playedTitlesList[i]);
    }
    if (unredeemedTitleIds.length === 0)
        return null; // Nothing to redeem

    // Give the cross title rewards
    var multiplier = unredeemedTitleIds.length;
    var actualRewards = {}; // MY_CROSS_TITLE_REWARDS is a global constant, so don't modify it or you'll mess up future calls
    // Please note that the number of API calls that may be made from CloudScript, as well as the total available processing time is limited,
    // and so the number of rewards should be as small as possible (only one VC, in this case)
    for (var eachKey in MY_CROSS_TITLE_REWARDS) {
        actualRewards[eachKey] = MY_CROSS_TITLE_REWARDS[eachKey] * multiplier;
        server.AddUserVirtualCurrency({ PlayFabId: currentPlayerId, VirtualCurrency: eachKey, Amount: MY_CROSS_TITLE_REWARDS[eachKey] }); // Can only add 1 VC at a time
    }

    // Save the Publisher data indicating rewards are claimed
    redeemedTitleRewards[script.titleId] = playedTitlesList;
    var setRequest = { PlayFabId: currentPlayerId, Data: { PUBLISHER_REDEEMED_TITLES_KEY: JSON.stringify(redeemedTitleRewards) } };
    server.UpdateUserPublisherInternalData(setRequest);

    // Tell the client the reward
    return actualRewards;
};

Cet exemple illustre l’utilisation de server.GetUserPublisherInternalData (avec demande de plusieurs clés), server.UpdateUserPublisherInternalData et server.AddUserVirtualCurrency.

Les blocs de code représentent les étapes suivantes :

Récupération des données depuis PlayFab et analyse de celles-ci dans des structures de données locales (appel de GetUserPublisherInternalData).
Examen des données et recherche des ID de titre non encore récompensés.
Attribution des récompenses (appel de AddUserVirtualCurrency).
Mise à jour des récompenses réclamées (appel de UpdateUserPublisherInternalData).
Mise à disposition du montant de la récompense au client (au moyen de l’instruction return de CloudScript).

Conclusion

Les données d’éditeur des joueurs et les données des joueurs sont structurellement identiques. Les données des joueurs doivent être propres au titre, tandis que les données d’éditeur des joueurs ne doivent contenir que des informations pertinentes pour l’ensemble de vos titres.

Voir aussi

Simple In-Game Cross Promotion : récompensez les joueurs qui participent à plusieurs de vos jeux.

​Exigences

​Chaque jeu signale une connexion dans les données d’éditeur

​Chaque jeu vérifie les récompenses échangeables

​Conclusion

​Voir aussi

Exigences

Chaque jeu signale une connexion dans les données d’éditeur

Chaque jeu vérifie les récompenses échangeables

Conclusion

Voir aussi