> ## 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.

# 遊戲新聞快速入門

> 建立並發佈包含標題、本文、日期、狀態和語言欄位的當地語系化 PlayFab 遊戲新聞貼文，與玩家分享修補程式說明和活動更新。

遊戲新聞是一種與玩家溝通的機制，可用於發佈修補程式說明或您的遊戲可能舉辦的大型活動。它包含幾個基本元素：

* **日期**
* **狀態**
* **標題**
* **本文**
* **語言**

<Note>
  Body 元素是可包含原始文字或 JSON 的字串。
</Note>

## 需求

本快速入門以其他主題中提供的資訊為基礎。如有疑問，請參閱下列主題連結。

* 您應該熟悉 PlayFab [Game Manager](/zh-TW/services/playfab/live-service-management/gamemanager/quickstart)。

<Note>
  您必須已設定**遊戲預設語言**，才能繼續使用當地語系化遊戲新聞。
</Note>

* 遊戲新聞現在可以當地語系化。如需使用遊戲預設語言和玩家慣用語言的詳細資料，請檢閱[設定預設語言](/zh-TW/services/playfab/live-service-management/game-configuration/title-communications/news/setting-default-languages)教學課程。請記住，若要繼續使用當地語系化遊戲新聞，您必須相應地設定**遊戲預設語言**。

PlayFab 透過將標題和本文與遊戲新聞項目的語言建立關聯，支援代替遊戲開發人員儲存當地語系化字串。

我們已新增必要的邏輯，為您的玩家提供其慣用語言的正確字串。當用戶端查詢遊戲新聞時，會根據玩家的慣用語言收到不同版本的遊戲新聞。您可以將多個翻譯版本新增至單一遊戲新聞項目。

## 建立遊戲新聞項目

建立遊戲新聞項目的方式有兩種：

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

### 使用 Game Manager 建立遊戲新聞

若要使用 **Game Manager** 建立遊戲新聞項目：

瀏覽至您的遊戲 -> **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="遊戲新聞" 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" />

在本教學課程中，我們假設您遊戲的預設語言是英文。這表示您必須先新增預設語言的字串，才能儲存遊戲新聞。

新增更多語言非常簡單，只要按一下 **ADD LANGUAGE**，選擇要新增的語言，然後輸入當地語系化字串即可。選取 **Save Title News** 按鈕，即可建立您的項目。

時間戳記是玩家在遊戲新聞旁邊看到的時間。時間戳記會在您選取 **Save Title News** 按鈕時自動設定為系統日期，但您*也*可以手動設定。儲存遊戲新聞頁面後，您會被重新導向回包含遊戲新聞項目清單的頁面。

### 使用 PlayFab Admin API 建立遊戲新聞

您可以呼叫 [AddNews](xref:titleid.playfabapi.com.admin.title-widedatamanagement.addnews) 方法建立遊戲新聞。使用此 Admin API 可讓您指定自訂時間戳記。以這種方式新增的新聞會*立即*發佈。接著，您可以使用 `AddNews` 方法傳回的新聞識別碼呼叫 [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()));
}
```

## 讀取遊戲新聞

`GetTitleNews` 方法讓讀取遊戲新聞變得非常簡單。此方法會傳回所有已發佈的遊戲新聞項目，而不會傳回已封存和未發佈的項目。

* 從用戶端 API 呼叫 [GetTitleNews](xref:titleid.playfabapi.com.client.title-widedatamanagement.gettitlenews) 時，如果遊戲新聞項目已新增該語言的當地語系化內容，就會以玩家的慣用語言傳回新聞項目，否則會以遊戲預設語言傳回。
* 從伺服器 API 呼叫 [GetTitleNews](xref:titleid.playfabapi.com.server.title-widedatamanagement.gettitlenews) 時，會以遊戲預設語言傳回新聞項目。

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

## 更新現有的遊戲新聞項目

遊戲新聞項目的內容只能在 Game Manager 中修改。

若要在 **Game Manager** 中找到並選取您要修改的項目：

* 前往左側功能表並選取 **Content**。
* 前往您的 **Title News** 索引標籤。
* 選取 **Existing Entry**。

若要進行更新、儲存更新，並選擇性地新增當地語系化版本：

* 更新項目的 **Title**、**Status** 或 **Data**。
* 選取 **Save Title News** 按鈕。
* 如果您正在更新的遊戲新聞項目只有單一語言的標題和本文，您現在可以選取 **Add Language** 來新增此遊戲新聞的當地語系化版本。

如果您打算為未來的版本張貼未發佈的項目，您將透過這種方式讓它們轉換為已發佈和已封存狀態。更新遊戲新聞也可讓您修正錯字。

## 刪除遊戲新聞

不再需要某個項目時，您可以在 **Game Manager** 中將其刪除。

找到您要修改的項目，然後：

* 瀏覽至您的**遊戲**。
* 在左側功能表中，選取 **Content**。
* 前往 **Title News**。
* 勾選 **Existing Entry** 的核取方塊。
* 選取您要刪除的 **Title News** 項目，然後選擇 **X Delete Title News**。


## Related topics

- [PlayFab 參與概觀](/zh-TW/services/playfab/live-service-management/game-configuration/title-communications/overview.md)
- [遊戲資料快速入門](/zh-TW/services/playfab/live-service-management/game-configuration/titledata/quickstart.md)
- [新聞](/zh-TW/services/playfab/live-service-management/game-configuration/title-communications/news/index.md)
- [取得遊戲新聞](/zh-TW/services/playfab/api-references/rest/client/title-wide-data-management/get-title-news.md)
- [快速入門](/zh-TW/services/playfab/economy-monetization/economy-v2/quickstart.md)