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 屬性是使用常見名稱或十六進位碼 (#RRGGBB) 格式的色彩值。
- SplashScreenImage 屬性是指向套件根目錄下 .PNG 檔案的有效檔案路徑。
備註
- StoreLogo、Square150x150Logo、Square44x44Logo、Square480x480Logo 和 SplashScreenImage 屬性都是封裝時的必要屬性。
- PC 遊戲不需要 SplashScreenImage 屬性，但建議將其作為最佳做法。
- 其他所有屬性都是選擇性的。
- 如需色彩值常見名稱的完整清單，請參閱 MicrosoftGame.config 結構描述中的 ST_Color 區段。
ShellVisuals 與 Executable 中的標誌
Executable 內的 OverrideLogo 元素與 ShellVisuals 中的 Logo 元素相關聯。如果已定義 OverrideLogo，則對該可執行檔而言，它會優先於 Logo 中所定義的內容。ShellVisuals 中的 Logo 是用於在套件層級定義。對於單一可執行檔的套件，只需要 Logo 元素。Square150x150Logo 屬性的 Logo 大小應為 150x150 像素。 OverrideLogo 屬性會針對該特定 Executable，覆寫 ShellVisuals 中 Square150x150Logo 所指定的 .png 檔案。除了 OverrideLogo 屬性之外，還有 OverrideSquare480x480Logo 和 Square44x44Logo 屬性，可分別指定這些屬性，以針對該特定 Executable 覆寫 ShellVisuals 中所指定的 Square480x480Logo 和 Square44x44Logo .png 檔案。 下列範例詳細說明專門用於 Logo/DisplayName 覆寫的元素和屬性設定。OverrideDisplayName 和 OverrideSplashScreenImage 的運作方式與 OverrideLogo 類似。
影像需求
在 PC 和主機上，非 DLC 套件都需要 Square150x150Logo、Square44x44Logo 和 StoreLogo。主機需要 SplashScreenImage，但自 2021 年 2 月 GDK 起，PC 上的 SplashScreenImage 已改為選擇性。對於 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 開發中則為選擇性屬性。