メインコンテンツへスキップ
このガイドは、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 の有効化 を参照してください。 パートナー センターがセットアップされたら、Game Saves の実装には XGameSaveFiles の使用をお勧めします。

Game Saves API

ユーザー モデル

ゲームでは 2 種類のユーザー モデルがサポートされています。Simple User Model の使用をお勧めします。 ユーザー モデルの詳細については、GDK ユーザー モデル を参照してください。 ユーザーをサインインさせるためのベスト プラクティスについては、方法: ユーザーをサインインさせるためのベスト プラクティス を参照してください。

セキュリティ

個人データ

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

安全に保存する

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

認定要件

XR-052

XR-052 ユーザー状態およびタイトル セーブの場所、ローミング、および依存関係
最終更新日 2026年10月20日