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

# Game Saves 開発者ガイド

> 用語、XGameSave および XGameSaveFiles API、ユーザー モデル、PLM、セキュリティ、および認定に関するガイダンスを用いて、XBOX GDK Game Saves をタイトルに統合します。

このガイドは、Game Saves 機能をタイトルに統合するための出発点を提供します。ユーザー モデル、セキュリティ、認定要件など、必須の用語、利用可能な API の概要、および重要な考慮事項について取り上げます。

## 概要

Game Saves エコシステム全体で次の用語が使用されます。

* **Game Saves エコシステム**: 以前は *Connected Storage* または `XGameSave` と呼ばれていたこのエコシステムは、ゲームがデバイス上でデータを保存する方法と、そのデータをクラウドと同期する方法を管理します。エコシステムは、保存されたデータをコンテナーと BLOB に整理します。この整理により、タイトルはデバイス間でプレイヤーの進捗を保存、更新、および取得することができます。
* **タイトル**: 開発中のゲームです。
* **サンドボックス**: タイトルが実行される環境です。
* **Microsoft パートナー センター**: タイトルの構成とサンドボックスを管理する Microsoft の Web ポータルです。
* **サービス構成識別子 (SCID):** XBOX services 内のタイトルのサービス構成の一意な識別子です。
* **Microsoft アカウント (MSA) の App ID (MSAAppID)**: ゲームを Microsoft アカウント ID に関連付ける必須の識別子です。この値はパートナー センターで生成され、MicrosoftGame.config に配置されます。これにより、XBOX services (サインイン、実績、クラウド セーブ、ユーザー データを含む) がタイトルを正しく認証できるようになります。

Game Saves API には、次のような共通のサービス用語が現れます。

* **ローカル ストレージ**: ゲームプレイ中に保存され、デバイスに保存されるデータです。
* **タイトル ストレージ/クラウド:** デバイスがインターネットに接続されている場合、ストレージはクラウド上のタイトル ストレージと自動的に同期されます。
* **ロック:** 特定のユーザーが現在アクティブに使用しているデバイス上で、タイトルの Game Saves への排他アクセスを付与するメカニズムです。ロックは、ロックが保持されている間、他のデバイスがそのユーザーの Game Saves を変更できないようにします。
  * たとえば、ユーザーがデバイス A でタイトル T をプレイしている場合、そのユーザーのタイトル T に対するロックを持っています。
* **プロバイダー:** Game Save システムと通信する仲介メカニズムで、ゲーム データの管理を担当します。プロバイダーはデバイス上のユーザーのロックも管理します。
* **コンテナー**: フォルダーに相当します。
* **BLOB**: 個別のファイルに相当します。

## 新しいタイトル

Game Saves を使用する前に、タイトルはパートナー センターで XBOX services が有効になっている必要があります。このサービスは、タイトルに SCID と MSAAppID を提供します。詳細については、[タイトルの XBOX services と Game Saves の有効化](/ja-jp/build/core-features/common/game-save/game-saves-walkthroughs-and-samples.md#enabling-xbox-services-and-game-saves-for-your-title) を参照してください。

パートナー センターがセットアップされたら、Game Saves の実装には [XGameSaveFiles](/ja-jp/build/core-features/common/game-save/xgamesavefiles.md) の使用をお勧めします。

## Game Saves API

| API | 説明 | プラットフォーム | ユース ケース | サンプル |
| - | - | - | - | - |
| [XGameSaveFiles](/ja-jp/build/core-features/common/game-save/xgamesavefiles.md) | Game Saves のローカル ストレージ用のファイル パスを提供し、クラウドと自動的に同期します。 | PC、XBOX | ほとんどのシナリオでこの API をお勧めします。読み書きを行うためのファイル パスを提供し、クラウドと自動的に同期します。 | [GameSaveFilesCombo](https://learn.microsoft.com/samples/microsoft/xbox-gdk-samples/gamesavefilescombo/) |
| [ノーコード クラウド セーブ](/ja-jp/build/core-features/common/game-save/game-saves-walkthroughs-and-samples.md#porting-previous-titles-to-pc-game-saves-with-no-code-cloud-saves) | 自動的にクラウドと同期されるファイル パスを提供します。 | PC | GDK を直接使用できない PC ゲームや、PC Game Pass に移植する場合に最適です。ゲームの .config ファイルで読み書きパスを提供します。 | なし |
| [XGameSave](/ja-jp/build/core-features/common/game-save/xgamesave.md) | データはローカルに保存され、クラウドと同期されます。 | PC、XBOX | より大きなまたはより複雑なユーザーごとのストレージを必要とするタイトルをサポートします。ファイル管理の詳細な制御を提供します。 | [GameSaveCombo](https://learn.microsoft.com/samples/microsoft/xbox-gdk-samples/gamesavecombo/) |

## ユーザー モデル

ゲームでは 2 種類のユーザー モデルがサポートされています。Simple User Model の使用をお勧めします。

| メソッド | 説明 | サンプル リンク | リテール プラットフォームの違い |
| - | - | - | - |
| Simple User Model | 既定のユーザーが必要です。そのユーザーがゲーム インスタンスのライフタイムを制御します。OS はゲームの起動時にユーザーがサインインすることを保証します。 | [SimpleUserModel](https://learn.microsoft.com/samples/microsoft/xbox-gdk-samples/simpleusermodel/) | PC: 既定のユーザーがサインアウトするとゲームが終了します。  コンソール: 既定のユーザーがサインアウトするとゲームが中断します。 |
| 高度なユーザー モデル | 既定のユーザーはありません。ゲームの起動時にユーザーがサインインしている保証はありません。 | なし | なし |

ユーザー モデルの詳細については、[GDK ユーザー モデル](/ja-jp/build/core-features/common/user/gamecore-user-models.md) を参照してください。

ユーザーをサインインさせるためのベスト プラクティスについては、[方法: ユーザーをサインインさせるためのベスト プラクティス](/ja-jp/build/core-features/common/user/xuser_howto_best_practice_signing_in.md) を参照してください。

## セキュリティ

### 個人データ

Microsoft では、特定のユーザーの Game Saves データにアクセスするための API やツールを提供していません。問題のトラブルシューティングにこの情報が必要な場合は、ユーザーに直接連絡して、その情報を共有してもらってください。

### 安全に保存する

PC のアクセシビリティが有効な場合、Game Saves は安全ではありません。PC のアクセシビリティにより、ユーザーはファイル パスを直接開くことができ、保存されたデータが公開されます。ゲーム セーブの適切な状態を確認するために、独自のサーバー側のチェックを持つことをお勧めします。

## 認定要件

### XR-052

[XR-052 ユーザー状態およびタイトル セーブの場所、ローミング、および依存関係](https://learn.microsoft.com/build/store/policies/XR/XR052)


## Related topics

- [Game Saves の概要](/ja-jp/build/core-features/common/game-save/game-saves-overview.md)
- [Game Saves (目次)](/ja-jp/build/core-features/common/game-save/game-saves-toc.md)
- [PC 開発者向け FAQ](/ja-jp/build/gdk-and-engines/guides/pc-faq.md)
- [Game Save](/ja-jp/build/core-features/common/game-save/index.md)
- [PlayFab Game Saves の Steam Deck 実装ガイド](/ja-jp/services/playfab/player-progression/game-saves/steam-deck-implementation.md)