컬렉션

컬렉션은 다음의 그룹입니다 착용 아이템 및 감정 표현 같은 오프체인 네임스페이스 또는 온체인 계약에 정의된.

그 자체로는 엔티티입니다 아니지만, 개별 아이템은 일반적으로 다음을 사용하여 콘텐츠 서버에서 가져올 수 있습니다 pointers.

URN과 포인터

컬렉션은 URN을 사용해 식별되며, 이는 해당 아이템 URN의 접두사입니다. URN에는 4가지 일반 유형이 있습니다:

• v1 Foundation 승인 콘텐츠가 있는 컬렉션(더 이상 사용되지 않음).

• v2 커뮤니티 승인 콘텐츠가 있는 컬렉션.

• 제3자 Decentraland 외부의 NFT와 연결된 아이템이 있는 컬렉션.

• 오프체인 컬렉션으로, 새 아바타를 위한 기본 아이템을 대부분 포함합니다.

그럼에도 불구하고 v1 컬렉션은 더 이상 사용되지 않으며 생성되거나 업데이트되지 않지만, 여전히 유효하며 그 아이템은 사용할 수 있습니다.

버전 1 및 2 컬렉션

이전의 v1 현재의 v2 컬렉션 네임스페이스는 모두 같은 형식의 URN을 가집니다:

urn:decentraland:<blockchain>:<collections-version>:<contract-address>

예를 들면:

# 사용 중단된 v1 공간의 컬렉션:
urn:decentraland:mainnet:collections-v1:DCL Test Masks

# v2 커뮤니티 승인 공간의 컬렉션:
urn:decentraland:matic:collections-v2:0x25a1d66891d44cdf7b8c45802489c1dea7aadf8b

만약 :<id> 세그먼트가 끝에 추가되면, URN은 포인터 컬렉션 내부의 아이템을 가리키는 포인터가 됩니다. 다음을 참조하세요 착용 아이템 포인터 및 감정 표현 포인터 에 대한 정보를 확인하세요.

제3자 컬렉션

제3자 컬렉션은 다음으로도 알려져 있으며, 연결된 착용 아이템, 는 일반 착용 아이템과는 다릅니다. Decentraland 외부의 기존 NFT에 연결되어 있기 때문입니다. 플레이어는 이를 통해 자신의 보유 NFT를 인월드 아바타에 표시할 수 있습니다.

URN은 다음과 같습니다:

urn:decentraland:<blockchain>:collections-thirdparty:<third-party-id>:<collection-id>

이에 대한 충분한 정보는 연결된 착용 아이템 제작자 문서에서 확인할 수 있습니다.

컬렉션 찾기

콘텐츠 서버는 다음을 사용하여 알려진 모든 컬렉션 목록을 제공할 수 있습니다 /lambdas/collections 엔드포인트.

응답은 다음을 가진 객체가 됩니다 collections 속성으로, URN과 이름의 배열을 포함합니다. 예를 들면:

{
  "collections": [
    {
      "id": "urn:decentraland:amoy:collections-v2:0xff5d4ebc6bc1ff7262cab42d3c693d953f4614d2",
      "name": "겨울 옷 컬렉션"
    },
    // ... 더 많음
  ]
}