NFT 메타데이터에 애니메이션이나 비디오를 어떻게 추가하나요?

NFT 메타데이터에 대한 미디어 형식 요구 사항

1. ERC-721 또는 ERC-1155 메타데이터의 animation_url 필드는 ipfs://QmXyZ... 또는 ar://abc123 과 같은 원시 IPFS 또는 Arweave URI가 아닌 공개적으로 액세스 가능한 HTTP(S) 엔드포인트를 가리켜야 합니다.

2. 유효한 비디오 형식에는 .mp4 , .webm 및 .mov 가 포함됩니다. GIF는 허용되지만 크기 비효율성과 재생 제한으로 인해 대규모 자산의 경우 권장되지 않습니다.

3. 오디오 전용 NFT에는 응답 헤더에 명시적인 MIME 유형 선언이 포함된 HTTPS를 통해 제공되는 .mp3 , .wav 또는 .ogg 파일이 필요합니다.

4. OpenSea 및 Blur를 포함한 주요 마켓플레이스의 안정적인 온체인 인덱싱을 위해 모든 미디어 파일은 100MB 미만이어야 합니다.

5. 파일 크기 및 종횡비는 플랫폼별 디스플레이 제약 조건을 준수해야 합니다. OpenSea는 컬렉션 미리 보기에서 렌더링되는 비디오에 대해 최대 너비 3200픽셀을 적용합니다.

게이트웨이 변환 규칙

1. IPFS 링크는 신뢰할 수 있는 공용 게이트웨이를 사용하여 다시 작성해야 합니다. ipfs://QmXyZ... 는 https://ipfs.io/ipfs/QmXyZ... 또는 https://cloudflare-ipfs.com/ipfs/QmXyZ... 가 됩니다.

2. Arweave 식별자에는 https://arweave.net/ 접두사가 붙어야 합니다. 후행 슬래시나 쿼리 매개변수를 추가할 수 없습니다.

3. Pinata 또는 Infura와 같은 개인 게이트웨이에는 인증 토큰이 필요하며 토큰이 URL에 포함되어 있지 않으면 변경할 수 없는 메타데이터에 적합하지 않습니다. 이는 취소 위험으로 인해 권장되지 않는 방식입니다.

4. 게이트웨이 대체 논리는 클라이언트 측에서 구현되어서는 안 됩니다. 메타데이터는 JavaScript 개입 없이 명확하게 확인되어야 합니다.

5. 게이트웨이의 응답은 파일 확장자와 일치하는 유효한 Content-Type 헤더(예: MP4 파일의 경우 video/mp4 )를 반환하여 지갑과 탐색기에서 렌더링 실패를 방지해야 합니다.

HTML 렌더링 모범 사례

1. 사용 Chrome, Safari 및 MetaMask Mobile에서 자동 재생 호환성을 보장하기 위해 필수 컨트롤 , 루프 및 음소거 속성이 포함된 비디오 콘텐츠 전용 태그입니다.

2. 다음을 통해 미디어를 삽입하지 마세요. 또는 제3자 플레이어—결정론적 검증을 중단하고 OpenSea의 메타데이터 검증 정책을 위반합니다.

3. 항상 너비 와 높이 속성을 지정하십시오. 그리고 지연 로딩 중 레이아웃 변경을 방지하는 요소입니다.

4. 비디오용 인라인 Base64 인코딩에 의존하지 마십시오. 이는 크기 제한을 위반하고 JSON 팽창을 증가시키며 스트리밍 또는 부분 다운로드를 방지합니다.

5. 트래픽이 많은 기간 동안 반복되는 게이트웨이 요청을 줄이기 위해 적절한 캐싱 헤더( Cache-Control: public, max-age=31536000 )를 사용하여 HTTP/2 또는 HTTP/3을 통해 미디어를 제공합니다.

계약 수준 애니메이션 처리

1. 이더리움 메인넷에서 tokenURI() 함수는 animation_url 필드가 포함된 정적 JSON 문자열을 반환해야 합니다. 오프체인 오라클을 통한 동적 해결은 인덱서에서 지원되지 않습니다.

2. Optimism 또는 Base와 같은 L2 체인의 경우 선택한 RPC 노드가 도메인 간 미디어 해상도를 지원하는지 확인하십시오. 일부 노드는 비디오 스트리밍에 필요한 비표준 응답 헤더를 제거합니다.

3. Manifold Studio 또는 Thirdweb과 같은 타사 생성 도구를 통해 배포하는 경우 도구가 업로드 시 ipfs:// 를 게이트웨이 URL로 자동 변환하는지 또는 메타데이터 CID를 마무리하기 전에 수동 변환이 필요한지 확인합니다.

4. 스마트 계약 바이트코드 내에 애니메이션 로직을 저장하지 마세요. 애니메이션은 순전히 오프체인 프레젠테이션 문제이며 소유권 확인이나 전송 의미에 아무런 영향을 미치지 않습니다.

5. 분산형 저장소 공급자를 사용하는 경우 애니메이션 파일을 먼저 고정한 다음 메타데이터 JSON을 생성한 다음 JSON 자체를 고정합니다. 이 순서를 반대로 하면 메타데이터 CID가 마무리되기 전에 애니메이션 파일이 고정 해제되면 참조가 손상될 위험이 있습니다.

자주 묻는 질문

Q: animation_url에 YouTube 또는 Vimeo URL을 사용할 수 있나요? A: 아니요. 외부 삽입 도메인은 모든 주요 NFT 마켓플레이스에서 차단됩니다. HTTPS를 통한 직접 파일 URL만 허용됩니다.

Q: animation_url은 HLS(.m3u8) 스트림을 지원합니까? A: 아니요. HLS는 현재 인덱서 구현에서 지원되지 않습니다. 프로그레시브 다운로드 비디오 형식만 안정적으로 색인이 생성됩니다.

Q: 생성 후 내 비디오 파일이 404를 반환하면 어떻게 되나요? A: NFT는 모든 플랫폼에서 공백으로 렌더링되거나 손상된 미디어 아이콘을 표시합니다. image_url에 대한 자동 대체는 수행되지 않습니다.

Q: 공개 ACL을 사용하여 AWS S3에서 애니메이션 파일을 호스팅하는 것이 안전합니까? A: 예. 버킷 정책이 HTTPS 전용 액세스를 적용하고 디렉터리 목록을 비활성화하는 경우입니다. 그러나 장기적인 불변성을 위해서는 S3가 아닌 IPFS/Arweave 앵커링이 필요합니다.