클라이언트 측 기능
GDK를 사용하면 게임이 소모품, durable(다운로드 가능한 콘텐츠), 구독, 번들, 트라이얼 등 여러 유형의 인게임 추가 기능과 제품 유형을 구현할 수 있습니다. XStore API 세트는 클라이언트 측에서 이러한 제품을 쿼리, 광고, 관리하는 데 필요한 기능을 제공합니다. 완전한 기능을 갖춘 인게임 스토어 예제는 GDK In-Game Store 샘플을 참고하세요. Fundamentals 섹션의 다음 문서에서는 이러한 API와 시나리오를 다룹니다.- 기본 스토어 작업 - 판매 가능한 항목과 사용자가 소유한 항목 쿼리
- 패키지 없는 durable 사용 방법 - 별도의 다운로드 패키지가 없는 durable 사용.
- 다운로드 가능한 콘텐츠(DLC) 관리 및 라이선스 - 다운로드 패키지를 갖는 전통적인 durable 사용.
- 소모품 기반 생태계 - 게임 내 소모품 기반 수익화 모델의 설정 및 구성.
- 게임에 트라이얼 구현 - 게임에 트라이얼 구현.
- 번들 및 시즌 패스 - 번들과 시즌 패스를 사용해 제품에 대한 고객 가치 및 참여 제공.
- 게임의 제품 공유 모델 - XBOX 콘솔과 Windows PC 모두에서 GDK 게임의 라이선싱 모델 및 사용자 간 공유 적용 방식.
서버 측 기능
클라이언트 측 API를 지원하고 서비스 간 호출을 허용하는 Microsoft Store 서비스는 다음 서비스로 분할됩니다.- Collections - 사용자가 어떤 제품을 소유하거나 사용할 자격이 있는지에 대한 정보를 제공하고 소모품 제품을 이행합니다. 또한 권한 있는 파트너를 위해 Game Pass 구독 상태를 감지하는 데 사용할 수도 있습니다.
- Clawback - 파트너 서비스가 이미 이행된 소모품에 대해 사용자에게 발급된 환불을 감지하고 관리할 수 있게 합니다.
- Purchase - 파트너 서비스가 사용자 계정에 무료 아이템을 추가할 수 있게 합니다.
- Recurrence - 사용자의 구독에 대한 자세한 정보를 제공하고 파트너 서비스가 사용자를 대신해 해당 구독을 관리할 수 있게 합니다.
Microsoft Store 서비스로 인증
Microsoft Store 서비스에 서비스를 인증하는 방법에 대한 자세한 내용은 서비스 간 인증을 위한 User Store ID 요청을 참고하세요.X-token 인증에 익숙하다면, Collections 서비스는 X-token을 지원합니다.
XDK를 사용한 개발자를 위한 주요 정보
XDK의 커머스 시스템에 익숙하다면, 다음 정의는 GDK에서 상응하는 서비스가 무엇으로 불리는지 안내하는 데 도움이 될 것입니다.- Inventory Service - XDK의 Inventory 서비스 기능(소유권 쿼리, 소모품 이행 등)은 이제 Collections 서비스로 처리됩니다. 여기에는 소유권과 소모품 수량을 검증하는 모든 서버 간 시나리오가 포함됩니다. Inventory에 사용된 X-token은 Collections를 호출하는 데 작동하지만, 파트너가 Microsoft Store 서비스의 확장된 기능을 사용하기 위해 Microsoft Entra ID 및 User Store ID 토큰 인증 흐름으로 이동하는 것을 권장합니다.
예: https://collections.mp.microsoft.com/v8.0/collections/b2bLicensePreview - Inventory Client APIs - 항목 소유권 쿼리와 관련된 모든 클라이언트 측 기능은 이제 XStore API를 통해 처리됩니다.
예: XStoreQueryEntitledProductsAsync는 현재 사용자가 그 순간 사용할 자격이 있는 항목을 반환합니다. - Catalog Browse APIs - 게임 내에서 구매할 수 있는 제품을 쿼리하는 것과 관련된 모든 클라이언트 측 기능은 이제 XStore API를 통해 처리됩니다. 타이틀 내에서 판매할 수 있는 사용 가능한 제품을 쿼리하는 서버 간 옵션은 없습니다.
예: XStoreQueryAssociatedProductsAsync는 인게임 스토어의 일부로 판매될 수 있는 제품을 반환합니다. - Trials and Licenses - 트라이얼 라이선스와 관련된 모든 클라이언트 측 기능은 이제 XStore API의 일부입니다. 예: XStoreQueryGameLicenseAsync는 트라이얼 라이선스 정보를 포함해 현재 게임의 라이선스 정보를 반환합니다. 자체 서비스에서 클라이언트 측 라이선스를 검증하는 기능은 라이선스 토큰을 사용하여 서비스에서 라이선스 검증을 참고하세요.