1. 상점 카테고리 정보 호출

StovePC_FetchShopCategories 함수로 해당 게임에 대한 상점 카테고리 정보를 조회합니다. 카테고리 정보에는 부모 카테고리에 대한 아이디를 포함하고 있어 계층적 구조로 상점을 구성할 수 있습니다.

StovePCResult result = StovePC_FetchShopCategories();
if(result == StovePCResult::STOVE_PC_NO_ERROR)
{
    // 성공 처리
}

StovePC_FetchShopCategories 함수가 정상적으로 처리되면 OnFetchShopCategories 콜백이 호출됩니다.

콜백에 전달되는 StovePCShopCategory 구조체에는 상점 카테고리에 대한 메타정보가 포함되어 있습니다.

• StovePCShopCategory.categoryId : 카테고리 아이디
• StovePCShopCategory.parentCategoryId : 부모 카테고리 아이디
• StovePCShopCategory.displayNo : 카테고리 순서
• StovePCShopCategory.name : 카테고리명
• StovePCShopCategory.depth : 카테고리 깊이 (최상위 카테고리의 경우 1)

void OnFetchShopCategories(const int size, StovePCShopCategory* categories)
{
    printf("OnFetchShopCategories");
    printf("shopCategory size = %d", size);
    
    for (int i = 0; i < size; i++, categories++)
    {
        printf(" - categories[%d].categoryId : %s", i, categories->categoryId);
        printf(" - categories[%d].parentCategoryId : %s", i, categories->parentCategoryId);
        printf(" - categories[%d].displayNo: %d", i, categories->displayNo);
        wprintf(L" - categories[%d].name: %s", i, categories->name);
        printf(" - categories[%d].depth : %d", i, categories->depth);
    }
}

StovePC_FetchShopProducts 함수가 실행중에 오류가 발생하면 OnError 콜백이 호출됩니다.

StovePCError 구조체의 ExternalError 필드를 통해 외부 오류를 확인할 수 있습니다.

2. 상품 정보 호출

StovePC_FetchProducts 함수로 해당 게임에 대한 상품 정보를 조회합니다.

// 입력 파라미터
// char* categoryId : 스튜디오에서 등록한 카테고리 식별자(빈문자열 전달시 전체 카테고리 조회)
// bool isRefresh : true 인 경우 Web API 조회, false 인 경우 PC SDK 의 Cache 조회
StovePCResult result = StovePC_FetchProducts("CATEGORY_ID", IS_REFRESH);
if(result == StovePCResult::STOVE_PC_NO_ERROR)
{
    // 성공 처리
}

StovePC_FetchProducts 함수가 정상적으로 처리되면 OnFetchProducts 콜백이 호출됩니다.

콜백에 전달되는 StovePCProduct 구조체에는 상품에 대한 메타정보가 포함되어 있습니다.