Skip to main content
이 항목에서는 게임의 초기 및 이후 설치 시간을 개선하기 위해 feature와 recipe를 사용하는 방법을 설명합니다. Feature와 recipe는 함께 작동하여 기본 게임 내에서 사용자가 초기 설치 시와 나중에 셸에서 추가하고 제거할 수 있는 콘텐츠 그룹을 정의합니다. 런타임 API를 사용하여 feature의 설치 상태를 동적으로 쿼리하고 feature의 추가 및 제거를 트리거할 수도 있습니다. Feature는 개발자용 ID 문자열 특성을 지정하는 XML 요소입니다. 또한 셸에 표시되는 사용자용 지역화 가능한 표시 이름과 이미지를 지정합니다. Feature는 하나 이상의 태그를 지정합니다. 설치 및 업데이트 시점에 시스템은 설치된 feature가 참조하는 모든 태그를 찾고, 해당 태그가 포함된 모든 청크를 설치합니다. Recipe는 설치해야 하는 feature 목록을 지정하는 XML 요소입니다. 항상 기본 recipe가 있으며, 해당 recipe에 포함된 feature는 항상 설치됩니다. 추가 recipe를 정의할 수 있습니다. 이러한 recipe는 사용자 또는 현재 콘솔이 지정된 StoreIds에 대한 자격 증명을 가지고 있는 경우 다음 코드와 같이 설치 시점에 활성화됩니다.
Feature에는 세미콜론으로 구분된 여러 태그 특성이 포함될 수 있습니다. 청크의 태그 중 하나가 활성 feature에 포함되면 해당 청크가 설치에 포함됩니다. # 기호는 #의 양쪽 태그가 모두 활성인 경우 태그를 설치합니다.

Feature 표시 이름 지역화

DisplayNames의 지역화는 MicrosoftGame.config 파일 내의 name 특성 지역화와 동일한 방식으로 수행됩니다. 이는 ms-resource:name 형식과 게임의 strings 디렉터리에 있는 .resw 파일 및 적절한 이름의 하위 디렉터리에 있는 로케일별 문자열을 사용하여 수행됩니다. 자세한 내용은 MicrosoftGame.Config 지역화를 참조하세요.
MicrosoftGame.config 및 Intelligent Delivery와 함께 사용되는 지역화된 문자열 값과 이미지는 게시된 패키지 내에서 개발자 샌드박스나 소매 어느 곳에서도 암호화되지 않습니다. 게임에서 제목, 아이콘 및 민감한 콘텐츠에 대해 자리 표시자 값을 사용하세요. 민감한 콘텐츠에는 개발 중, 타이틀 공개 전 Intelligent Delivery가 참조하는 모든 콘텐츠 또는 타이틀 내에서 발견되는 특정 콘텐츠가 포함됩니다.

숨겨진 feature

Feature는 숨김으로 표시할 수 있으며, 이렇게 하면 사용자가 설치 시점에 선택 가능한 옵션으로 표시되거나 타이틀 설치 후 셸을 관리할 때 표시되지 않게 됩니다. 숨겨진 feature를 사용할 때는 주의하세요. 이를 추가하거나 제거하는 유일한 방법은 타이틀 내의 API를 사용하는 것이기 때문입니다. 타이틀에서 발견된 버그로 인해 해당 버그를 수정하는 콘텐츠 업데이트를 제공할 때까지 콘텐츠에 액세스할 수 없게 될 수 있습니다. 다음 코드는 숨김으로 표시된 feature의 예입니다.

Feature 설치 상태 확인

Feature를 사용하여 해당 feature가 지정한 태그를 가진 모든 청크가 있는지 확인할 수 있습니다. 이러한 런타임 쿼리를 수행할 때 장치 및 언어 지정자가 고려됩니다. 해당 feature 내에 장치나 언어별 콘텐츠가 있는 경우, 하나의 언어와 해당 feature 내에서 현재 장치에 적용 가능한 모든 청크가 설치되어 있는 한 여전히 true가 반환됩니다. 예를 들어, Campaign Feature의 자산이 청크 8000, 8001, 8002에 포함되어 있는 경우, 해당 청크 세트가 완전히 설치되어 재생 가능한지 판단하기 위해 XPackageFindChunkAvailability 메서드를 호출하는 대신, 세 청크 모두에 사용자 지정 태그 “campaign1”을 지정하고 Campaign Feature에서 “campaign1”을 참조할 수 있습니다. 그런 다음 Campaign Feature ID와 함께 XPackageChunkSelector를 사용하여 XPackageFindChunkAvailability 메서드를 호출하면 해당 데이터 세트의 설치 상태를 쉽게 얻을 수 있습니다.

참조 API 문서

함께 보기

Intelligent Delivery 소개 XPackageChunkSelector XPackageInstallChunks MicrosoftGame.Config 지역화
마지막 수정일 2026년 8월 13일