アイテムアイコンのサムネイルダウンロードAPI

4 分

ZEPETO.Moduleパッケージを使用すると、ZEPETOアイテムのサムネイルテクスチャをダウンロードできます。

アイテムのサムネイルを動的にダウンロードすることで、ビルドパッケージのサイズを削減するのに役立ちます。

ステップ 1 : インストール

まず、Window → パッケージマネージャー → ZEPETO.Worldパッケージ1.21.14以降のバージョンをインストールしてください。

その後、ZEPETO.Moduleパッケージをインストールしてください。

ステップ 2 : UI > 画像の追加

サムネイルを表示するために、シーンに画像コンポーネントを追加する必要があります。Hierarchy > UI > Raw Imageを追加してください。
幅と高さを同じサイズに設定します。

ステップ 3 : スクリプトを書く

階層を作成 > 空のオブジェクトを作成し、DownloadThumbnailに名前を変更する
プロジェクトを作成 > 作成 > ZEPETO > TypeScriptを作成し、DownloadThumbnailSampleに名前を変更する。
以下のようにサンプルスクリプトを書く。

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. [▶︎(再生)]ボタンを押して実行すると、設定した画像にアイテムのサムネイルが表示されるはずです。