遊戲新聞快速入門 - XBOX Game Development Documentation

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

日期
狀態
標題
本文
語言

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

需求

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

您應該熟悉 PlayFab Game Manager。

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

遊戲新聞現在可以當地語系化。如需使用遊戲預設語言和玩家慣用語言的詳細資料，請檢閱設定預設語言教學課程。請記住，若要繼續使用當地語系化遊戲新聞，您必須相應地設定遊戲預設語言。

PlayFab 透過將標題和本文與遊戲新聞項目的語言建立關聯，支援代替遊戲開發人員儲存當地語系化字串。我們已新增必要的邏輯，為您的玩家提供其慣用語言的正確字串。當用戶端查詢遊戲新聞時，會根據玩家的慣用語言收到不同版本的遊戲新聞。您可以將多個翻譯版本新增至單一遊戲新聞項目。

建立遊戲新聞項目

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

透過 Game Manager。
使用 Admin API 方法 AddNews。

使用 Game Manager 建立遊戲新聞

若要使用 Game Manager 建立遊戲新聞項目：瀏覽至您的遊戲 -> Content -> Title News -> New Title News，如下圖所示。

在本教學課程中，我們假設您遊戲的預設語言是英文。這表示您必須先新增預設語言的字串，才能儲存遊戲新聞。新增更多語言非常簡單，只要按一下 ADD LANGUAGE，選擇要新增的語言，然後輸入當地語系化字串即可。選取 Save Title News 按鈕，即可建立您的項目。時間戳記是玩家在遊戲新聞旁邊看到的時間。時間戳記會在您選取 Save Title News 按鈕時自動設定為系統日期，但您也可以手動設定。儲存遊戲新聞頁面後，您會被重新導向回包含遊戲新聞項目清單的頁面。

使用 PlayFab Admin API 建立遊戲新聞

您可以呼叫 AddNews 方法建立遊戲新聞。使用此 Admin API 可讓您指定自訂時間戳記。以這種方式新增的新聞會立即發佈。接著，您可以使用 AddNews 方法傳回的新聞識別碼呼叫 AddLocalizedNews，將當地語系化內容新增至您剛建立的項目。下列程式碼範例示範了此做法。

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 時，如果遊戲新聞項目已新增該語言的當地語系化內容，就會以玩家的慣用語言傳回新聞項目，否則會以遊戲預設語言傳回。
從伺服器 API 呼叫 GetTitleNews 時，會以遊戲預設語言傳回新聞項目。

// 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。

​需求

​建立遊戲新聞項目

​使用 Game Manager 建立遊戲新聞

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

​讀取遊戲新聞

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

​刪除遊戲新聞

需求

建立遊戲新聞項目

使用 Game Manager 建立遊戲新聞

使用 PlayFab Admin API 建立遊戲新聞

讀取遊戲新聞

更新現有的遊戲新聞項目

刪除遊戲新聞