Início rápido de notícias do título - XBOX Game Development Documentation

As notícias do título são um mecanismo para se comunicar com seus jogadores sobre notas de patch ou grandes eventos que seu jogo possa estar promovendo. Elas contêm alguns elementos básicos:

Date
Status
Title
Body
Language(s)

O elemento Body é uma cadeia de caracteres que pode conter texto bruto ou JSON.

Requisitos

Este início rápido se baseia em informações apresentadas em outros tópicos. Consulte os links de tópicos a seguir se tiver dúvidas.

Você deve estar familiarizado com o Game Manager do PlayFab.

Você já precisa ter um idioma padrão do título definido para continuar com as notícias do título localizadas.

As notícias do título agora podem ser localizadas. Para obter detalhes sobre como trabalhar com os idiomas padrão do seu título e com os idiomas preferenciais dos seus jogadores, revise o tutorial Definir idiomas padrão. Lembre-se: para continuar com as notícias do título localizadas, você precisa ter o idioma padrão do título definido adequadamente.

O PlayFab oferece suporte ao armazenamento de cadeias de caracteres localizadas em nome dos desenvolvedores de jogos, associando um título e um corpo a um idioma em uma entrada de notícias do título. Adicionamos a lógica necessária para fornecer aos seus jogadores as cadeias de caracteres corretas para o idioma de preferência deles. Quando o cliente consulta as notícias do título, ele recebe versões diferentes das notícias com base no idioma preferencial do jogador. Você pode adicionar várias versões traduzidas a uma única entrada de notícias do título.

Criar entradas de notícias do título

Há duas formas de criar entradas de notícias do título:

Por meio do Game Manager.
Usando o método da Admin API AddNews.

Criar notícias do título com o Game Manager

Para criar entradas de notícias do título com o Game Manager: Navegue até seu título -> Content -> Title News -> New Title News, conforme mostrado na imagem a seguir.

Para os fins deste tutorial, vamos supor que o idioma padrão do seu título seja o inglês. Isso significa que você precisa adicionar as cadeias de caracteres do idioma padrão antes de poder salvar as notícias do título. Adicionar mais idiomas é tão simples quanto clicar em ADD LANGUAGE, escolher o idioma que você deseja adicionar e digitar as cadeias de caracteres localizadas. Selecione o botão Save Title News, e sua entrada será criada. O carimbo de data/hora é o horário que os jogadores verão ao lado das notícias do título. O carimbo de data/hora é definido automaticamente como a data do sistema no momento em que você seleciona o botão Save Title News, mas você também pode defini-lo manualmente. Depois de salvar a página de notícias do título, você será redirecionado de volta à página que contém a lista das suas entradas de notícias do título.

Criar notícias do título usando a PlayFab Admin API

Você pode criar notícias do título chamando o método AddNews. Usar essa Admin API permite especificar um carimbo de data/hora personalizado. As notícias adicionadas dessa forma são publicadas imediatamente. Em seguida, você pode adicionar conteúdo localizado ao item que acabou de criar chamando AddLocalizedNews, com a ID da notícia retornada pelo método AddNews. O exemplo de código a seguir demonstra isso.

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

Ler as notícias do título

O método GetTitleNews facilita muito a leitura das notícias do título. O método retorna todas as entradas de notícias do título publicadas e não retorna entradas arquivadas e não publicadas.

Chamar GetTitleNews pela API de cliente retornará as entradas de notícias no idioma preferencial do jogador, se o item de notícias do título tiver conteúdo localizado adicionado nesse idioma, ou no idioma padrão do título.
Chamar GetTitleNews pela API de servidor retornará as entradas de notícias no idioma padrão do 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()));
}

Atualizar uma entrada de notícias do título existente

O conteúdo de uma entrada de notícias do título só pode ser modificado no Game Manager. Para localizar e selecionar a entrada que você deseja modificar no Game Manager:

Acesse o menu à esquerda e selecione Content.
Acesse a guia Title News.
Selecione Existing Entry.

Para fazer as atualizações, salvá-las e, opcionalmente, adicionar versões localizadas:

Atualize o Title, o Status ou os Data da entrada.
Selecione o botão Save Title News.
Se você estiver atualizando uma entrada de notícias do título que tem título e corpo em um único idioma, agora poderá adicionar versões localizadas dessas notícias selecionando Add Language.

Se você planeja publicar entradas não publicadas para uma versão futura, é assim que você as fará passar pelos estados publicado e arquivado. A atualização das notícias do título também permite corrigir erros de digitação.

Excluir notícias do título

Quando uma entrada não for mais necessária, você poderá excluí-la no Game Manager. Localize a entrada que você deseja modificar e, em seguida:

Navegue até seu Title.
No menu à esquerda, selecione Content.
Acesse Title News.
Marque a caixa de seleção da Existing Entry.
Selecione as entradas de Title News que você deseja excluir e escolha X Delete Title News.

​Requisitos

​Criar entradas de notícias do título

​Criar notícias do título com o Game Manager

​Criar notícias do título usando a PlayFab Admin API

​Ler as notícias do título

​Atualizar uma entrada de notícias do título existente

​Excluir notícias do título

Requisitos

Criar entradas de notícias do título

Criar notícias do título com o Game Manager

Criar notícias do título usando a PlayFab Admin API

Ler as notícias do título

Atualizar uma entrada de notícias do título existente

Excluir notícias do título