NFT メタデータにアニメーションまたはビデオを追加するにはどうすればよいですか?

NFTメタデータのメディア形式要件

1. ERC-721 または ERC-1155 メタデータのanime_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 などの主要なマーケットプレイスで信頼性の高いオンチェーン インデックスを作成するには、すべてのメディア ファイルが 100 MB 未満である必要があります。

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. ゲートウェイからの応答は、ウォレットとエクスプローラー間でのレンダリングの失敗を防ぐために、ファイル拡張子 (MP4 ファイルの場合はvideo/mp4など) に一致する有効なContent-Typeヘッダーを返す必要があります。

HTML レンダリングのベスト プラクティス

1. 使用方法Chrome、Safari、および MetaMask Mobile での自動再生の互換性を確保するために、必須のcontrol 、 loop 、およびmuted属性を備えたビデオ コンテンツ専用のタグ。

2. メディアの埋め込みを避けるまたはサードパーティのプレーヤー - これらは決定論的な検証を破り、OpenSea のメタデータ検証ポリシーに違反します。

3. 常に幅と高さの属性を指定します。そして遅延読み込み中のレイアウトのシフトを防ぐための要素。

4. ビデオのインライン Base64 エンコーディングに依存しないでください。これは、サイズ制限に違反し、JSON の肥大化を招き、ストリーミングや部分的なダウンロードを妨げます。

5. 高トラフィックのミント時に繰り返されるゲートウェイ要求を減らすために、適切なキャッシュ ヘッダー ( Cache-Control: public, max-age=31536000 ) を使用して HTTP/2 または HTTP/3 経由でメディアを提供します。

コントラクトレベルのアニメーション処理

1. Ethereum メインネットでは、 tokenURI()関数は、 animation_urlフィールドを含む静的 JSON 文字列を返す必要があります。オフチェーン オラクルによる動的解決は、インデクサーではサポートされていません。

2. Optimism や Base などの L2 チェーンの場合、選択した RPC ノードがクロスドメイン メディア解決をサポートしていることを確認します。一部のノードは、ビデオストリーミングに必要な非標準の応答ヘッダーを削除します。

3. Manifold Studio や Thirdweb などのサードパーティ製ミント ツールを介して展開する場合は、アップロード時にツールがipfs://をゲートウェイ URL に自動変換するかどうか、またはメタデータ CID を最終決定する前に手動変換が必要かどうかを確認します。

4. アニメーション ロジックをスマート コントラクトのバイトコード内に保存しないでください。アニメーションは純粋にオフチェーンのプレゼンテーションの問題であり、所有権の検証や転送セマンティクスにはまったく影響しません。

5. 分散ストレージプロバイダーを使用する場合は、最初にアニメーション ファイルを固定し、次にメタデータ JSON を生成し、次に JSON 自体を固定します。この順序を逆にすると、メタデータ CID が確定する前にアニメーション ファイルの固定が解除されると、参照が壊れる危険があります。

よくある質問

Q: anime_url で YouTube または Vimeo の URL を使用できますか? A: いいえ。外部埋め込みドメインは、すべての主要な NFT マーケットプレイスによってブロックされています。 HTTPS 経由の直接ファイル URL のみが受け入れられます。

Q: anime_url は HLS (.m3u8) ストリームをサポートしていますか? A: いいえ。HLS は現在のインデクサー実装ではサポートされていません。プログレッシブ ダウンロード ビデオ形式のみが確実にインデックス付けされます。

Q: 作成後にビデオ ファイルが 404 を返した場合はどうなりますか? A: NFT は、すべてのプラットフォームで空白としてレンダリングされるか、壊れたメディア アイコンが表示されます。 image_url への自動フォールバックは実行されません。

Q: パブリック ACL を使用して AWS S3 でアニメーション ファイルをホストするのは安全ですか? A: はい。バケット ポリシーが HTTPS のみのアクセスを強制し、ディレクトリのリストを無効にしている場合です。ただし、長期的な不変性には、S3 ではなく IPFS/Arweave アンカリングが必要です。