언리얼 엔진 5 문서가 에픽 디벨로퍼 커뮤니티로 이전되었습니다

게임에서 사용자 구매를 지원하는 두 가지 인터페이스 중 Store Interface (스토어 인터페이스)는 사용자에게 특정 항목을 제안하며, Purchase Interface (구매 인터페이스)는 사용자가 그 제안을 수락할 수 있도록 해줍니다. 스토어 인터페이스를 통해 게임에서는 온라인 서비스에서 제안을 검색하여 카테고리 별로 분류하고 필터를 적용해 개별적으로 관리할 수 있습니다. 구매 실행을 위해서는 구매 인터페이스 를 사용합니다.

제안 ( FOnlineStoreOffer 클래스)에는 사용자가 게임을 통해 구매할 수 있는 모든 것에 대한 필수 정보가 전부 들어있습니다. 여기에는 설명, 가격, 시작 및 종료일과 같은 정보가 포함됩니다. 카테고리 ( FOnlineStoreCategory 클래스)에는 훨씬 단순한 데이터가 저장되며, 하위 카테고리 이름과 목록만 들어갑니다. 온라인 서비스 자체에서 제안을 설정하고 관리하는 반면, 스토어 인터페이스는 해당 내용의 검색과 필터 적용을 처리합니다.

제안 및 카테고리

스토어 인터페이스는 온라인 서비스의 서버에서 제안 및 카테고리 데이터를 검색합니다. 이 작업에는 원격 시스템에 접속하는 작업이 포함되기 때문에 데이터 검색(retrieve) 및 캐시 저장 두 단계로 나뉘며, 이는 비동기 작업으로 로컬 캐시에 저장된 데이터에 액세스합니다. 스토어 인터페이스 자체는 요청이 완료될 때마다 캐시를 자동 업데이트하며, 가장 최근 쿼리의 결과만 유지합니다.

제안 및 카테고리 검색

제안 정보를 검색하는 첫 단계는 스토어에 포함된 카테고리 목록을 검색하는 것입니다. 이는 QueryCategories 함수에서 처리하며, 완료 시 제공된 FOnQueryOnlineStoreCategoriesComplete 유형 델리게이트를 호출합니다. 성공하면 스토어 인터페이스의 캐시에는 사용가능한 카테고리 ID 전부가 저장됩니다. 이 시점에서 개발자는 특정 카테고리만 포함하고 다른 카테고리는 제외된 ( FOnlineStoreFilter 유형) 필터를 통해 제안에 대한 쿼리를 시작할 수 있습니다. 필터와 함께 QueryOffersByFilter 로 카테고리 멤버십에 따라 제안 ID 를 검색할 수 있습니다. 스토어 인터페이스가 제안 ID 의 검색 및 캐시 저장을 마친 후, 개발자는 QueryOffersById 함수로 특정 제안 관련 정보에 대한 쿼리를 할 수 있습니다. QueryOffersByFilter 및 QueryOffersById 둘 다 FOnQueryOnlineStoreOffersComplete 유형 제공된 델리게이트를 사용하여 성공 또는 실패를 나타내며, 둘 중 어느 작업이든 성공하면 스토어 인터페이스의 제안 캐시를 업데이트합니다.

제안 데이터 검사

"쿼리" 함수는 카테고리 및 제안 관련 정보를 검색하여 스토어 인터페이스의 캐시에 저장합니다. 이 데이터에 액세스하려면 카테고리 캐시에 대해 GetCategories 를 호출하거나, 제안 캐시에 대해 GetOffers 를 호출합니다. 제안 ID 를 아는 경우 GetOffer 함수는 해당 (캐시에 저장된) 제안 관련 정보를 반환합니다.