Démarrage rapide des actualités de titre - XBOX Game Development Documentation

Les actualités de titre sont un mécanisme de communication avec vos joueurs pour les notes de correctifs ou les grands événements organisés par votre jeu. Elles contiennent quelques éléments de base :

Date
Status
Title
Body
Language(s)

L’élément Body est une chaîne pouvant contenir du texte brut ou du JSON.

Configuration requise

Ce démarrage rapide s’appuie sur des informations présentées dans d’autres rubriques. Reportez-vous aux liens suivants si vous avez des questions.

Vous devez connaître Game Manager de PlayFab.

Une langue par défaut du titre doit déjà être définie pour poursuivre avec les actualités de titre localisées.

Les actualités de titre peuvent désormais être localisées. Pour plus d’informations sur l’utilisation des langues par défaut de votre titre et des langues préférées de vos joueurs, consultez le tutoriel Définition des langues par défaut. N’oubliez pas : pour poursuivre avec les actualités de titre localisées, la langue par défaut du titre doit être définie en conséquence.

PlayFab prend en charge le stockage de chaînes localisées pour le compte des développeurs de jeux, en associant un titre et un corps à une langue pour une entrée d’actualité de titre. Nous avons ajouté la logique nécessaire pour fournir à vos joueurs les chaînes correspondant à leur langue préférée. Lorsque le client interroge les actualités de titre, il reçoit différentes versions de celles-ci en fonction de la langue préférée du joueur. Vous pouvez ajouter plusieurs versions traduites à une même entrée d’actualité de titre.

Création d’entrées d’actualités de titre

Il existe deux façons de créer des entrées d’actualités de titre :

Via Game Manager.
À l’aide de la méthode d’API Admin AddNews.

Création d’actualités de titre avec Game Manager

Pour créer des entrées d’actualités de titre avec Game Manager : Accédez à votre titre -> Content -> Title News -> New Title News, comme illustré dans l’image suivante.

Pour les besoins de ce tutoriel, nous supposerons que la langue par défaut de votre titre est l’anglais. Cela signifie que vous devez ajouter des chaînes pour votre langue par défaut avant de pouvoir enregistrer l’actualité de titre. Pour ajouter d’autres langues, il suffit de cliquer sur ADD LANGUAGE, de choisir la langue à ajouter, puis de saisir les chaînes localisées. Sélectionnez le bouton Save Title News : votre entrée est créée. L’horodatage correspond à l’heure que les joueurs verront à côté de l’actualité de titre. Il est automatiquement défini sur la date système au moment où vous sélectionnez le bouton Save Title News, mais vous pouvez également le définir manuellement. Après l’enregistrement de la page d’actualité de titre, vous êtes redirigé vers la page contenant la liste de vos entrées d’actualités de titre.

Création d’actualités de titre à l’aide de l’API Admin PlayFab

Vous pouvez créer des actualités de titre en appelant la méthode AddNews. Cette API Admin vous permet de spécifier un horodatage personnalisé. Les actualités ajoutées de cette manière sont publiées immédiatement. Vous pouvez ensuite ajouter du contenu localisé à l’élément que vous venez de créer en appelant AddLocalizedNews, avec l’ID d’actualité renvoyé par la méthode AddNews. L’exemple de code suivant illustre ce fonctionnement.

void CreateNews() {
    PlayFabAdminAPI.AddNews(new AddNewsRequest {
        Timestamp = new DateTime(2014, 1, 8, 12, 0, 0), // Any date - This one is the founding of PlayFab
        Title = "My Second News",
        Body = "This is my second news post."
    },
    result => Debug.Log("News post added!"),
    error => Debug.LogError(error.GenerateErrorReport()));
}
void CreateNews() {
    PlayFabAdminAPI.AddLocalizedNewsRequest(new AddLocalizedNewsRequest{
                   NewsId = "74623b12-6c80-ee4b-7c3b-58e638aa62bd",
                   Language = "de"
                   Title = " Meine zweite Nachricht",
                   Body = " Dies ist meine zweite Nachricht."
    },
    result => Debug.Log("Localized news post added!"),
    error => Debug.LogError(error.GenerateErrorReport()));
}

Lecture des actualités de titre

La méthode GetTitleNews facilite grandement la lecture des actualités de titre. Elle renvoie toutes les entrées d’actualités de titre publiées, mais pas les entrées archivées et non publiées.

L’appel de GetTitleNews depuis l’API cliente renvoie les entrées d’actualités dans la langue préférée du joueur si du contenu localisé a été ajouté dans cette langue pour l’élément d’actualité, ou sinon dans la langue par défaut du titre.
L’appel de GetTitleNews depuis l’API serveur renvoie les entrées d’actualités dans la langue par défaut du titre.

// Using the Client API method
void ReadTitleNews() {
    PlayFabClientAPI.GetTitleNews(new GetTitleNewsRequest(), result => {
        Debug.Log("Got latest news!");
        // Process news using result.News
    }, error => Debug.LogError(error.GenerateErrorReport()));
}

// Using the Server API method
void ReadTitleNews() {
    PlayFabServerAPI.GetTitleNews(new GetTitleNewsRequest(), result => {
        Debug.Log("Got latest news!");
        // Process news using result.News
    }, error => Debug.LogError(error.GenerateErrorReport()));
}

Mise à jour d’une entrée d’actualité de titre existante

Le contenu d’une entrée d’actualité de titre ne peut être modifié que dans Game Manager. Pour repérer et sélectionner l’entrée à modifier dans Game Manager :

Accédez au menu de gauche et sélectionnez Content.
Accédez à votre onglet Title News.
Sélectionnez l’Existing Entry.

Pour effectuer vos mises à jour, les enregistrer et éventuellement ajouter des versions localisées :

Mettez à jour le Title, le Status ou les Data de l’entrée.
Sélectionnez le bouton Save Title News.
Si vous mettez à jour une entrée d’actualité de titre qui ne comporte un titre et un corps que dans une seule langue, vous pouvez désormais en ajouter des versions localisées en sélectionnant Add Language.

Si vous prévoyez de publier des entrées non publiées pour une version future, c’est ainsi que vous les ferez passer par les états publié et archivé. La mise à jour des actualités de titre vous permet également de corriger des fautes de frappe.

Suppression d’actualités de titre

Lorsqu’une entrée n’est plus nécessaire, vous pouvez la supprimer dans Game Manager. Repérez l’entrée à modifier, puis :

Accédez à votre Title.
Dans le menu de gauche, sélectionnez Content.
Accédez à Title News.
Cochez la case de l’Existing Entry.
Sélectionnez les entrées Title News à supprimer et choisissez X Delete Title News.

​Configuration requise

​Création d’entrées d’actualités de titre

​Création d’actualités de titre avec Game Manager

​Création d’actualités de titre à l’aide de l’API Admin PlayFab

​Lecture des actualités de titre

​Mise à jour d’une entrée d’actualité de titre existante

​Suppression d’actualités de titre

Configuration requise

Création d’entrées d’actualités de titre

Création d’actualités de titre avec Game Manager

Création d’actualités de titre à l’aide de l’API Admin PlayFab

Lecture des actualités de titre

Mise à jour d’une entrée d’actualité de titre existante

Suppression d’actualités de titre