タイトルニュースのクイックスタート

2025-05-02

タイトルニュースは、パッチメモやゲームがホストする大きなイベントについて、プレイヤーに配信する仕組みです。次のような、いくつかの基本的な要素があります。

日付
Status
タイトル
本文
Languages

注意

本文の要素は、生テキストまたは JSON を含む文字列です。

要件

このクイックスタートは、他のトピック内にある情報に基づいています。質問がある場合は、次のトピックのリンクをご参照ください。

PlayFab ゲームマネージャーを理解しておく必要があります。

注意

ローカライズされたタイトルニュースを続行するには、タイトルの既定の言語がすでに設定されている必要があります。

タイトルニュースがローカライズされるようになりました。タイトルでの既定の言語で動作するための詳細と、プレイヤーの優先言語で動作するための詳細については、「既定の言語の設定」チュートリアルでご確認ください。ローカライズされたタイトルニュースを続行するには、タイトルの既定の言語がそれに合わせて設定されている必要がありますのでご注意ください。

PlayFab では、ゲームデベロッパーに代わってローカライズされた文字列の保存をサポートしています。タイトルニュースのエントリ用の言語でタイトルと本文を関連付けています。

希望する言語の正しい文字列でプレイヤーを提供するために必要なロジックを追加しました。クライアントがタイトルニュースを検索する場合、プレイヤーの優先言語によって、異なるバージョンのタイトルニュースを受信します。複数の翻訳バージョンを 1 つのタイトルニュースエントリに追加できます。

タイトルニュースエントリの作成

タイトルニュースエントリを作成するには、次の 2 つの方法があります。

ゲームマネージャー経由です。
管理 API のメソッド AddNews を使用します。

ゲームマネージャーでタイトルニュースを作成する

ゲームマネージャー でタイトルニュースエントリを作成するには、

次の図に示すように、タイトル - >[コンテンツ] - >[タイトルニュース] - > [新しいタイトルニュース] に移動します。

タイトルニュース

このチュートリアルでは、タイトルの既定の言語は英語であると想定しています。タイトルニュースを保存する前に、既定の言語の文字列を追加する必要があるということです。

言語を追加するには、[言語の追加] をクリックし、追加する言語を選択して、ローカライズされた文字列を入力するだけです。 [タイトルニュースの保存] ボタンを選択すると、エントリが作成されます。

タイムスタンプは、タイトルニュースの横に表示される時間です。タイムスタンプは、[タイトルニュースの保存] ボタンを選択したときに、自動的にシステム日に設定されますが、手動で設定することもできます。タイトルニュースページを保存すると、タイトルニュースエントリの一覧があるページにリダイレクトされます。

PlayFab 管理 API を使用して、タイトルニュースを作成する

AddNews メソッドを呼出し、タイトルニュースを作成できます。この管理 API を使用すると、カスタマイズされたタイムスタンプを指定できます。この方法で追加されたニュースは、直ちに公開されます。 AddNews メソッドから返されるニュース ID を使用して、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()));
}

既存のタイトルニュースエントリを更新する

タイトルニュースエントリのコンテンツのみをゲームマネージャーで変更できます。

ゲームマネージャーで変更するエントリを検索し、選択するには、

左側のメニューに移動し、[コンテンツ] を選択します。
[タイトルニュース] タブに移動します。
[既存エントリ] を選択します。

更新して、保存し、必要に応じてローカライズされたバージョンを追加するには、

エントリの [タイトル]、[ステータス]、または [データ] を更新します。
[タイトルニュースの保存] ボタンを選択します。
単一の言語のみでタイトルと本文が書かれているタイトルニュースエントリを更新する場合、[言語の追加] を選択すると、このタイトルニュースのローカライズされたバージョンを追加できます。

将来公開予定の非公開エントリを投稿する場合、公開とアーカイブの状態を使って処理する方法があります。タイトルニュースの更新では、スペルミスの修正もできます。

タイトルニュースを削除する

エントリが不要になったら、ゲームマネージャーで削除できます。

変更するエントリを検索するには、次のように実行します。

[タイトル] に移動します。
左側のメニューで、[コンテンツ] を選択します。
[ニュースタイトル] に移動します。
[既存エントリ] のチェックボックスをチェックします。
削除する [タイトルニュース] エントリを選択し、[X タイトルニュースの削除] をクリックします。

次の方法で共有

タイトル ニュースのクイックスタート

要件

タイトル ニュース エントリの作成

ゲーム マネージャーでタイトル ニュースを作成する

PlayFab 管理 API を使用して、タイトル ニュースを作成する

タイトル ニュースを読み取る

既存のタイトル ニュース エントリを更新する

タイトル ニュースを削除する

フィードバック

その他のリソース