Inicio rápido de noticias del título - XBOX Game Development Documentation

Las noticias del título son un mecanismo para comunicarse con sus jugadores acerca de notas de la versión o grandes eventos que su juego pueda organizar. Contienen algunos elementos básicos:

Fecha
Estado
Título
Cuerpo
Idiomas

El elemento Cuerpo es una cadena que puede contener texto sin formato o JSON.

Requisitos

Este inicio rápido se basa en información presentada en otros temas. Consulte los vínculos a los temas que aparecen a continuación si tiene alguna pregunta.

Debe estar familiarizado con Game Manager de PlayFab.

Ya debe tener establecido un idioma predeterminado del título para continuar con las noticias del título localizadas.

Las noticias del título ahora se pueden localizar. Para obtener más información sobre cómo trabajar con los idiomas predeterminados de su título y con los idiomas preferidos de sus jugadores, consulte el tutorial Configuración de idiomas predeterminados. Recuerde: para continuar con las noticias del título localizadas, debe tener establecido el idioma predeterminado del título en consecuencia.

PlayFab admite el almacenamiento de cadenas localizadas en nombre de los desarrolladores de juegos, asociando un título y un cuerpo con un idioma para una entrada de noticias del título. Hemos agregado la lógica necesaria para proporcionar a sus jugadores las cadenas correctas para el idioma que prefieran. Cuando el cliente consulta las noticias del título, recibirá diferentes versiones de las noticias del título, según el idioma preferido del jugador. Puede agregar varias versiones traducidas a una única entrada de noticias del título.

Creación de entradas de noticias del título

Hay dos maneras de crear entradas de noticias del título:

Mediante Game Manager.
Con el método AddNews de la API de administración.

Creación de noticias del título con Game Manager

Para crear entradas de noticias del título con Game Manager: Vaya a su título -> Content -> Title News -> New Title News, como se muestra en la imagen siguiente. Para los fines de este tutorial, supondremos que el idioma predeterminado de su título es el inglés. Esto significa que debe agregar cadenas para su idioma predeterminado antes de poder guardar las noticias del título. Agregar más idiomas es tan sencillo como hacer clic en ADD LANGUAGE, elegir el idioma que quiere agregar y, a continuación, escribir las cadenas localizadas. Seleccione el botón Save Title News y su entrada quedará creada. La marca de tiempo es la hora que los jugadores verán junto a las noticias del título. La marca de tiempo se establece automáticamente en la fecha del sistema en el momento en que selecciona el botón Save Title News, pero también puede establecerla manualmente. Después de guardar la página de noticias del título, se le redirigirá de nuevo a la página que contiene la lista de sus entradas de noticias del título.

Creación de noticias del título con la API de administración de PlayFab

Puede crear noticias del título llamando al método AddNews. El uso de esta API de administración le permite especificar una marca de tiempo personalizada. Las noticias agregadas de esta manera se publican inmediatamente. A continuación, puede agregar contenido localizado al elemento que acaba de crear llamando a AddLocalizedNews, con el identificador de noticias devuelto por el método AddNews. El ejemplo de código siguiente lo demuestra.

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()));
}

Lectura de las noticias del título

El método GetTitleNews hace que leer las noticias del título sea muy sencillo. El método devuelve todas las entradas de noticias del título publicadas y no devuelve las entradas archivadas ni las no publicadas.

Llamar a GetTitleNews desde la API de cliente devolverá las entradas de noticias en el idioma preferido del jugador, si el elemento de noticias del título tiene contenido localizado agregado en ese idioma, o en el idioma predeterminado del título.
Llamar a GetTitleNews desde la API de servidor devolverá las entradas de noticias en el idioma predeterminado del título.

// 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()));
}

Actualización de una entrada de noticias del título existente

El contenido de una entrada de noticias del título solo se puede modificar en Game Manager. Para localizar y seleccionar la entrada que quiere modificar en Game Manager:

Vaya al menú de la izquierda y seleccione Content.
Vaya a la pestaña Title News.
Seleccione Existing Entry.

Para realizar sus actualizaciones, guardarlas y, opcionalmente, agregar versiones localizadas:

Actualice Title, Status o Data para la entrada.
Seleccione el botón Save Title News.
Si está actualizando una entrada de noticias del título que solo tiene un título y un cuerpo en un único idioma, ahora puede agregar versiones localizadas de estas noticias del título seleccionando Add Language.

Si tiene previsto publicar entradas no publicadas para una versión futura, esta será la manera de hacerlas pasar por los estados de publicada y archivada. Actualizar las noticias del título también le permite corregir errores tipográficos.

Eliminación de noticias del título

Cuando una entrada ya no sea necesaria, puede eliminarla en Game Manager. Busque la entrada que quiere modificar y, a continuación:

Vaya a su título.
En el menú de la izquierda, seleccione Content.
Vaya a Title News.
Marque la casilla de la entrada existente.
Seleccione las entradas de Title News que quiere eliminar y elija X Delete Title News.

​Requisitos

​Creación de entradas de noticias del título

​Creación de noticias del título con Game Manager

​Creación de noticias del título con la API de administración de PlayFab

​Lectura de las noticias del título

​Actualización de una entrada de noticias del título existente

​Eliminación de noticias del título

Requisitos

Creación de entradas de noticias del título

Creación de noticias del título con Game Manager

Creación de noticias del título con la API de administración de PlayFab

Lectura de las noticias del título

Actualización de una entrada de noticias del título existente

Eliminación de noticias del título