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

# MicrosoftGame.config 要素 - ShellVisuals

> MicrosoftGame.config 要素 - ShellVisuals

# 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 のオーバーライドに関する要素と属性の構成について詳しく説明します。

```xml theme={null}
<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 はコンソールでは必須ですが、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 属性は、タイトルを起動する際に表示されるスプラッシュ スクリーン画像をオーバーライドするために使用されます。このオーバーライドにより、開発中に実行可能ファイル固有のスプラッシュ スクリーン画像を使用できるようになりました。

<Note>SplashScreenImage 属性はプラットフォーム固有ではありませんが、現在 XBOX コンソール開発では必須であり、PC 開発では省略可能です。</Note>

#### BackgroundColor

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

## 関連項目

[MicrosoftGame.config リファレンス - 目次](/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc)


## Related topics

- [MicrosoftGame.config 要素 - Executable](/ja-jp/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-executable.md)
- [MicrosoftGame.config 要素 - ExecutableList](/ja-jp/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-executablelist.md)
- [MicrosoftGame.config 要素 - Resources](/ja-jp/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-resources.md)
- [MicrosoftGame.config 要素 - KnownDependency](/ja-jp/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-knowndependency.md)
- [MicrosoftGame.config 要素 - TitleId](/ja-jp/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-titleid.md)