포인터

포인터는 활성 엔티티를. 콘텐츠 서버는 이러한 포인터를 해석하여 엔티티의 식별자를 가져올 수 있습니다.

둘 다 기억하세요 엔티티입니다 그리고 그들의 파일 는 Decentraland 콘텐츠 시스템에서 변경 불가능하며, 대체 버전이 업로드되면 식별자가 변경됩니다. 반면 포인터는 대체되어도 유지되는 안정적인 참조입니다. 이는 소유자가 대체 버전을 업로드할 때 포인터를 새 엔티티로 자동 리디렉션함으로써 이루어집니다.

여러 포인터가 동일한 엔티티를로 해석될 수 있으며, 이는 종종 장면.

아시다시피, 포인터의 가장 일반적인 용도는 활성 버전(즉, 최신 대체 버전)의 ID를 얻는 것입니다. 엔티티를를 다운로드하기 위해서입니다.

포인터 유형

콘텐츠 서버가 엔티티로 해석할 수 있는 포인터는 4가지 유형이 있으며, 각 유형은 고유한 구문을 가집니다:

• 씬 포인터 는 다음과 같은 파셀 좌표입니다 "0,0".

• 프로필 포인터 는 소유자의 이더리움 주소입니다.

• 웨어러블 포인터 및 이모트 포인터 는 다음 중 하나입니다 collection 아이템 또는 온체인 외부 URN입니다.

• 스토어 포인터 는 소유자의 이더리움 주소가 포함된 오프체인 URN입니다.

• 아웃핏 포인터 는 소유자의 이더리움 주소 뒤에 붙은 :outfits.

자세한 내용은 각 섹션에서 확인할 수 있습니다.

포인터 해석

콘텐츠 서버에는 포인터를 활성 엔티티의 매니페스트로 해석할 수 있는 엔드포인트가 있으며, 다음에 대한 GET 요청을 보냄으로써

https://<content-base-url>/entities/<entity-type>?pointer=<pointer>

역사적 이유로, 이 엔드포인트의 응답은 하나의 요소를 포함하는 배열입니다.

Foundation의 콘텐츠 서버를 사용한 유용한 예시 몇 가지:

# 웨어러블에 대한 온체인 컬렉션 포인터:
curl "https://peer.decentraland.org/content/entities/wearables/?pointer=urn:decentraland:matic:collections-v2:0x30517529cb5c16f686c6d0b48faae5d250d43005:0"

# 기본 자산에 대한 오프체인 컬렉션 포인터:
curl https://peer.decentraland.org/content/entities/wearables/?pointer=urn:decentraland:off-chain:base-avatars:BaseFemale

# 파셀 포인터:
curl https://peer.decentraland.org/content/entities/wearables/?pointer=0,0

# 프로필 포인터:
curl https://peer.decentraland.org/content/entities/profiles/?pointer=0xe2c2b80ca5ad868f4b30fa83cca2bf12cc95b4fe

참고로, 이미 엔티티의 ID를 알고 있다면, 매니페스트를 다운로드할 수 있습니다 파일을 직접.