MicrosoftGame.config 追加リファレンス
概要
この記事では、MicrosoftGame.config ファイルに関する追加の詳細情報およびリファレンス資料について説明します。以下のセクションが含まれています。| セクション | 説明 |
|---|---|
| 要素の詳細 | MicrosoftGame.config の要素名、目的、および注記の一覧を提供します。 |
| MicrosoftGame.config ファイルのサンプル | XBOX および PC 用の MicrosoftGame.config の例を提供します。 |
| MicrosoftGame.config の XSD スキーマ | MicrosoftGame.config を検証するために使用される XSD スキーマの詳細を提供します。 |
| 以前の要素リファレンス | 変更された注目すべき要素の一覧を提供します。ERA からの変更点への参照が含まれます。 |
| MicrosoftGame.config と DLC の作成 | DLC 製品用の MicrosoftGame.config を作成する際の詳細情報を提供します。 |
| 関連項目 | MicrosoftGame.config に関する追加ドキュメントへのリンクを提供します。 |
Game configVersion の詳細
2022 年 3 月の Microsoft Game Development Kit (GDK) 以降、Microsoft Game Development Kit (GDK) ツールを使用して生成される新しい MicrosoftGame.config ファイルの Game configVersion が 0 から 1 に更新されました。2023 年 10 月の GDK 以降、すべてのタイトルで configVersion=“1” を使用する必要があります。Submission Validator は、2023 年 10 月の GDK を使用して configVersion=“0” で送信されたタイトルに対して FAILURE を報告します。 Game configVersion 0 と 1 の変更点は次のとおりです。- MSAAppId 要素と TitleId 要素は、MicrosoftGame.config でいずれかが指定されている場合、両方とも必要です (例: TitleId が指定されている場合、MSAAppId も指定する必要があります)。
- NoCodePCRoot 要素が指定されている場合、または AdvancedUserModel 要素が false に設定されている場合、MSAAppId 要素と TitleId 要素は必須です。
- ModFolder、EnableWritesToPackageRoot、DisableFilesystemWriteVirtualization、および DisableRegistryWriteVirtualization 要素は、configVersion 1 では非推奨となりました。
<Game configVersion="1">
要素の詳細
このセクションでは、MicrosoftGame.config 内で定義できる要素について、要素名、必須かどうか、目的、親ノード、および追加の注記を詳しく説明します。| ノード名 | 必須 | 目的 | 親 | 注記 |
|---|---|---|---|---|
| Game | 必須 | 他のすべてのコンテンツを含む単一の親ノード | ||
| Identity | 必須 | タイトルの Name、Publisher、および Version を定義します | Game | タイトル情報はパートナー センターの [Product Management] -> [Product Identity] にあります。マネージド パートナー向けのパートナー センターでのゲームのセットアップ を参照してください。 登録時にタイトルを一意に識別するために使用されます。 Name および Publisher は必須フィールドです。 Version は指定されていない場合、既定で 1.0.0.0 になります。 後続のコンソール世代用の追加パッケージは、既存のパッケージのバージョンを超えるようパッケージのメジャー バージョンをインクリメントする必要があります。 |
| ShellVisuals | パッケージ ビルドで必須 | タイトルのシェル上での表示を定義します。たとえば、画像や名前など。 | Game | 登録時にシェル上にタイトルを表示するために使用されます。 |
| Resources | 省略可能 | Shell Visuals をローカライズするために使用される Language Locale ペアのリスト。 | Game | 形式が保持されるため、既存の AppxManifest からコピーして貼り付けることもできます。 詳細については、パッケージング を参照してください。 |
| Resource | 省略可能 | Resources リスト内の Language Locale の個々のエントリ。 | Resources | |
| ExecutableList | 必須 | タイトルの実行可能ファイルのリスト。 | Game | タイトルを正常に登録またはパッケージ化するには少なくとも 1 つのエントリが必要です。 “IsDevOnly” 属性を使用すると、このエントリが送信用に署名されたパッケージに含まれないようにすることができます。 Display Name と Logo のオーバーライドにより、シェル内のこの exe に対して一意の値を指定できます (別途オーバーライドされない限り、上記の “ShellVisuals” ノードで指定されたリソースが各 exe の既定になります)。 |
| Executable | 必須 | 特定の実行可能ファイルの詳細を指定します。 | ExecutableList | このセクションの属性には、実行可能ファイルの名前 (Name)、ビルドされるデバイス (TargetDeviceFamily)、アプリケーション ID (Id)、開発専用の実行可能ファイルかどうか (IsDevOnly)、ShellVisuals ノードの表示名をオーバーライドするかどうか (OverrideDisplayName)、ShellVisuals ノードの Logo をオーバーライドするかどうか (OverrideLogo)、ShellVisuals ノードの Square480x480Logo をオーバーライドするかどうか (OverrideSquare480x480Logo)、ShellVisuals ノードの Square44x44Logo をオーバーライドするかどうか (OverrideSquare44x44Logo)、ShellVisuals ノードの SplashScreenImage をオーバーライドするかどうか (OverrideSplashScreenImage)、および実行可能ファイルにエイリアスがあるかどうか (Alias、現在は Desktop のみ) が含まれます。 |
| AdvancedUserModel | 省略可能 | タイトルで Advanced User Model を使用するかどうかを指定します。 | Game | これは、再起動を必要とせずにアクティブ ユーザーを変更できるようタイトルがサポートすることを意味します。無効にすると、シンプル ユーザー モデルが使用され、タイトルは常に起動時のアクティブ ユーザーを維持することが保証されます。詳細については、GDK ユーザー モデル (NDA 記事) を参照してください。 |
| Protocol | 省略可能 | ゲームを起動するため、または既に実行中の場合はゲームを前面に表示するために使用できるカスタム プロトコル。 | ProtocolList | カスタム プロトコルの名前と、必要に応じて実行可能ファイルへのパスの両方を指定します。詳細については、プロトコル アクティブ化 を参照してください。 |
| ProtocolList | 省略可能 | ゲームを起動するため、または既に実行中の場合はゲームを前面に表示するために使用できるカスタム プロトコルのコレクションを指定します。 | Game | 少なくとも 1 つの Protocol を指定する必要があります。詳細については、プロトコル アクティブ化 を参照してください。 |
| GameOsVersion | 省略可能 (コンソールのみ) | このタイトルの実行に必要な Microsoft Game Development Kit (GDK) Game OS のバージョンを指定します。 | Game | 指定されていない場合、現在実行中または既定の Game OS が使用されます。 |
| WindowsOsVersion | 省略可能 (PC のみ) | このタイトルの実行に必要な Windows の最小および推奨バージョンを指定します。 | DesktopRegistration | 使用できる値は 4 パートのバージョン番号 (例: 10.0.19045.3570) で、オプションは RequiredMinimum=”#.#.#.#“、SuggestedMinimum=”#.#.#.#“、Recommended=”#.#.#.#” です。suggested minimum 要素の既定値は 10.0.19045.3570 です。 |
| MediaCapture | 省略可能 (コンソールのみ) | このタイトルの実行中のシステム メディア キャプチャ アプリの動作を指定します。 | Game | メディア キャプチャを正しく動作させるには、タイトル ID を構成する必要があります。 |
| GameDVRSystemComponent | 省略可能 (コンソールのみ) | Game DVR システム コンポーネントを有効にするかどうかを指定します。 | MediaCapture | |
| BlockBroadcast | 省略可能 (コンソールのみ) | タイトルのブロードキャストをブロックするか許可するかを指定します。 | MediaCapture | |
| BlockGameDVR | 省略可能 (コンソールのみ) | タイトルの Game DVR 録画をブロックするか許可するかを指定します。 | MediaCapture | |
| StoreId | 省略可能 | このタイトルのストア ID を指定します。 | Game | パートナー センターの [Product Management] -> [Product Identity] で指定します。 |
| AllowedProducts | 省略可能 | このダウンロード可能なコンテンツ パッケージ (DLC) タイトルが属する関連タイトルの StoreId を指定します。 | Game | 詳細については、ダウンロード可能なコンテンツ パッケージ (DLC) を参照してください。 |
| AllowedProduct | 省略可能 | このダウンロード可能なコンテンツ パッケージ (DLC) タイトルが属する関連タイトルの StoreId を指定します。 | AllowedProducts | |
| RelatedProducts | 省略可能 | この DLC タイトルに関連する製品の StoreId を指定します。 | Game | 詳細については、ダウンロード可能なコンテンツ パッケージ (DLC) を参照してください。 |
| RelatedProduct | 省略可能 | この DLC タイトルに関連する製品の StoreId の特定のエントリ。 | RelatedProducts | |
| TargetDeviceFamilyForDLC | 省略可能 (DLC のみ) | DLC パッケージがビルドされる対象プラットフォームを指定します。使用できる値は XboxOne、Scarlett、および PC です。 | Game | |
| PublisherContent | 省略可能 | このベース ゲームがパブリッシャーがホストするコンテンツ パッケージをサポートすることを宣言します。 | Game | 詳細については、Publisher Content パッケージ を参照してください。 |
| ManifestUrl | 省略可能 | 現在のパブリッシャーがホストするコンテンツ パッケージを識別する JSON マニフェストの URL。 | PublisherContent | |
| PublisherContentBaseProduct | 省略可能 (Publisher Content のみ) | このパブリッシャーがホストするコンテンツ パッケージが属するベース ゲームの StoreId を指定します。 | Game | パッケージを Publisher Content パッケージとしてマークします。 |
| PersistentLocalStorage | 省略可能 (コンソールのみ) | タイトルの Persistent Local Storage の希望サイズを指定します。 | Game | 永続ローカル ストレージを正しく動作させるには、タイトル ID を構成する必要があります。 |
| SizeMB | 省略可能 (コンソールのみ) | Persistent Local Storage の最小サイズを MB 単位で指定します。 | PersistentLocalStorage | 永続ローカル ストレージを正しく動作させるには、タイトル ID を構成する必要があります。 |
| GrowableToMB | 省略可能 (コンソールのみ) | Persistent Local Storage が時間の経過とともに拡大できる最大サイズを MB 単位で指定します。 | PersistentLocalStorage | 永続ローカル ストレージを正しく動作させるには、タイトル ID を構成する必要があります。 |
| VirtualMachine | 省略可能 (コンソールのみ) | 特定の XBOX One ハードウェアでのタイトル メモリ割り当てを指定します。 | Game | |
| XboxOneXTitleMemory | 省略可能 (コンソールのみ) | XBOX One X コンソールのタイトル メモリ設定を指定します。 | Virtual Machine | 使用できる値は “Standard” または “Advanced” です。 |
| XboxLockhartTitleMemory | 省略可能 (コンソールのみ) | XBOX Series S コンソールのタイトル メモリ設定を指定します。 | Virtual Machine | 使用できる値は “Standard” または “Advanced” です。 |
| XboxAnacondaTitleMemory | 省略可能 (コンソールのみ) | XBOX Series X コンソールのタイトル メモリ設定を指定します。 | Virtual Machine | 使用できる値は “Standard” または “Advanced” です。 |
| SMTEnabled | 省略可能 (コンソールのみ) | SMT を有効にするかどうかを指定します。 | Virtual Machine | |
| RequiresEraShim | 省略可能 (コンソールのみ) | XBOX One ERA Shim が必要かどうかを指定します。 | Virtual Machine | |
| XboxCompatibility | 省略可能 (コンソールのみ) | ゲームが互換性を持つ最大のコンソール世代を指定します。 | Virtual Machine | 開発者は、XBOX Series X|S 上で下位互換モードとして動作している XBOX One タイトルに対してこれを使用します。主な用途は、追加メモリなどの拡張機能へのアクセスを取得することです。使用できる値は、通常の下位互換タイトルと同じように動作する “XboxOne” と、下位互換タイトルが拡張機能にアクセスできるようにする “Scarlett” です。 |
| DlcCompatibility | 省略可能 (コンソールのみ) | ゲームが互換性を持つ DLC の最小コンソール世代を指定します。 | Virtual Machine | 開発者は、XBOX Series X|S コンソール上で動作している XBOX One タイトルで、XBOX One 用にビルドされた DLC パッケージを読み込みたい場合にこれを使用します。これにより、DLC は高速ストレージだけでなく、任意のストレージ上に存在できるようになります。 |
| MSAFullTrust | 省略可能 (PC デスクトップのみ) | タイトルを “MSA Full Trust” として宣言するかどうかを指定します。 | Game | アカウント マネージャーからの指示がない限り、これを使用しないでください。 |
| MSAAppId | 必須 | XBOX Live サービスの ID として、XBOX Live Title ID (下記参照) と共に使用されるタイトルの MSA アプリ ID を指定します。 | Game | 2022 年 3 月の Microsoft Game Development Kit (GDK) 以降、TitleId 要素が指定されている場合、MSAAppId 要素も存在する必要があります。 |
| TitleId | 省略可能 | XBOX Live サービスの ID として使用されるタイトルの XBOX Live Title ID を指定します。 | Game | 2022 年 3 月の Microsoft Game Development Kit (GDK) 以降、MSAAppId 要素が指定されている場合、TitleId 要素も存在する必要があります。 |
| RequiresXboxLive | 省略可能 | タイトルの実行に XBOX Live 接続が必要かどうかを指定します。 | Game | |
| ExtendedAttributeList | 省略可能 | 既存の要素以外の追加属性のフォールバック。 | Game | アカウント マネージャーからの指示がない限り、これを使用しないでください。 |
| ExtendedAttribute | 省略可能 | Extended Attribute List 内の特定のフォールバック指定。 | Game | アカウント マネージャーからの指示がない限り、これを使用しないでください。 |
| DesktopRegistration | 省略可能 (PC デスクトップのみ) | PC デスクトップ プラットフォームにタイトルを登録するときに使用する属性を指定します。 | Game | |
| ProcessorArchitecture | 省略可能 (PC デスクトップのみ) | ゲームの実行可能ファイルに一致するプロセッサ アーキテクチャを指定します。 | DesktopRegistration | この要素の属性の例は x64 と x86 です。 |
| MainPackageDependency | 省略可能 (PC デスクトップ DLC のみ) | DLC が属するベース パッケージの ID を指定します。 | DesktopRegistration | |
| DependencyList | 省略可能 (PC デスクトップのみ) | タイトル パッケージをインストールする前にインストールする必要があるフレームワーク パッケージを決定します。 | DesktopRegistration | 子要素の使用法の詳細については、Dependency を参照してください。 |
| KnownDependency | 省略可能 (PC デスクトップのみ) | 一般的に使用されるフレームワーク パッケージの 1 つを指定するためのショートカット。 | DependencyList | 属性 name の指定が必要で、MinVersion は自動的に設定されます。可能なショートカットの一覧については、以下のスキーマの ST_KnownDependency セクションを参照してください。 |
| Dependency | 省略可能 (PC デスクトップのみ) | タイトルの前にインストールする必要がある特定のフレームワーク パッケージとバージョン。 | DependencyList | 属性 name と MinVersion の指定が必要です。 |
| CustomInstallActions | 省略可能 (PC デスクトップのみ) | ゲームの初回実行時に管理者権限で実行されるカスタム インストーラー アクションを指定します。 | DesktopRegistration | 指定する実行可能ファイルは、ゲームのベース フォルダーの下の “Installers” フォルダー内にある必要があります。Installers フォルダーには他のファイルを含めないでください。 |
| Folder | 省略可能 (PC デスクトップのみ) | Installers のフォルダー位置を指定します。 | CustomInstallActions | |
| InstallActionList | 省略可能 (PC デスクトップのみ) | 実行可能ファイル、名前、および引数を含むインストール アクションのリストを指定します。 | CustomInstallActions | |
| InstallAction | 省略可能 (PC デスクトップのみ) | Install Action List 内のインストール アクションを指定します。 | InstallActionList | 最大 100 エントリまで指定できます。 |
| RepairActionList | 省略可能 (PC デスクトップのみ) | 修復アクションのリストを指定します。 | CustomInstallActions | |
| RepairAction | 省略可能 (PC デスクトップのみ) | Repair Action List 内の修復アクションを指定します。 | RepairActionList | 最大 100 エントリまで指定できます。 |
| UninstallActionList | 省略可能 (PC デスクトップのみ) | アンインストール アクションのリストを指定します。 | CustomInstallActions | |
| UninstallAction | 省略可能 (PC デスクトップのみ) | Uninstall Action List 内のアンインストール アクションを指定します。 | UninstallActionList | 最大 100 エントリまで指定できます。 |
| ModFolder | 省略可能 (PC デスクトップのみ) | ゲーム ファイル向けのエンド ユーザー MOD の場所を定義します。 | DesktopRegistration | この要素は 2022 年 3 月の Microsoft Game Development Kit (GDK) 以降、非推奨になりました。 |
| DisableRegistryWriteVirtualization | 省略可能 (PC デスクトップのみ) | ゲームがオペレーティング システム全体のレジストリ書き込みを行う必要がある場合は true に設定します。 | DesktopRegistration | この要素は 2022 年 3 月の Microsoft Game Development Kit (GDK) 以降、非推奨になりました。 |
| DisableFilesystemWriteVirtualization | 省略可能 (PC デスクトップのみ) | ゲームがオペレーティング システム全体のファイル書き込みを行う必要がある場合は true に設定します。 | DesktopRegistration | この要素は 2022 年 3 月の Microsoft Game Development Kit (GDK) 以降、非推奨になりました。 |
| EnableWritesToPackageRoot | 省略可能 (PC デスクトップのみ) | ゲームがパッケージのインストール場所に書き込む必要がある場合は true に設定します。 | DesktopRegistration | この要素は 2022 年 3 月の Microsoft Game Development Kit (GDK) 以降、非推奨になりました。 |
| MultiplayerProtocol | 省略可能 (PC デスクトップのみ) | “ms-xbl-multiplayer” プロトコルを介してタイトル内でのプロトコル アクティブ化を可能にします。 | DesktopRegistration | 主に、XBOX Game Bar によるゲーム/マルチプレイヤー ゲーム招待の起動を可能にするために使用されます。 |
| FileTypeAssociation | 省略可能 (PC デスクトップのみ) | パッケージ内の実行可能ファイルにファイル タイプを関連付けることができます。 | DesktopRegistration | 例としては、タイトルのマップ エディター用の特定の拡張子が挙げられます。詳細については、ファイル タイプ アクティブ化 を参照してください。 |
| DisplayName | 省略可能 (PC デスクトップのみ) | File Type Association の表示名を指定します。 | FileTypeAssociation | |
| Logo | 省略可能 (PC デスクトップのみ) | File Type Association のロゴを指定します。 | FileTypeAssociation | |
| InfoTip | 省略可能 (PC デスクトップのみ) | File Type Association の情報ツールチップを指定します。 | FileTypeAssociation | |
| EditFlags | 省略可能 (PC デスクトップのみ) | File Type Association の Edit Flags を指定します。 | FileTypeAssociation | |
| SupportedFileTypes | 省略可能 (PC デスクトップのみ) | File Type Association でサポートされるファイル タイプを指定します。 | FileTypeAssociation | 詳細については、ファイル タイプ アクティブ化 を参照してください。 |
| FileType | 省略可能 (PC デスクトップのみ) | SupportedFileTypes 要素の一部として使用されるファイル タイプ拡張子を指定します。 | SupportedFileTypes | 詳細については、ファイル タイプ アクティブ化 を参照してください。 |
| NoCodePCRoot | 省略可能 (PC デスクトップのみ) | パッケージに対して no code クラウド セーブが有効な場合に使用する、セーブ ゲームが保存されるローカル フォルダーを指定します。 | SaveGameStorage | |
| DevelopmentOnly | 省略可能 (コンソールのみ) | 開発専用プロパティのリスト。 | Game | |
| ContentIdOverride | 省略可能 (コンソールのみ) | 開発のみを対象とした、ゲームの ContentID のオーバーライド。 | DevelopmentOnly | パッケージがインストールされた状態で xbapp list /d /nosystem コマンドを使用すると、タイトルの ContentID を取得できます。 |
| EKBIDOverride | 省略可能 (コンソールのみ) | 開発のみを対象とした、ゲームの EKBID (トライアル バージョン ID) のオーバーライド。 | DevelopmentOnly | パッケージがインストールされた状態で xbapp list /d コマンドを使用すると、タイトルの EKBID を取得できます。 |
| DebugNetworkPortList | 省略可能 (コンソールのみ) | 開発キット上で開発用に開く追加ポートのリスト。 | DevelopmentOnly | |
| DebugNetworkPort | 省略可能 (コンソールのみ) | 開発キット上で開発用に開く追加ポート。 | DebugNetworkPortList |
エラー コード
MicrosoftGame.config ファイルを操作する際に、次のエラー コードが発生することがあります。完全なリストについては、エラー コード を参照してください。| コード | 値 | 説明 |
|---|---|---|
| E_GAME_MISSING_GAME_CONFIG | 0x87e5001F | このアプリには必要な MicrosoftGame.Config ファイルが欠落しています。 |
| E_GAMERUNTIME_OPTIONS_NOT_SUPPORTED | 0x8924010A | 渡されたオプションはゲームのパッケージと互換性がありません。ゲーム構成情報はパッケージと一致する必要があります。 |
| E_GAMERUNTIME_GAMECONFIG_BAD_FORMAT | 0x8924010B | Initialize に渡されたゲーム構成を解析できません。 |
| E_GAMEUSER_NO_TITLE_ID | 0x89245108 | XBOX Live TitleId を構成する必要があります。 |
| E_GAMEUSER_UNKNOWN_GAME_IDENTITY | 0x89245109 | ゲーム ID が認識されません。MSAAppId と TitleId がゲームに関連付けられているものと一致しません。 |
| E_GAMEUSER_INVALID_APP_CONFIGURATION | 0x89245112 | ゲーム構成の MSAAppId は無効であるか、認証スタック用に構成されていません。 |
| E_GAMEUSER_MALFORMED_MSAAPPID | 0x89245113 | ゲーム構成の MSAAppId は予期される形式 (16 文字の文字列または GUID) と一致しません。 |
| E_GAMEUSER_INCONSISTENT_MSAAPPID_AND_TITLEID | 0x89245114 | ゲーム構成の MSAAppId と TitleId がゲームに関連付けられているものと一致しません。 |
| E_GAMEPACKAGE_NO_STORE_ID | 0x89245202 | アプリケーションのゲーム構成で StoreId 属性を設定する必要があります。 |
| E_GAMEPACKAGE_DLC_NOT_SUPPORTED | 0x89245206 | ゲームは DLC パッケージをサポートしていません。ゲーム構成の DLC 互換性が正しいことを確認してください。 |
| E_GAMEPACKAGE_DUPLICATE_ID_VALUES | 0x89245207 | パッケージには、同じ ‘ID’ 属性にマップされる複数の実行可能ファイルが含まれています。‘Executable’ 要素で重複する ‘ID’ 属性がないか確認してください。 |
| E_GAMEPACKAGE_CONFIG_NO_ROOT_NODE | 0x89245209 | MicrosoftGame.config ファイル内でルート <Game> ノードが見つかりませんでした。ファイルの形式が正しいことを確認してください。 |
| E_GAMEPACKAGE_CONFIG_ZERO_VERSION | 0x8924520A | MicrosoftGame.config の ‘Identity’ ノード内の ‘Version’ 属性は 0.0.0.0 にできません。この属性をインクリメントするか削除してください。バージョンが指定されていない場合、既定値は 1.0.0.0 です。 |
| E_GAMEPACKAGE_CONFIG_NO_MSAAPPID_NOTITLEID | 0x8924520B | MicrosoftGame.config の ‘MSAAppId’ または ‘TitleId’ 要素が欠落しています。configVersion >= 1 を使用する場合、両方を指定する必要があります。 |
| E_GAMEPACKAGE_CONFIG_DEPRECATED_PC_ENTRIES | 0x8924520C | DesktopRegistration の “modFolder”、“enableWritesToPackageRoot”、“disableRegistryWriteVirtualization”、および “disableFilesystemWriteVirtualization” のエントリは configVersion >= 1 で非推奨になっています。 |
| E_GAMEPACKAGE_CONFIG_SUM_REQUIRES_MSAAPPID | 0x8924520D | 簡易ユーザー モデル (AdvancedUserModel 要素) を configVersion >= 1 と共に使用する場合、‘MSAAppId’ および ‘TitleId’ 要素が必要です。 |
| E_GAMEPACKAGE_CONFIG_NO_CODE_CLOUD_SAVES_REQUIRES_MSAAPPID | 0x8924520E | No Code Cloud Saves (NoCodePCRoot 要素) を configVersion >= 1 と共に使用する場合、‘MSAAppId’ および ‘TitleId’ 要素が必要です。 |
| E_GAMEPACKAGE_CONFIG_MSAAPPID_OR_TITLEID_IS_DEFAULT | 0x8924520F | ’MSAAppId’ または ‘TitleId’ 要素が既定値になっています。NoCodePCRoot または AdvancedUserModel が指定されている場合、configVersion >= 1 の使用時には TitleId と MSAAppId の両方がパートナー センターの有効な ID である必要があります。 |
MicrosoftGame.config ファイルのサンプル
次の MicrosoftGame.config は、XBOX Series X|S 用に要素がどのように使用されるかを示すサンプル構成です (XBOX One との相違点についてはコメントで説明しています)。PC 用の MicrosoftGame.config の例については、PC 向けパッケージングの概要 を参照してください。<?xml version="1.0" encoding="utf-8"?>
<Game configVersion="1">
<Identity Name="41336PublisherName.ExampleGame" Publisher="CN=A4954634-DF4B-47C7-AB70-D3215D246AF1" Version="1.6.0.0"/>
<GameOsVersion>**REPLACE**</GameOsVersion>
<MediaCapture>
<GameDVRSystemComponent>true</GameDVRSystemComponent>
<BlockBroadcast>0</BlockBroadcast>
<BlockGameDVR>0</BlockGameDVR>
</MediaCapture>
<PersistentLocalStorage>
<SizeMB>322</SizeMB>
</PersistentLocalStorage>
<MSAAppId>0000000000000000</MSAAppId>
<TitleId>FFFFFFFF</TitleId>
<StoreId>9NZTKMP36L8J</StoreId>
<RelatedProducts>
<RelatedProduct>9NZTKMP36L8J</RelatedProduct>
<RelatedProduct>9NQJV5BMKR6C</RelatedProduct>
<RelatedProduct>9PNX38847DWW</RelatedProduct>
</RelatedProducts>
<VirtualMachine>
<XboxLockhartTitleMemory>Standard</XboxLockhartTitleMemory>
<XboxAnacondaTitleMemory>Standard</XboxAnacondaTitleMemory>
<!-- <XboxOneXTitleMemory>Standard</XboxOneXTitleMemory> if MicrosoftGame.config is for Xbox One instead of Xbox Series X|S. -->
</VirtualMachine>
<MSAFullTrust>false</MSAFullTrust>
<ExecutableList>
<!-- TargetDeviceFamily="XboxOne" if the MicrosoftGame.config is for Xbox One instead of Xbox Series X|S. -->
<Executable Name="ExampleGame.exe"
TargetDeviceFamily="Scarlett"
Id="Game"
IsDevOnly="false"
OverrideDisplayName="Example Game"
OverrideLogo="OverriddenLogo.png" />
<Executable Name="ExampleGame_Debug.exe"
IsDevOnly="true"/>
<Executable Name="ExampleGame_Profile.exe"
IsDevOnly="true" />
</ExecutableList>
<ShellVisuals DefaultDisplayName="Example Game"
PublisherDisplayName="Example Publisher"
StoreLogo="StoreLogoFile.png"
Square150x150Logo="LogoFile150x150.png"
Square44x44Logo="LogoFile44x44.png"
Square480x480Logo="LogoFile480x480.png"
Description="Example Game"
ForegroundText="light"
BackgroundColor="#ffffff"
SplashScreenImage="SplashScreen.png"/>
<Resources>
<Resource Language="en-us"/>
<Resource Language="de-de"/>
<Resource Language="es-mx"/>
</Resources>
<DevelopmentOnly>
<DebugNetworkPortList>
<DebugNetworkPort>4600</DebugNetworkPort>
</DebugNetworkPortList>
</DevelopmentOnly>
</Game>
MicrosoftGame.config の XSD スキーマ
MicrosoftGame.config ファイルの最新スキーマは、Microsoft Game Development Kit (GDK) インストールの <install root>/bin フォルダーに GameConfigSchema.xsd として格納されています。 GameConfigSchema.xsd の次の例を参照してください:<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<!-- Types -->
<xs:simpleType name="ST_NonEmptyString">
<xs:restriction base="xs:string">
<xs:minLength value="1"/>
<xs:maxLength value="32767"/>
<xs:pattern value="[^\s]|([^\s].*[^\s])"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="ST_GUID">
<xs:restriction base="ST_NonEmptyString">
<xs:pattern value="[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="ST_VersionQuad">
<xs:restriction base="ST_NonEmptyString">
<xs:pattern value="(0|[1-9][0-9]{0,3}|[1-5][0-9]{4}|6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5])(\.(0|[1-9][0-9]{0,3}|[1-5][0-9]{4}|6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5])){3}"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="ST_Hex8">
<xs:restriction base="ST_NonEmptyString">
<xs:pattern value="[0-9a-fA-F]{8}"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="ST_Hex16">
<xs:restriction base="ST_NonEmptyString">
<xs:pattern value="[0-9a-fA-F]{16}"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="ST_PLSSize">
<xs:restriction base="xs:integer">
<!-- The actual max is determined by policy -->
<xs:maxInclusive value="100000"/>
<xs:minInclusive value="10"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="ST_GrowablePLSSize">
<xs:restriction base="xs:integer">
<xs:minInclusive value="10"/>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="CT_PersistentLocalStorage">
<xs:all>
<xs:element name="SizeMB" type="ST_PLSSize" minOccurs="0" maxOccurs="1"/>
<xs:element name="GrowableToMB" type="ST_GrowablePLSSize" minOccurs="0" maxOccurs="1"/>
</xs:all>
</xs:complexType>
<xs:simpleType name="ST_FileNameCharSet">
<xs:restriction base="ST_NonEmptyString">
<xs:pattern value="[^<>":%\|\?\*\x01-\x1f]+"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="ST_FileName">
<xs:restriction base="ST_FileNameCharSet">
<xs:pattern value="([^/\\]*[^./\\]+)(\\[^/\\]*[^./\\]+)*"/>
<xs:pattern value="([^/\\]*[^./\\]+)(/[^/\\]*[^./\\]+)*"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="ST_FileNameNoPath">
<xs:restriction base="ST_FileName">
<xs:pattern value="[^\\/]+"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="ST_AsciiWindowsId">
<xs:restriction base="ST_NonEmptyString">
<xs:pattern value="([A-Za-z][A-Za-z0-9]*)(\.[A-Za-z][A-Za-z0-9]*)*"/>
<xs:maxLength value="255"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="ST_DeviceFamily">
<xs:restriction base="xs:string">
<xs:enumeration value="XboxOne"/>
<xs:enumeration value="Scarlett"/>
<xs:enumeration value="PC"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="ST_ApplicationId">
<xs:restriction base="ST_AsciiWindowsId">
<xs:maxLength value="64"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="ST_StoreId">
<xs:restriction base="xs:string">
<xs:minLength value="12"/>
<xs:maxLength value="12"/>
<xs:pattern value="[0-9bcdfghjklmnpqrstvwxzBCDFGHJKLMNPQRSTVWXZ]{12}"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="ST_Executable">
<xs:restriction base="ST_FileName">
<xs:pattern value=".+\.([Ee][Xx][Ee])"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="ST_ExecutableNoPath">
<xs:restriction base="ST_FileName">
<xs:pattern value="[^\\]+\.([Ee][Xx][Ee])"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="ST_ImageFile">
<xs:restriction base="ST_FileName">
<xs:pattern value=".+\.(png)"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="ST_ResourceReference">
<xs:restriction base="ST_NonEmptyString">
<xs:pattern value="\bms-resource:.{1,256}"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="ST_DisplayName">
<xs:union memberTypes="ST_ResourceReference">
<xs:simpleType>
<xs:restriction base="ST_NonEmptyString">
<xs:maxLength value="256"/>
</xs:restriction>
</xs:simpleType>
</xs:union>
</xs:simpleType>
<xs:simpleType name="ST_Description">
<xs:restriction base="ST_NonEmptyString">
<xs:pattern value="[^\x01-\x1f]+"/>
<xs:maxLength value="2048"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="ST_ForegroundText">
<xs:restriction base="xs:string">
<xs:enumeration value="light"/>
<xs:enumeration value="dark"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="ST_Color">
<xs:restriction base="xs:string">
<xs:pattern value="#[\da-fA-F]{6}"/>
<xs:pattern value="aliceBlue|antiqueWhite|aqua|aquamarine|azure|beige|bisque|black|blanchedAlmond|blue|blueViolet|brown|burlyWood"/>
<xs:pattern value="cadetBlue|chartreuse|chocolate|coral|cornflowerBlue|cornsilk|crimson|cyan|darkBlue|darkCyan|darkGoldenrod|darkGray"/>
<xs:pattern value="darkGreen|darkKhaki|darkMagenta|darkOliveGreen|darkOrange|darkOrchid|darkRed|darkSalmon|darkSeaGreen|darkSlateBlue"/>
<xs:pattern value="darkSlateGray|darkTurquoise|darkViolet|deepPink|deepSkyBlue|dimGray|dodgerBlue|firebrick|floralWhite|forestGreen"/>
<xs:pattern value="fuchsia|gainsboro|ghostWhite|gold|goldenrod|gray|green|greenYellow|honeydew|hotPink|indianRed|indigo|ivory"/>
<xs:pattern value="khaki|lavender|lavenderBlush|lawnGreen|lemonChiffon|lightBlue|lightCoral|lightCyan|lightGoldenrodYellow|lightGreen"/>
<xs:pattern value="lightGray|lightPink|lightSalmon|lightSeaGreen|lightSkyBlue|lightSlateGray|lightSteelBlue|lightYellow|lime|limeGreen"/>
<xs:pattern value="linen|magenta|maroon|mediumAquamarine|mediumBlue|mediumOrchid|mediumPurple|mediumSeaGreen|mediumSlateBlue|mediumSpringGreen"/>
<xs:pattern value="mediumTurquoise|mediumVioletRed|midnightBlue|mintCream|mistyRose|moccasin|navajoWhite|navy|oldLace|olive|oliveDrab"/>
<xs:pattern value="orange|orangeRed|orchid|paleGoldenrod|paleGreen|paleTurquoise|paleVioletRed|papayaWhip|peachPuff|peru|pink|plum"/>
<xs:pattern value="powderBlue|purple|red|rosyBrown|royalBlue|saddleBrown|salmon|sandyBrown|seaGreen|seaShell|sienna|silver|skyBlue"/>
<xs:pattern value="slateBlue|slateGray|snow|springGreen|steelBlue|tan|teal|thistle|tomato|transparent|turquoise|violet|wheat|white"/>
<xs:pattern value="whiteSmoke|yellow|yellowGreen"/>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="CT_Resources">
<xs:sequence>
<xs:element name="Resource" maxOccurs="200" minOccurs="0" >
<xs:complexType>
<xs:attribute name="Language" type="xs:language" use="required"/>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
<xs:complexType name="CT_Identity">
<xs:attribute name="Name" type="ST_PackageName" use="required"/>
<xs:attribute name="Publisher" type="ST_Publisher" use="required"/>
<xs:attribute name="ResourceId" type="ST_ResourceId" use="optional"/>
<xs:attribute name="Version" type="ST_VersionQuad" use="optional"/>
</xs:complexType>
<xs:complexType name="CT_ShellVisuals">
<xs:attribute name="DefaultDisplayName" type="ST_DisplayName" use="optional"/>
<xs:attribute name="PublisherDisplayName" type="ST_DisplayName" use="optional"/>
<xs:attribute name="StoreLogo" type="ST_ImageFile" use="optional"/>
<xs:attribute name="Square150x150Logo" type="ST_ImageFile" use="optional"/>
<xs:attribute name="Square44x44Logo" type="ST_ImageFile" use="optional"/>
<xs:attribute name="Square480x480Logo" type="ST_ImageFile" use="optional"/>
<xs:attribute name="Description" type="ST_Description" use="optional"/>
<xs:attribute name="ForegroundText" type="ST_ForegroundText" use="optional"/>
<xs:attribute name="BackgroundColor" type="ST_Color" use="optional"/>
<xs:attribute name="SplashScreenImage" type="ST_ImageFile" use="optional"/>
</xs:complexType>
<xs:simpleType name="ST_MemoryConfig">
<xs:restriction base="xs:string">
<xs:enumeration value="Standard"/>
<xs:enumeration value="Advanced"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="ST_ConsoleGeneration">
<xs:restriction base="xs:string">
<xs:enumeration value="XboxOne"/>
<xs:enumeration value="Scarlett"/>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="CT_VirtualMachine">
<xs:all>
<xs:element name="XboxOneXTitleMemory" type="ST_MemoryConfig" minOccurs="0"/>
<xs:element name="XboxAnacondaTitleMemory" type="ST_MemoryConfig" minOccurs="0"/>
<xs:element name="SMTEnabled" type="xs:boolean" minOccurs="0"/>
<xs:element name="RequiresEraShim" type="xs:boolean" minOccurs="0"/>
<xs:element name="XboxCompatibility" type="ST_ConsoleGeneration" minOccurs="0"/>
<xs:element name="DlcCompatibility" type="ST_ConsoleGeneration" minOccurs="0"/>
<xs:element name="XboxLockhartTitleMemory" type="ST_MemoryConfig" minOccurs="0"/>
</xs:all>
</xs:complexType>
<xs:complexType name="CT_DesktopRegistration">
<xs:sequence minOccurs="0" maxOccurs="unbounded">
<xs:element name="ProcessorArchitecture" type="ST_ProcessorArchitecture" minOccurs="0"/>
<xs:element name="MainPackageDependency " minOccurs="0">
<xs:complexType>
<xs:attribute name="Name" type="ST_PackageName"/>
</xs:complexType>
</xs:element>
<xs:element name="DependencyList" type="CT_DependencyList" minOccurs="0"/>
<xs:element name="CustomInstallActions" type="CT_CustomInstallActions" minOccurs="0"/>
<xs:element name="ModFolder" minOccurs="0">
<xs:complexType>
<xs:attribute name="Name" type="ST_FileNameNoPath" use="optional"/>
</xs:complexType>
</xs:element>
<xs:element name="DisableRegistryWriteVirtualization" type="xs:boolean" minOccurs="0"/>
<xs:element name="DisableFilesystemWriteVirtualization" type="xs:boolean" minOccurs="0"/>
<xs:element name="EnableWritesToPackageRoot" type="xs:boolean" minOccurs="0"/>
<xs:element name="MultiplayerProtocol" minOccurs="0">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:boolean">
<xs:attribute name="Executable" type="ST_Executable" use="optional"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element name="FileTypeAssociation" type="CT_FileTypeAssociation" minOccurs="0" maxOccurs="100"/>
</xs:sequence>
</xs:complexType>
<xs:simpleType name="ST_KnownDependency">
<xs:restriction base="xs:string">
<xs:enumeration value="DX11"/>
<xs:enumeration value="VC11"/>
<xs:enumeration value="VC12"/>
<xs:enumeration value="VC14"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="ST_ProcessorArchitecture">
<xs:restriction base="xs:string">
<xs:enumeration value="x64"/>
<xs:enumeration value="x86"/>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="CT_DependencyList">
<xs:sequence maxOccurs="128" minOccurs="0">
<xs:element name="KnownDependency" minOccurs="0">
<xs:complexType>
<xs:attribute name="Name" type="ST_KnownDependency" use="required"/>
</xs:complexType>
</xs:element>
<xs:element name="Dependency" minOccurs="0">
<xs:complexType>
<xs:attribute name="Name" type="ST_PackageName" use="required"/>
<xs:attribute name="MinVersion" type="ST_VersionQuad" use="required"/>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
<xs:complexType name="CT_CustomInstallAction">
<xs:attribute name="File" type="ST_FileName" use="required"/>
<xs:attribute name="Name" type="ST_NonEmptyString" use="required"/>
<xs:attribute name="Arguments" type="ST_NonEmptyString" />
</xs:complexType>
<xs:complexType name="CT_InstallActionList">
<xs:sequence maxOccurs="100" minOccurs="0">
<xs:element name="InstallAction" type="CT_CustomInstallAction" />
</xs:sequence>
</xs:complexType>
<xs:complexType name="CT_RepairActionList">
<xs:sequence maxOccurs="100" minOccurs="0">
<xs:element name="RepairAction" type="CT_CustomInstallAction" />
</xs:sequence>
</xs:complexType>
<xs:complexType name="CT_UninstallActionList">
<xs:sequence maxOccurs="100" minOccurs="0">
<xs:element name="UninstallAction" type="CT_CustomInstallAction" />
</xs:sequence>
</xs:complexType>
<xs:complexType name="CT_CustomInstallActions">
<xs:all>
<xs:element name="Folder" type="ST_FileName" minOccurs="1"/>
<xs:element name="InstallActionList" type="CT_InstallActionList" minOccurs="0"/>
<xs:element name="RepairActionList" type="CT_RepairActionList" minOccurs="0"/>
<xs:element name="UninstallActionList" type="CT_UninstallActionList" minOccurs="0"/>
</xs:all>
</xs:complexType>
<xs:complexType name="CT_ExecutableList">
<xs:sequence maxOccurs="unbounded" minOccurs="0">
<xs:element name="Executable">
<xs:complexType>
<xs:attribute name="Name" type="ST_Executable" use="required"/>
<xs:attribute name="TargetDeviceFamily" type="ST_DeviceFamily" use="optional"/>
<xs:attribute name="Id" type="ST_ApplicationId" use="optional"/>
<xs:attribute name="IsDevOnly" type="xs:boolean" use="optional"/>
<xs:attribute name="OverrideDisplayName" type="ST_DisplayName" use="optional"/>
<xs:attribute name="OverrideLogo" type="ST_ImageFile" use="optional"/>
<xs:attribute name="OverrideSquare480x480Logo" type="ST_ImageFile" use="optional"/>
<xs:attribute name="OverrideSquare44x44Logo" type="ST_ImageFile" use="optional"/>
<xs:attribute name="OverrideSplashScreenImage" type="ST_ImageFile" use="optional"/>
<xs:attribute name="Alias" type="ST_ExecutableNoPath" use="optional"/>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
<xs:complexType name="CT_AllowedProductsList">
<xs:sequence maxOccurs="unbounded" minOccurs="0">
<xs:element name="AllowedProduct" type="ST_StoreId"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="CT_PublisherContent">
<xs:all>
<xs:element name="ManifestUrl" type="xs:anyURI" minOccurs="1"/>
</xs:all>
</xs:complexType>
<xs:complexType name="CT_ExtendedAttributeList">
<xs:sequence maxOccurs="unbounded" minOccurs="0">
<xs:element name="ExtendedAttribute">
<xs:complexType>
<xs:attribute name="Name" type="ST_NonEmptyString" use="optional"/>
<xs:attribute name="Value" type="ST_NonEmptyString" use="optional"/>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
<xs:complexType name="CT_RelatedProductsList">
<xs:sequence maxOccurs="unbounded" minOccurs="0">
<xs:element name="RelatedProduct" type="ST_StoreId"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="CT_MediaCapture">
<xs:all>
<xs:element name="GameDVRSystemComponent" type="xs:boolean" minOccurs="0"/>
<xs:element name="BlockBroadcast" type="xs:boolean" minOccurs="0"/>
<xs:element name="BlockGameDVR" type="xs:boolean" minOccurs="0"/>
</xs:all>
</xs:complexType>
<xs:simpleType name="ST_AllowedAsciiCharSet">
<xs:restriction base="ST_NonEmptyString">
<xs:pattern value="[-_. A-Za-z0-9]+"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="ST_AsciiIdentifier">
<xs:restriction base="ST_AllowedAsciiCharSet">
<xs:pattern value="[^_ ]+"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="ST_PackageName">
<xs:restriction base="ST_AsciiIdentifier">
<xs:minLength value="3"/>
<xs:maxLength value="50"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="ST_DistinguishedName">
<xs:restriction base="ST_NonEmptyString">
<xs:pattern value="(CN|L|O|OU|E|C|S|STREET|T|G|I|SN|DC|SERIALNUMBER|(OID\.(0|[1-9][0-9]*)(\.(0|[1-9][0-9]*))+))=(([^,+="<>#;])+|".*")(, ((CN|L|O|OU|E|C|S|STREET|T|G|I|SN|DC|SERIALNUMBER|(OID\.(0|[1-9][0-9]*)(\.(0|[1-9][0-9]*))+))=(([^,+="<>#;])+|".*")))*"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="ST_Publisher">
<xs:restriction base="ST_DistinguishedName">
<xs:maxLength value="8192"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="ST_ResourceId">
<xs:restriction base="ST_AsciiIdentifier">
<xs:maxLength value="30"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="ST_Port">
<xs:restriction base="ST_NonEmptyString">
<xs:pattern value="[1-9][0-9]{0,4}"/>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="CT_DebugNetworkPortList">
<xs:sequence maxOccurs="unbounded" minOccurs="0">
<xs:element name="DebugNetworkPort" type="ST_Port"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="CT_DevelopmentOnly">
<xs:all>
<xs:element name="ContentIdOverride" type="ST_GUID" minOccurs="0"/>
<xs:element name="EKBIDOverride" type="ST_GUID" minOccurs="0"/>
<xs:element name="DebugNetworkPortList" type="CT_DebugNetworkPortList" minOccurs="0"/>
</xs:all>
</xs:complexType>
<xs:simpleType name="ST_FTAInfoTip">
<xs:restriction base="ST_NonEmptyString">
<xs:maxLength value="1024"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="ST_ContentTypeCharSet">
<xs:restriction base="ST_NonEmptyString">
<xs:pattern value="[!#$%&'*+-.^_`|~0-9a-z/]*"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="ST_ContentType">
<xs:restriction base="ST_ContentTypeCharSet">
<xs:pattern value="[^/]{1,127}/[^/]{1,127}"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="ST_FileType">
<xs:restriction base="ST_FileNameCharSet">
<xs:pattern value="\.[^.\\]+"/>
<xs:maxLength value="64"/>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="CT_FTASupportedFileTypes">
<xs:sequence>
<xs:element name="FileType" maxOccurs="1000" >
<xs:complexType>
<xs:simpleContent>
<xs:extension base="ST_FileType">
<xs:attribute name="ContentType" type="ST_ContentType" use="optional"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
<xs:simpleType name="ST_FTAName">
<xs:restriction base="ST_AllowedAsciiCharSet">
<xs:pattern value="[^ A-Z]+"/>
<xs:maxLength value="100"/>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="CT_FileTypeAssociation">
<xs:all>
<xs:element name="DisplayName" type="ST_DisplayName" minOccurs="0"/>
<xs:element name="Logo" type="ST_ImageFile" minOccurs="0"/>
<xs:element name="InfoTip" type="ST_FTAInfoTip" minOccurs="0"/>
<xs:element name="EditFlags" minOccurs="0">
<xs:complexType>
<xs:attribute name="OpenIsSafe" type="xs:boolean" use="optional"/>
<xs:attribute name="AlwaysUnsafe" type="xs:boolean" use="optional"/>
</xs:complexType>
</xs:element>
<xs:element name="SupportedFileTypes" type="CT_FTASupportedFileTypes"/>
</xs:all>
<xs:attribute name="Name" type="ST_FTAName" use="required"/>
<xs:attribute name="Executable" type="ST_Executable" use="optional"/>
</xs:complexType>
<xs:simpleType name="ST_GameSaveNoCodePcRootRelativeLocation">
<xs:restriction base="xs:string">
<xs:enumeration value="AppData"/>
<xs:enumeration value="Public"/>
<xs:enumeration value="LocalAppData"/>
<xs:enumeration value="LocalAppDataLow"/>
<xs:enumeration value="ProgramData"/>
<xs:enumeration value="SavedGames"/>
<xs:enumeration value="UserProfile"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="ST_GameSaveUserQuotaSize">
<xs:restriction base="xs:integer">
<xs:maxInclusive value="4096"/>
<xs:minInclusive value="256"/>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="CT_SaveGameStorage">
<xs:all>
<xs:element name="NoCodePCRoot" minOccurs="0">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="ST_FileName">
<xs:attribute name="RelativeTo" type="ST_GameSaveNoCodePcRootRelativeLocation" use="required"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element name="SCID" type="ST_GUID" minOccurs="0"/>
<xs:element name="MaxUserQuota" type="ST_GameSaveUserQuotaSize" minOccurs="0"/>
</xs:all>
</xs:complexType>
<!-- Root -->
<xs:element name="Game">
<xs:complexType>
<xs:all>
<xs:element name="Identity" type="CT_Identity" />
<xs:element name="ShellVisuals" type="CT_ShellVisuals" minOccurs="0"/>
<xs:element name="Resources" type="CT_Resources" minOccurs="0"/>
<xs:element name="ExecutableList" type="CT_ExecutableList" minOccurs="0"/>
<xs:element name="GameOsVersion" type="ST_VersionQuad" minOccurs="0"/>
<xs:element name="MediaCapture" type="CT_MediaCapture" minOccurs="0"/>
<xs:element name="StoreId" type="ST_StoreId" minOccurs="0" />
<xs:element name="TargetDeviceFamilyForDLC" type="ST_DeviceFamily" minOccurs="0"/>
<xs:element name="AllowedProducts" type="CT_AllowedProductsList" minOccurs="0"/>
<xs:element name="RelatedProducts" type="CT_RelatedProductsList" minOccurs="0"/>
<xs:element name="PersistentLocalStorage" type="CT_PersistentLocalStorage" minOccurs="0"/>
<xs:element name="VirtualMachine" type="CT_VirtualMachine" minOccurs="0"/>
<xs:element name="MSAFullTrust" type="xs:boolean" minOccurs="0"/>
<xs:element name="MSAAppId" type="ST_NonEmptyString" minOccurs="0"/>
<xs:element name="TitleId" type="ST_Hex8" minOccurs="0"/>
<xs:element name="RequiresXboxLive" type="xs:boolean" minOccurs="0"/>
<xs:element name="ExtendedAttributeList" type="CT_ExtendedAttributeList" minOccurs="0"/>
<xs:element name="DesktopRegistration" type="CT_DesktopRegistration" minOccurs="0"/>
<xs:element name="DevelopmentOnly" type="CT_DevelopmentOnly" minOccurs="0"/>
<xs:element name="AdvancedUserModel" type="xs:boolean" default="true" minOccurs="0" maxOccurs="1" />
<xs:element name="SaveGameStorage" type="CT_SaveGameStorage" minOccurs="0"/>
<xs:element name="PublisherContentBaseProduct" type="ST_StoreId" minOccurs="0" maxOccurs="1"/>
<xs:element name="PublisherContent" type="CT_PublisherContent" minOccurs="0" maxOccurs="1"/>
</xs:all>
<xs:attribute name="configVersion" use="required">
<xs:simpleType>
<xs:restriction base="xs:integer">
<xs:maxInclusive value="1"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
<xs:unique name="Resource_Language">
<xs:selector xpath="Resources/Resource"/>
<xs:field xpath="@Language"/>
</xs:unique>
</xs:element>
</xs:schema>
以前の要素リファレンス
- PrimaryServiceConfig は、XBOX One ERA の AppxManifest.xml で SCID 呼び出しを定義するために使用されていた要素です。現在はコード内で定義され、DevCenter で構成されます。
- VisualElements は、XBOX One ERA の AppxManifest.xml で Store ロゴやタイトルの他の視覚的要素を定義するために使用されていた要素です。現在は ShellVisuals で定義されます。
- GpuAvailability は、XBOX One ERA の AppxManifest.xml で GPU 可用性を定義するために使用されていた要素です。現在、すべての Microsoft Game Development Kit (GDK) タイトルは自動的に可変設定 (可能な限り多くの GPU) を取得するため、これは自動的に行われます。
- ConnectedStorageQuota は、XBOX One ERA の AppxManifest.xml で connected storage サイズを定義するために使用されていた要素です。現在はサーバー側の設定によって決定されます。
- LicenseOverrides は、XBOX One ERA の debug_licensing_overrides.xml で ContentID、ProductID、および EKBID のオーバーライドを定義するために使用されていた要素です。現在は、MicrosoftGame.config で ContentIDOverride、StoreId、および EKBIDOverride 要素を使って直接管理されます。
- NetworkManifest 要素は、以前のバージョンの MicrosoftGame.config で定義されていました。現在は、DebugNetworkPortList 要素を除き、既存のネットワーキング API を通じて行われます。
- XboxOneTitleMemoryMaxMB および XboxOneXTitleMemoryMaxMB は、以前のバージョンの MicrosoftGame.config で使用されていた要素です。XboxOneTitleMemoryMaxMB は構成できなくなり、XBOX One X および XBOX Series S|X の Title Memory 構成用の要素は現在、XboxOneXTitleMemory、XboxLockhartTitleMemory、および XboxAnacondaTitleMemory になっています。
- packageWriteRedirectionCompatibilityShim は、2020 年 5 月の GDK より前にこの機能を有効にするために ExtendedAttribute 値として使用されていました。2020 年 5 月の GDK 以降は、独立した要素 EnableWritesToPackageRoot として追跡されるようになりました。
制限された機能の構成
Microsoft Game Development Kit (GDK) では、制限された機能は MicrosoftGame.config 要素を通じて構成されます。一般的に使用される機能のマッピングは次のとおりです。- runFullTrust 機能は既定で有効になるように構成されています。
- customInstallActions 機能は CustomInstallActions 要素によって構成されます。
DLC パッケージ作成の一部としての MicrosoftGame.config
DLC パッケージ用の MicrosoftGame.config を生成する方法の詳細については、ダウンロード可能なコンテンツ (DLC) パッケージ を参照してください。 この記事の先頭に戻る。関連項目
MicrosoftGame.config 要素リファレンスMicrosoftGame.Config
MicrosoftGame.Config の概要
MicrosoftGame.Config のローカライズ
パッケージングの概要
PC ブートストラッパー