MicrosoftGame.config 要素 - ShellVisuals
タイトルのシェル上での表示を定義します。たとえば、画像や名前などです。登録時に使用され、シェル上にタイトルを表示します。親
この要素の親は Game 要素です。要件
この要素は省略可能であり、設定する必要はありません。プラットフォーム
この要素は PC およびコンソールに適用されます。動作
- 属性は次のとおりです:
- DefaultDisplayName
- PublisherDisplayName
- StoreLogo
- Square150x150Logo
- Square44x44Logo
- Square480x480Logo
- Description
- ForegroundText
- BackgroundColor
- SplashScreenImage
- ForegroundText 属性の既定値は ‘light’ です。BackgroundColor 属性の既定値は ‘transparent’ です。それ以外のすべての属性に既定値はありません。
- 使用できる値:
- DefaultDisplayName 属性は最大 256 文字の文字列です。
- PublisherDisplayName 属性は最大 256 文字の文字列です。
- StoreLogo 属性はパッケージのルート配下にある .PNG ファイルへの有効なファイルパスです。
- Square150x150Logo 属性はパッケージのルート配下にある .PNG ファイルへの有効なファイルパスです。
- Square44x44Logo 属性はパッケージのルート配下にある .PNG ファイルへの有効なファイルパスです。
- Square480x480Logo はパッケージのルート配下にある .PNG ファイルへの有効なファイルパスです。
- Description は文字列です。
- ForegroundText 属性は light および dark です。
- BackgroundColor 属性は、一般的な名称または 16 進コード (#RRGGBB) 形式のカラー値です。
- SplashScreenImage 属性はパッケージのルート配下にある .PNG ファイルへの有効なファイルパスです。
補足
- StoreLogo、Square150x150Logo、Square44x44Logo、Square480x480Logo、および SplashScreenImage 属性はパッケージングにすべて必要です。
- SplashScreenImage 属性は PC タイトルには必須ではありませんが、ベスト プラクティスとして推奨されます。
- それ以外のすべての属性は省略可能です。
- カラー値の一般的な名称の完全なリストについては、MicrosoftGame.config スキーマの ST_Color セクションを参照してください。
ShellVisuals および Executable 内のロゴ
Executable 内の OverrideLogo 要素は、ShellVisuals の Logo 要素と関連付けられています。OverrideLogo が定義されている場合、その実行可能ファイルに対しては Logo で定義されているものよりも優先されます。ShellVisuals 内の Logo は、パッケージ層で定義することを意図しています。単一の実行可能ファイルのパッケージの場合、Logo 要素のみが必要です。Logo のサイズは、Square150x150Logo 属性については 150x150 ピクセルにする必要があります。 OverrideLogo 属性は、特定の Executable について ShellVisuals で指定された Square150x150Logo の .png ファイルをオーバーライドします。OverrideLogo 属性に加えて、OverrideSquare480x480Logo および Square44x44Logo の属性もあり、これらは特定の Executable に対して ShellVisuals で指定された Square480x480Logo および Square44x44Logo の .png ファイルをそれぞれオーバーライドするように指定できます。 次の例では、Logo/DisplayName のオーバーライドに関する要素と属性の構成について詳しく説明します。OverrideDisplayName と OverrideSplashScreenImage は、OverrideLogo と同様に機能します。
画像の要件
Square150x150Logo、Square44x44Logo、および StoreLogo は、PC およびコンソールの両方で DLC 以外のパッケージに必須です。SplashScreenImage はコンソールでは必須ですが、2021 年 2 月の GDK 以降では PC では省略可能となっています。DLC パッケージでは StoreLogo のみ必須です。画像の解像度と形式
必要なロゴの形式は .png であり、ピクセル形式に関する要件があります (24-bpp RGB または 32-bpp ARGB/PARGB)。これらは SubmissionValidator によって適用されます。 各画像には必要な画像解像度があります。次のとおりです:- Square150x150Logo: 150x150
- Square44x44Logo: 44x44
- Square480x480Logo: 480x480
- StoreLogo: 100x100
- SplashScreenImage: 1920x1080
SplashScreenImage
SplashScreenImage は、タイトルの起動時に使用される画像です。 Executable 要素の OverrideSplashScreenImage 属性は、タイトルを起動する際に表示されるスプラッシュ スクリーン画像をオーバーライドするために使用されます。このオーバーライドにより、開発中に実行可能ファイル固有のスプラッシュ スクリーン画像を使用できるようになりました。SplashScreenImage 属性はプラットフォーム固有ではありませんが、現在 XBOX コンソール開発では必須であり、PC 開発では省略可能です。