MicrosoftGame.config 元素 - ShellVisuals

项目
05/09/2023

定义游戏的 Shell 外观。例如，图像和名称。用于在注册过程中在 Shell 中显示游戏。

父级

此元素的父元素是“游戏”元素。

要求

此元素是可选的，不需要设置。

平台

此元素涉及到电脑和主机。

行为

特性为：
- 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 属性为使用公用名或十六进制代码 (#RRGGBB) 格式的颜色值。
- SplashScreenImage 属性是程序包根目录下一个 .PNG 文件的有效文件路径。

备注

StoreLogo、Square150x150Logo、Square44x44Logo、Square480x480Logo 和 SplashScreenImage 属性都是打包所必需的。
电脑游戏不需要 SplashScreenImage 属性，但建议将其作为最佳做法。
所有其他参数都是可选的。
有关颜色值公用名的完整列表，请参阅 MicrosoftGame.config 架构中的 ST_Color 部分。

ShellVisuals 和 Executable 内的徽标

Executable 内的 OverrideLogo 元素之间的关系与 ShellVisuals 中的徽标元素关联。如果定义了 OverrideLogo，它将成为该可执行文件优先考虑的元素，优先于 Logo 中定义的内容。 ShellVisuals 内的徽标将在包一层定义。对于单个可执行文件包，仅需要 Logo 元素。 Logo 大小对于 Square150x150Logo 属性应为 150x150 像素。

OverrideLogo 属性将替代该特定 Executable 的 ShellVisuals 中的 Square150x150Logo 指定的 .png 文件。除了 OverrideLogo 属性外，还有一个 OverrideSquare480x480Logo 和 Square44x44Logo 的属性，可以指定它来分别替代该特定 Executable 的 ShellVisuals 中的指定 Square480x480Logo 和Square44x44Logo.png 文件。

发布下面的示例详细说明了专门用于 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 对于电脑和主机上的非 DLC 程序包都是必需的。 SplashScreenImage 目前对主机是必需的，但从 2021 年 2 月开始，GDK 对于电脑可选。对于 DLC 程序包，只有 StoreLogo 是必需的。

图像分辨率和格式

所需的徽标格式为 .png，它达到了像素格式（24-bpp RGB 或 32-bpp ARGB/PARGB）要求。这些通过 SubmissionValidator 强制实施。

每幅图像都有一个所需的图像分辨率。它们如下所示：

Square150x150Logo: 150x150
Square44x44Logo: 44x44
Square480x480Logo: 480x480
StoreLogo: 100x100
SplashScreenImage: 1920x1080

SplashScreenImage

SplashScreenImage 是在启动游戏时所使用的图像。

可执行元素中的 OverrideSplashScreenImage 属性用于覆盖游戏启动时出现的初始屏幕图像。现在，允许在开发期间覆盖可执行的特定启动屏幕图像。

注意

当 SplashScreenImage 属性不是特定于平台的情况下，该属性目前对于 Xbox 主机开发是必需的，但对于电脑开发则是可选的。

BackgroundColor

BackgroundColor 是 ShellVisuals 元素的一个属性。它使用 HTML 颜色代码为电脑上的游戏定义背景。它将以边框形式显示在“任务栏”和“开始”菜单中的徽标周围。

另请参阅

MicrosoftGame.config 参考 - 目录

通过