> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Title News 快速入门

> 创建并发布带有 title、body、日期、状态和语言字段的本地化 PlayFab Title News 帖子，以便与玩家分享补丁说明和活动更新。

Title News 是与你的玩家沟通有关补丁说明或你的游戏可能举办的大型活动的机制。它包含几个基本元素：

* **Date**
* **Status**
* **Title**
* **Body**
* **Language(s)**

<Note>
  Body 元素是一个字符串，可以包含原始文本或 JSON。
</Note>

## 要求

本快速入门以其他主题中呈现的信息为基础。如有疑问，请参考以下主题链接。

* 你应该熟悉 PlayFab [Game Manager](/services/playfab/live-service-management/gamemanager/quickstart)。

<Note>
  你必须已设置 **title 默认语言**，才能继续使用本地化 title news。
</Note>

* Title news 现在可以本地化。有关处理 title 中默认语言和玩家首选语言的详细信息，请查看[设置默认语言](/services/playfab/live-service-management/game-configuration/title-communications/news/setting-default-languages)教程。请记住——要继续使用本地化 title news，你必须相应地设置 **title 默认语言**。

PlayFab 通过将 title 和 body 与 title news 条目的语言关联，支持代表游戏开发者存储本地化字符串。

我们添加了必要的逻辑，以便为你的玩家提供他们偏好的语言的正确字符串。当客户端查询 title news 时，他们将根据玩家的首选语言收到不同版本的 title news。你可以向单个 title news 条目添加多个翻译版本。

## 创建 Title News 条目

有两种方式创建 Title News 条目：

1. 通过 Game Manager。
2. 使用 Admin API 方法 [AddNews](xref:titleid.playfabapi.com.admin.title-widedatamanagement.addnews)。

### 使用 Game Manager 创建 title news

要使用 **Game Manager** 创建 title news 条目：

导航到你的 title -> **Content** -> **Title News** -> **New Title News**，如下图所示。

<img src="https://mintcdn.com/microsoft-4404708b/3hg2JQs0m7qmDqay/images/playfab/live-service-management/game-configuration/title-communications/tutorials/game-manager-content-title-news-new-title-news.png?fit=max&auto=format&n=3hg2JQs0m7qmDqay&q=85&s=5ab429d952131a1e9b15196bc586eaf2" alt="Title News" width="1021" height="958" data-path="images/playfab/live-service-management/game-configuration/title-communications/tutorials/game-manager-content-title-news-new-title-news.png" />

在本教程中，我们假设你的 title 默认语言是英语。这意味着你必须先添加默认语言的字符串，才能保存 title news。

添加更多语言就像单击 **ADD LANGUAGE**、选择要添加的语言，然后键入本地化字符串一样简单。选择 **Save Title News** 按钮，你的条目就创建了。

时间戳是玩家将在 title news 旁边看到的时间。时间戳会在你选择 **Save Title News** 按钮时自动设置为系统日期，但你*也*可以手动设置它。保存 title news 页面后，你将被重定向回包含 title news 条目列表的页面。

### 使用 PlayFab Admin API 创建 title news

你可以通过调用 [AddNews](xref:titleid.playfabapi.com.admin.title-widedatamanagement.addnews) 方法来创建 title news。使用此 Admin API 允许你指定自定义时间戳。以这种方式添加的新闻会*立即*发布。然后，你可以使用 `AddNews` 方法返回的新闻 ID，通过调用 [AddLocalizedNews](xref:titleid.playfabapi.com.admin.title-widedatamanagement.addlocalizednews) 向你刚创建的条目添加本地化内容。

下面的代码示例演示了这一点。

```csharp theme={null}
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()));
}
```

## 读取 title news

`GetTitleNews` 方法使读取 title news 变得非常简单。该方法返回所有已发布的 title news 条目，不返回已归档和未发布的条目。

* 从客户端 API 调用 [GetTitleNews](xref:titleid.playfabapi.com.client.title-widedatamanagement.gettitlenews) 时，如果 title news 项已添加该语言的本地化内容，将以玩家的首选语言返回新闻条目，或以 title 默认语言返回。
* 从服务器 API 调用 [GetTitleNews](xref:titleid.playfabapi.com.server.title-widedatamanagement.gettitlenews) 时，将以 title 默认语言返回新闻条目。

```csharp theme={null}
// 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()));
}
```

## 更新现有 title news 条目

title news 条目的内容只能在 Game Manager 中修改。

要在 **Game Manager** 中查找并选择你要修改的条目：

* 转到左侧的菜单并选择 **Content**。
* 转到你的 **Title News** 选项卡。
* 选择 **Existing Entry**。

要进行更新、保存它们并可选择添加本地化版本：

* 更新条目的 **Title**、**Status** 或 **Data**。
* 选择 **Save Title News** 按钮。
* 如果你正在更新一个只有单一语言的标题和正文的 title news 条目，你现在可以通过选择 **Add Language** 添加此 title news 的本地化版本。

如果你计划为将来的发布发布未发布的条目，这将是使它们通过已发布和已归档状态的方式。更新 title news 还可以让你修复拼写错误。

## 删除 title news

一旦不再需要某个条目，你可以在 **Game Manager** 中删除它。

找到你要修改的条目，然后：

* 导航到你的 **Title**。
* 在左侧菜单中选择 **Content**。
* 转到 **Title News**。
* 选中 **Existing Entry** 的复选框。
* 选择你要删除的 **Title News** 条目并选择 **X Delete Title News**。


## Related topics

- [快速入门](/zh-CN/services/playfab/economy-monetization/economy-v2/quickstart.md)
- [Title Data 快速入门](/zh-CN/services/playfab/live-service-management/game-configuration/titledata/quickstart.md)
- [排行榜快速入门](/zh-CN/services/playfab/community/leaderboards/quickstart-leaderboards.md)
- [Photon 快速入门](/zh-CN/services/playfab/live-service-management/service-gateway/add-ons/photon/quickstart.md)
- [Experiments 快速入门](/zh-CN/services/playfab/live-service-management/game-configuration/experiments/quickstart.md)