项目图标缩略图下载API
4 分
ZEPETO.Module 包允许您下载 ZEPETO 项目的缩略图纹理。
通过动态下载项目缩略图,您可以帮助减少构建包的大小。
步骤 1 : 安装
请先安装 Window → 包管理器 → ZEPETO.World 包 1.21.14 或更高版本。
之后,请安装 ZEPETO.Module 包。

步骤 2 : UI > 添加图像
- 我们需要在场景中添加一个图像组件来显示缩略图。请添加层级 > UI > 原始图像。
- 将宽度和高度设置为相同的大小。
步骤 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. 完成脚本编写后,将 DownloadThumbnailSample 脚本添加到 DownloadThumbnail 对象。
5. 将图像分配给脚本检查器并输入 itemCode。
📘 请参考模特指南以了解如何检查 itemCode。[ZEPETO 模型]
6. 按下 [▶︎(播放)] 按钮以执行,您应该会在您设置的图像中看到物品缩略图。
