可穿戴物

可穿戴物品是 实体 其中包含供玩家穿戴并自定义其头像的物品。

该 可穿戴物品 玩家的 资料 字段，包含一个指向他们当前所穿戴物品的指针列表。

每个可穿戴物品都属于一个 类别，表示它在头像身体上所占据的位置，并且可以隐藏或替换其他类别（例如，长裙可作为上衣穿戴，但会完全遮住腿部）。

共有 18 个可穿戴类别，在各种元数据字段中引用： 身体形状, hair, eyes, 眉毛, 面部毛发, 嘴部, 上身, 下身, 脚部, 帽子, 头盔, 面具, 头冠, 头顶部, 耳环, 眼镜, skin 和 手部饰物.

可穿戴实体包含适用于不同身体形状的 GLB 格式文件。

指针

可穿戴物品恰好关联一个 指针，它表示其所属的 collection 集合，以及它在该集合中的标识符。

当可穿戴物品是链上资产时，该指针是以下形式的 URN：

urn:decentraland:<blockchain>:collections-v2:<collection address>:<item index>

例如， 指针 链上可穿戴物品的数组如下：

{
  "pointers": [
    "urn:decentraland:matic:collections-v2:0x2d9560df9dd8ba8b2dc3746bc1d217698d258fb5:0"
  ],
  // ... 其他实体属性
}

当可穿戴物品是链下资产时，例如新头像的默认可穿戴物品，它将采用以下形式：

urn:decentraland:off-chain:<collection>:<item name>

在这种情况下，集合是一个名称而不是地址，物品标识符也是名称而不是索引。

该 指针 链下可穿戴物品的数组如下：

{
  "pointers": [
    "urn:decentraland:off-chain:base-avatars:BaseFemale"
  ],
  // ... 其他实体属性
}

元数据字段

可穿戴物品与以下对象共享大多数基本字段： 表情动作。该 数据 属性是存放该可穿戴物品特有信息的位置。

字段	值
id	该 指针 它解析（或曾经解析）到该可穿戴物品。
name	该可穿戴物品在一个 collection.
description	对该可穿戴物品的扩展描述。
图像	该 内部文件名 该可穿戴物品图片的。
缩略图	该 内部文件名 该 256x256 版本的 图像.
稀有度	以下之一 普通, 罕见, 稀有, 史诗, 传说, 异域, 神话 或 唯一.
i18n	一个用于以下项的翻译数组： name 字段。
collectionAddress	包含此可穿戴物品的集合的以太坊地址。
指标	关于动画的一些有用测量值（见下文）。
数据	该可穿戴物品的扩展元数据（见下文）。

典型的 JSON 形式：

{
  "id": "urn:decentraland:matic:collections-v2:0x11a6879861f36cbad632b4e7226816a16139fb33:0",
  漂亮连衣裙
  穿起来非常好看
  "image": "image.png",
  "thumbnail": "thumbnail.png",
  罕见
  "i18n": [
    { "code": "es", "text": "漂亮连衣裙" }
  ],
  "collectionAddress": "0x11a6879861f36cbad632b4e7226816a16139fb33",
  "metrics": {
    // 测量对象（见下文）。
  },
  "data": {
    // 扩展元数据（见下文）。
  }
}

指标

在 metadata.metrics 对象中，你会找到随该可穿戴物品打包的模型的一些简单测量值。示例：

{
  "entities": 1,
  "bodies": 12,
  "materials": 2,
  "meshes": 12,
  "textures": 2,
  "triangles": 3321
}

数据

该 metadata.data 对象是存放该可穿戴物品特有属性的位置。

字段	值
类别	上述可穿戴类别之一。
表示方式	与不同身体形状关联的文件数组（见下文）。
隐藏	该可穿戴物品会隐藏的类别数组。
替换	该可穿戴物品会完全替换的类别数组。
tags	描述该可穿戴物品的一组字符串标签。

表示方式

representations 数组中的每一项都会将一种身体形状与一组模型关联起来，并可添加关于每个类别显示哪些可穿戴物品的规则。

字段	值
bodyShapes	一个数组，包含 指针 到身体形状实体。
mainFile	用于开始渲染的 3D 模型文件。
contents	一个文件名数组（存在于顶层 内容 字段）供 mainFile.
overrideHides	取代上面的 隐藏 列表，适用于此表示方式。
overrideReplaces	取代上面的 替换 列表，适用于此表示方式。

这是一个典型的 表示方式 项目：

{
  "bodyShapes": [
      "urn:decentraland:off-chain:base-avatars:BaseFemale"
  ],
  "mainFile": "male/190.glb",
  "contents": [
      "male/190.glb"
  ],
  "overrideHides": [ "下身" ],
  "overrideReplaces": []
}