MicrosoftGame.config 요소 - ShellVisuals

타이틀의 셸 상태 정의를 정의합니다. 이미지와 이름을 예로 들 수 있습니다. 등록 중에 셸에서 타이틀을 표면화하는 데 사용됩니다.

부모

이 요소의 부모는 Game 요소입니다.

요건

이 요소는 선택 사항이며 설정할 필요가 없습니다.

플랫폼

이 요소는 PC 및 콘솔에 적용됩니다.

동작

• 특성은 다음과 같습니다.
  • DefaultDisplayName
  • PublisherDisplayName
  • StoreLogo
  • Square150x150Logo
  • Square44x44Logo
  • Description
  • ForegroundText
  • BackgroundColor
  • SplashScreenImage
• ForegroundText 특성 기본값은 'light'입니다. BackgroundColor 특성 기본값은 '투명'입니다. 다른 모든 특성에는 기본값이 없습니다.
• 허용되는 값:
  • DefaultDisplayName 특성은 최대 256자 길이의 문자열입니다.
  • PublisherDisplayName 특성은 최대 256자 길이의 문자열입니다.
  • StoreLogo 특성은 패키지 루트 아래에 있는 .PNG 파일에 대한 유효한 파일 경로입니다.
  • Square150x150Logo 특성은 패키지 루트 아래에 있는 .PNG 파일에 대한 유효한 파일 경로입니다.
  • Square44x44Logo 특성은 패키지 루트 아래에 있는 .PNG 파일에 대한 유효한 파일 경로입니다.
  • Square480x480Logo는 패키지 루트 아래에 있는 .PNG 파일에 대한 유효한 파일 경로입니다.
  • 설명은 문자열입니다.
  • ForegroundText 특성은 밝고 어둡습니다.
  • BackgroundText 특성은 일반 이름 또는 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 요소만 필요합니다. Square150x150Logo 특성의 경우 로고 크기는 150x150픽셀리어야 합니다.

OverrideLogo 특성은 특정 Executable에 대한 ShellVisuals의 Square150x150Logo 지정 .png 파일을 재정의합니다. OverrideLogo 특성 외에도 해당 Executable의 ShellVisuals에서 지정된 Square480x480Logo 및 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가 필요하지만, 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 개발에는 선택 사항입니다.

BackgroundColor

BackgroundColor는 ShellVisuals 요소의 특성입니다. HTML 색 코드를 사용하여 PC에서 타이틀의 배경을 정의합니다. 그러면 작업 표시줄과 시작 메뉴에서 로고 주변에 테두리가 표시됩니다.

참고 항목

MicrosoftGame.config 참조 - 목차