如何将动画或视频添加到我的 NFT 元数据中？

NFT 元数据的媒体格式要求

1. ERC-721或ERC-1155元数据中的animation_url字段必须指向可公开访问的HTTP(S)端点，而不是原始IPFS或Arweave URI，例如ipfs://QmXyZ...或ar://abc123 。

2. 有效的视频格式包括.mp4 、 .webm和.mov ； GIF 可以接受，但由于尺寸低效和播放限制，不鼓励使用大型资源。

3. 纯音频 NFT 需要通过 HTTPS 提供.mp3 、 .wav或.ogg文件，并在响应标头中明确 MIME 类型声明。

4. 所有媒体文件必须小于 100 MB，以便 OpenSea 和 Blur 等主要市场进行可靠的链上索引。

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. 避免通过以下方式嵌入媒体或第三方参与者——这些破坏了确定性验证并违反了 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 最终确定之前取消固定动画文件，则颠倒此顺序可能会导致引用损坏。

常见问题解答

问：我可以在animation_url 中使用YouTube 或Vimeo URL 吗？答：不会。所有主要 NFT 市场都会屏蔽外部嵌入域。仅接受通过 HTTPS 的直接文件 URL。

问：animation_url 是否支持 HLS (.m3u8) 流？答：不可以。当前索引器实现不支持 HLS。只有渐进式下载视频格式才能可靠地建立索引。

问：如果我的视频文件在创建后返回 404，会发生什么情况？答：NFT 将在所有平台上呈现为空白或显示损坏的媒体图标。不会自动回退到 image_url。

问：使用公共 ACL 在 AWS S3 上托管动画文件是否安全？答：是的 — 如果存储桶策略强制执行仅 HTTPS 访问并禁用目录列表。然而，长期不变性需要 IPFS/Arweave 锚定，而不是 S3。