---
title: 아이템 아이콘 썸네일 다운로드 API
slug: world-sdk-guide-kr/api
docTags: 
createdAt: 2024-09-02T08:34:13.134Z
---

ZEPETO.Module 패키지를 사용하면 ZEPETO 아이템의 썸네일 텍스처를 다운로드할 수 있습니다.

아이템 썸네일을 동적으로 다운로드함으로써 빌드 패키지의 크기를 줄이는 데 도움을 줄 수 있습니다.



## 1단계 : 설치하기

먼저 Window → 패키지 관리자 → ZEPETO.World 패키지 1.21.14 이상 버전을 설치해 주세요.

그 후에 ZEPETO.Module 패키지를 설치해 주세요.

![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-VD9kRv94SPp_Mm0mSF52G-20240904-102411.png)



## 2단계 : UI > 이미지 추가하기

1. 썸네일을 표시할 이미지 컴포넌트를 씬에 추가해야 합니다. 계층 구조 > UI > 원시 이미지로 추가해 주세요.
2. 너비와 높이를 동일한 크기로 설정하세요.



## 3단계 : 스크립트 작성하기

1. 계층 구조 만들기 > 빈 객체 만들고 이름을 DownloadThumbnail로 변경하기
2. 프로젝트 만들기 > 만들기 > ZEPETO > TypeScript로 이름을 DownloadThumbnailSample로 변경하기.
3. 아래와 같이 샘플 스크립트를 작성하세요.

```typescript
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { ShopService } from 'ZEPETO.Module.Shop';
import * as UnityEngine from 'UnityEngine';
import { RawImage } from 'UnityEngine.UI';
 
export default class DownloadThumbnailSample extends ZepetoScriptBehaviour {
 
    public image : RawImage;
    public itemCode : string;
     
    Start() {
        this.StartCoroutine(this.DownloadItemTexture());
    }
     
    *DownloadItemTexture()
    {
        // 지정된 아이템 코드에 대한 썸네일 텍스처 다운로드
        var request = ShopService.DownloadItemThumbnail(this.itemCode);
         
        yield new UnityEngine.WaitUntil(()=>request.keepWaiting == false);
         
        if(request.responseData.isSuccess)
        {
            this.image.texture = request.responseData.texture;
        }
    }
 
}
```



4\. 스크립트 작성을 마친 후, DownloadThumbnail 객체에 DownloadThumbnailSample 스크립트를 추가하세요.

5\. 스크립트 검사기에 이미지를 할당하고 itemCode를 입력하세요.

:::hint{type="info"}
**📘 **itemCode를 확인하는 방법에 대한 마네킹 가이드를 참조하세요. \[[ZEPETO 마네킹](docId\:v62GK-Uu8IiScyHFO_J85)]
:::

6\. \[▶︎(재생)] 버튼을 눌러 실행하면 설정한 이미지에서 아이템 썸네일을 볼 수 있습니다.

![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-WJ8J3zW3oIEQVmFKmMENQ-20240904-102411.png)