MicrosoftGame.config Element - ShellVisuals

[アーティクル]
05/10/2023

タイトルのシェルプレゼンスを定義します。たとえば、イメージや名前です。シェルでタイトルをサーフェイス指定するために登録時に使用されます。

親

この要素の親は Game 要素です。

要件

この要素はオプションであり、設定する必要はありません。

プラットフォーム

この要素は、PC と本体に関係します。

動作

属性は以下のとおりです。
- DefaultDisplayName
- PublisherDisplayName
- StoreLogo
- Square150x150Logo
- Square44x44Logo
- 説明
- ForegroundText
- BackgroundColor
- SplashScreenImage
ForegroundText 属性の既定値は 'light' です。 BackgroundColor 属性の既定値は 'transparent' です。その他の属性には既定値がありません。
有効な値は以下のとおりです。
- DefaultDisplayName 属性は、最大 256 文字の文字列です。
- PublisherDisplayName 属性は、最大 256 文字の文字列です。
- StoreLogo 属性は、パッケージのルート下にある .PNG ファイルに有効なファイルパスです。
- Square150x150Logo 属性は、パッケージのルート下にある .PNG ファイルに有効なファイルパスです。
- Square44x44Logo 属性は、パッケージのルート下にある .PNG ファイルに有効なファイルパスです。
- Square480x480Logo 属性は、パッケージのルート下にある .PNG ファイルに有効なファイルパスです。
- 説明は文字列です
- ForegroundText 属性は Light と Dark です。
- BackgroundText 属性は、一般的な名前または 16 進コード (#RRGGBB) 形式のカラー値です。
- SplashScreenImage 属性は、パッケージのルート下にある .PNG ファイルに有効なファイルパスです。

解説

StoreLogo 属性、Square150x150Logo 属性、Square44x44Logo 属性、Square480x480Logo 属性、SplashScreenImage 属性は、すべてパッケージ化に必須です。
PC タイトルでは SplashScreenImage 属性は必須ではありませんが、ベストプラクティスとしておすすめします。
その他のパラメーターはすべて省略可能です。
カラー値の一般的な名前の完全な一覧については、MicrosoftGame.config Schema の ST_Color セクションを参照してください。

ShellVisuals と Executable 内のロゴ

Executable 内の OverrideLogo 要素間の関係は、ShellVisuals 内の Logo 要素に関連付けられています。 OverrideLogo が定義されている場合、その実行可能ファイルについては、Logo で定義されている内容よりも優先されます。 ShellVisuals 内のロゴは、パッケージレイヤーで定義することを目的としています。単一の実行可能パッケージの場合は、Logo 要素のみが必要です。 Logo のサイズは、Square150x150Logo 属性に対しては 150 x 150 ピクセルにする必要があります。

OverrideLogo 属性は、その特定の Executable に対しては、ShellVisuals の Square150x150Logo で指定された .png ファイルをオーバーライドします。 OverrideLogo 属性だけでなく、その特定の Executable に対して ShellVisuals でそれぞれ指定された Square480x480Logo .png ファイルおよび Square44x44Logo .png ファイルをオーバーライドするために指定できる OverrideSquare480x480Logo および Square44x44Logo の属性もあります。

次の例では、Logo/DisplayName のオーバーライド用の要素と属性の構成について詳しく説明します。

<ShellVisuals DefaultDisplayName="MyGame"
                Square150x150Logo="GraphicsLogo.png"
                Square44x44Logo="SmallLogo.png"
                Square480x480Logo="LargeLogo.png"
                SplashScreenImage="SplashScreen.png"
                StoreLogo="StoreLogo.png"/>

<ExecutableList>
    <Executable Name="MyGame.exe"
                OverrideDisplayName="MyGameOverride"
                OverrideLogo="GraphicsLogoOverride.png"
                OverrideSquare44x44Logo="SmallLogoOverride.png"
                OverrideSquare480x480Logo="LargeLogoOverride.png"
                OverrideSplashScreenImage="SplashScreenOverride.png"/>
</ExecutableList>

関数 OverrideDisplayName および OverrideSplashScreenImage は OverrideLogo と同様です。

画像要件

Square150x150Logo、Square44x44Logo、および StoreLogo は、PC と本体の両方の非 DLC パッケージに必要です。 SplashScreenImage は本体に必要ですが、PC では 2021 年 2 月の時点で GDK がオプションになっています。 DLC パッケージの場合、必要なのは StoreLogo だけです。

画像の解像度と形式

必要なロゴの形式は .png です。.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 開発では省略可能です。

BackgroundColor

BackgroundColor は ShellVisuals 要素の属性です。この属性は、HTML の色コードを使用して、PC 上のタイトルの背景を定義します。これは、タスクバーと [スタート] メニューのロゴの周囲の境界線として表示されます。

次の方法で共有