メタデータテンプレート
メタデータテンプレートとプレースホルダの使い方
最終更新
NMKR Studioでは、プロジェクトごとにメタデータテンプレートを指定することができます。
このメタデータテンプレートにはプレースホルダが含まれており、各トークンが提供するメタデータの実際の値に置き換えられます。つまり、このプロジェクトにアップロードされた各トークンは、メタデータテンプレートのメタデータ構造とプレースホルダを使用します。
NMKR Studioでは、プロジェクトのメタデータテンプレートの標準構造として、NFTメタデータ標準を定義する提案であるを使用しています。この構造を使用することが重要です。
よくある間違いは、Cardano固有の文字数制限を超えてしまうことです。例えばasset_nameは32文字までしか使用できず、特殊文字は使用できません。フィールドの標準的な文字数制は、空白を含めて63文字です。より長いテキストを追加したい場合は、ください。
プレースホルダーはその書き方で識別可能で、<>で囲まれていれば何でもプレースホルダーになります。
メタデータテンプレートにファイルを直接追加
policy_id
asset_name
トークンのレアリティの番号付けは、トークンの番号とは無関係にすることをお勧めします。
display_name
「トークン#124」のような名前にしたい場合は、ここにそのように記述します。
image
このフィールドの<ipfs_link>プレースホルダは、トークンのIPFSハッシュに置き換えられます。
あなたのトークンがメインファイルとして画像を持っているだけでなく、画像もサブファイルとして持っている場合、このフィールドにはプロジェクトのサムネイルを指定し、ここに画像やアニメーションGIFの小さいサイズのバージョンを追加することができます。
mediaType
このフィールドはサムネイル画像のファイル形式を定義します。サブファイルの下のファイルセクションで使われた場合、<mime_type>プレースホルダは自動的にファイルのファイル形式に置き換わります。
src
detail data
63文字以上の説明および拡張説明
配列を使用せずに説明文に追加できるのは63文字までです。
より長い説明を追加したい場合は、配列メソッドを使用してテキストを複数行に分割してください：
カスタムプレースホルダは、いわゆるトークン特性やトークン固有の値を追加するのに非常に便利です。
固有のプレースホルダを指定するには、メタデータテンプレートにカスタムフィールドを追加する必要があります。
メタデータコードの "description" 行の下に追加することをお勧めします。
カスタムフィールドを追加するには、カスタムフィールドに "name" を付け、次のように<placeholder> を指定します:
スタックに名前を付けるためのカスタム・プレースホルダ(pool.pm)
Pool.pmはコレクションのNFTをスタックします。このスタックに名前を付けたい場合は、次のようなカスタムフィールドを使用できます：
しかし、もしプロジェクトが同じスタック名を共有するのであれば、プレースホルダーを使わずに（<>を削除して）、ハードな値を入れたいでしょう：
メタデータ内のリンク
リンクは、カスタムフィールドを使ってメタデータに直接簡単に追加できます。
また、メタデータにhttps//リンクを使用する場合は、1行63文字という制限を守ってください。以下のようなリンクを配列で追加してください。
リンク全体を表示せずにフィールド名にリンクを追加するには、以下の形式を使用してください。
もちろん、この形式は配列と組み合わせることもできます。
標準メタデータは、プロジェクト設定のあります。
このメタデータテンプレートの基本構造を維持することが非常に重要です。メタデータの構造をチェックするのに非常に便利なツールが、です。
メタデータテンプレートのファイルセクションは、常にすべてのプレースホルダーをトークンにアップロードされたファイルの特定の値に置き換えます。複数のある場合、このファイルセクションはアップロードされたサブファイルごとに自動的に増殖します。したがって、ファイルセクションとそのプレースホルダには触れないことをお勧めします。
すべてのトークンが同一の共有するようなプロジェクトでは、各単一トークンにサブファイルとしてアップロードする代わりに、メタデータテンプレートに直接追加することが理にかなっています。
そのためには、テストプロジェクトに必要なファイルをアップロードして、ファイルのIPFSハッシュを受け取ります。次に、または詳細、以下のようにメタデータテンプレートに追加します。
メタデータ内のすべてのフィールドは、フィールドの名前 (例: 「name」) とプレースホルダー (例: 「<display_name>」) で構成されます。<placeholders> は、その名前が示すとおり、各固有の NFT によって指定される値の場所を保持するためのものです。標準のメタデータ テンプレートで既に指定されているプレースホルダーを使用することをお勧めしますが、こともできます。
このフィールドのプレースホルダ <policy_id> はプロジェクトのポリシーIDに置き換わります。メタデータのテンプレートとこのフィールドを保持することを強くお勧めします。
この<asset_name>プレースホルダはチェーン上のアセット名となり、manage NFTsタブに表示されるトークンのアセット名と一致する必要があります。このプレースホルダはメタデータテンプレートと保持することを強くお勧めします。
このような場合は、アセットのと関連付けず、ランダムに生成することをお勧めします。
トークンの表示名を上書きするには、使用してください。
その理由は簡単です。プロジェクトで使用する場合、買い手が支払い取引に署名するときに、（）取引に表示される可能性があるからです。そのため、買い手は「レアでない/一般的でない番号」が表示された場合、取引をキャンセルして最初からやり直すことができます。
<display_name>が指定されると、pool.pm、セカンダリーマーケット、その他のウェブサイト上で、トークンの代わりに表示されます。この名前はホルダーがトークンを識別する方法です。特殊文字を含めて63文字まで保持できます。
"src"フィールドの<ipfs_link>プレースホルダーはファイルセクションに属し、アップロードされたすべてのファイルのipfsハッシュに置き換えられます。
詳細データフィールドは、ファイルに追加の詳細を追加したい場合に指定できます。
これらは、指定するか、直接指定することができます。
メタデータテンプレートでカスタムフィールドを指定した後、値を与えます。
これらのカスタムフィールドがメタデータに与えられていない場合、pool.pmはトークンのまたは(与えられていない場合は) のシーケンスから名前を作成します。
