아이템 아이콘 썸네일 다운로드 API

4min
ZEPETO.Module 패키지를 사용하면 ZEPETO 아이템의 썸네일 텍스처를 다운로드할 수 있습니다.
아이템 썸네일을 동적으로 다운로드함으로써 빌드 패키지의 크기를 줄이는 데 도움을 줄 수 있습니다.
﻿
1단계 : 설치하기
먼저 Window → 패키지 관리자 → ZEPETO.World 패키지 1.21.14 이상 버전을 설치해 주세요.
그 후에 ZEPETO.Module 패키지를 설치해 주세요.
﻿
﻿
2단계 : UI > 이미지 추가하기
썸네일을 표시할 이미지 컴포넌트를 씬에 추가해야 합니다. 계층 구조 > UI > 원시 이미지로 추가해 주세요.
너비와 높이를 동일한 크기로 설정하세요.
﻿
3단계 : 스크립트 작성하기
계층 구조 만들기 > 빈 객체 만들고 이름을 DownloadThumbnail로 변경하기
프로젝트 만들기 > 만들기 > ZEPETO > TypeScript로 이름을 DownloadThumbnailSample로 변경하기.
아래와 같이 샘플 스크립트를 작성하세요.
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;
        }
    }
 
}
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를 입력하세요.
📘 itemCode를 확인하는 방법에 대한 마네킹 가이드를 참조하세요. [ZEPETO 마네킹﻿]
6. [▶︎(재생)] 버튼을 눌러 실행하면 설정한 이미지에서 아이템 썸네일을 볼 수 있습니다.
﻿
﻿
업데이트됨 11 Oct 2024
이 페이지가 도움이 되었습니까?
사용자가 보유한 아이템 정보 가져오기
ZEPETO 마네킹