如何將動畫或影片加入我的 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 最終確定之前取消固定動畫文件，則顛倒此順序可能會導致引用損壞。

常見問題解答

Q：我可以在animation_url 中使用YouTube 或Vimeo URL 嗎？答：不會。所有主要 NFT 市場都會屏蔽外部嵌入域。僅接受透過 HTTPS 的直接檔案 URL。

Q：animation_url 是否支援 HLS (.m3u8) 流？答：不可以。目前索引器實作不支援 HLS。只有漸進式下載影片格式才能可靠地建立索引。

Q：如果我的視訊檔案在創建後返回 404，會發生什麼情況？答：NFT 將在所有平台上呈現為空白或顯示損壞的媒體圖示。不會自動回退到 image_url。

Q：使用公用 ACL 在 AWS S3 上託管動畫檔案是否安全？答：是的 — 如果儲存桶策略強制執行僅 HTTPS 存取並停用目錄清單。然而，長期不變性需要 IPFS/Arweave 錨定，而不是 S3。